L'SDK Places per Android supporta i Dettagli dei luoghi esistenti. Se conosci l'SDK Places esistente per Android, la nuova versione di dettagli dei luoghi apporta le seguenti modifiche:
Utilizza un nuovo modello di prezzi. Per informazioni sui prezzi di tutte le API, consulta SDK Places per Android (novità).
Devi inizializzare l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled(). Per ulteriori informazioni sulla selezione del servizio API Places, consulta Configurare il progetto Google Cloud.La maschera dei campi è obbligatoria. Devi specificare i campi che vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore.
Le sezioni seguenti descrivono ulteriori modifiche.
Accedere a nuovi tipi di luoghi
A ogni luogo possono essere associati uno o più valori type. L'SDK Places per Android versione 3.3.0 e successive aggiunge molti nuovi valori di tipo. Per l'elenco completo, consulta Tipi di luoghi.
Il metodo
Place.getPlaceTypes()
restituisce i valori di tipo come elenco di valori di stringa. I valori restituiti dependono dalla versione dell'SDK Places per Android:
SDK Places per Android (novità): restituisce le stringhe definite dalle tabelle A e B mostrate in Tipi di luoghi (novità), inclusi tutti i tipi di luoghi aggiunti nella versione 3.3.0.
SDK Places per Android: restituisce gli enum definiti da
Place.Types, che non include i nuovi tipi aggiunti nella versione 3.3.0 e successive.
Accedere alle recensioni dei luoghi
L'SDK Places per Android (nuovo) aggiunge la classe
Review
che contiene una recensione di un luogo. L'oggetto Place può contenere fino a cinque recensioni.
La classe Review può contenere anche un'attribuzione e un'attribuzione dell'autore. Se mostri la recensione nella tua app, devi mostrare anche eventuali attribuzioni o l'attribuzione dell'autore. Per ulteriori informazioni, vedi Mostrare una
recensione.
Per saperne di più, consulta la documentazione sulle attribuzione.
Accedi al codice lingua del nome del luogo
Il metodo
Place.getName()
esistente restituisce una stringa di testo contenente il nome di un luogo. Per compilare l'oggetto
Place con il nome del luogo, devi includere
Place.Field.DISPLAY_NAME nell'elenco dei campi della richiesta di dettagli del luogo.
L'oggetto Place ora contiene il codice lingua per la stringa del nome. Per compilare l'oggetto Place con il codice lingua, devi:
Includi
Place.Field.DISPLAY_NAMEnell'elenco dei campi della richiesta. Questo valore configura la risposta in modo da includere sia il nome del luogo sia il codice lingua nell'oggettoPlace.Chiama
PlacesClient.fetchPlace().PlacesClient.findCurrentPlace()non supporta il campo del codice lingua.Utilizza il metodo
Place.getNameLanguageCode()per accedere al campo del codice lingua nell'oggettoPlace.
Imposta il codice regione
L'SDK Places per Android (nuovo) aggiunge il parametro di richiesta del codice regione a dettagli sul luogo. Il codice regione viene utilizzato per formattare la risposta, specificato come valore di un codice CLDR di due caratteri. Questo parametro può anche avere un effetto di bias sui risultati di ricerca. Non è previsto alcun valore predefinito. Devi attivare il nuovo SDK per impostare il codice regione.
Se il nome del paese del campo indirizzo nella risposta corrisponde al codice regione, il codice paese viene omesso dall'indirizzo.
La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune eccezioni notevoli. Ad esempio, il TLD di primo livello del Regno Unito è "uk " (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord"). Il parametro può influire sui risultati in base alla legge vigente.
Richiesta di esempio
Per un esempio completo, vedi Dettagli sul luogo (novità).