Places SDK for Android supporta lo stato Place Details (Dettagli sul luogo). Se hai dimestichezza con l'SDK Places per Android esistente, il Nuova versione di Place Details apporta le seguenti modifiche:
Utilizza un nuovo modello di determinazione del prezzo. Per informazioni sui prezzi di tutte le API, consulta SDK Places per Android (Nuova).
Devi inizializzare l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled(). Per ulteriori informazioni sulla selezione del servizio API Places, vedi Configura il progetto Google Cloud.Il mascheramento dei campi è obbligatorio. Devi specificare quali campi devono essere restituiti nella risposta. Non esiste un elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore.
Nelle sezioni seguenti vengono descritte ulteriori modifiche.
Accedere a nuovi tipi di luogo
A ogni luogo possono essere associati uno o più valori type. La L'SDK Places per Android 3.3.0 e versioni successive aggiunge molti nuovi tipi e i relativi valori. Per l'elenco completo, vedi Tipi di luogo espansi.
La Place.getPlaceTypes()
restituisce i valori di tipo come elenco di valori stringa. I valori restituiti
dipendono dalla tua versione dell'SDK Places per Android:
Places SDK for Android (New): restituisce le stringhe definite da Tabella A e tabella B mostrate nei tipi di luoghi (novità), che includono tutti i tipi di luogo aggiunti aggiunti nella versione 3.3.0.
SDK Places per Android: restituisce le enumerazioni definite da
Place.Types, che non include i nuovi tipi aggiunti nella versione 3.3.0 e successivi.
Accedere alle recensioni dei luoghi
Places SDK per Android (Novità) aggiunge
Review
che contiene la 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
pubblichi la recensione nell'app, devi mostrare anche eventuali attribuzioni
o attribuzione dell'autore. Per ulteriori informazioni, consulta la sezione Visualizzare un
per la revisione.
Per ulteriori informazioni, consulta la documentazione su attribuzioni.
Codice lingua per il nome del luogo di accesso
L'attuale
Place.getName()
restituisce una stringa di testo contenente il nome di un luogo. Per compilare il
Place con il nome del luogo, devi includere Place.Field.NAME in
l'elenco dei campi della richiesta di dettagli del luogo.
L'oggetto Place ora contiene il codice lingua per la stringa del nome. A
completare l'oggetto Place con il codice lingua, devi:
Includi
Place.Field.NAMEnell'elenco dei campi della richiesta. Questo valore configura la risposta in modo da includere sia il nome del luogo che il codice lingua nell'Placeoggetto.Chiama
PlacesClient.fetchPlace()PlacesClient.findCurrentPlace()non supporta il campo del codice lingua.Utilizza la
Place.getNameLanguageCode()per accedere al campo del codice lingua nell'oggettoPlace.
Imposta codice regione
L'SDK Places per Android (novità) aggiunge il parametro di richiesta del codice regione a Place Details. Il codice regione viene utilizzato per formattare la risposta, specificato come codice CLDR a due caratteri valore. Questo parametro può anche influire negativamente sui risultati di ricerca. Là non è un valore predefinito. Devi abilitare il nuovo SDK per impostare il codice regione.
Se il nome del paese nel campo dell'indirizzo nella risposta corrisponde alla regione il codice paese viene omesso dall'indirizzo.
La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk". (.co.uk) mentre la sua versione ISO 3166-1 il codice è "gb" (tecnicamente per l'entità "The United Kingdom of Gran Bretagna) e Irlanda del Nord"). Il parametro può influire sui risultati in base alle variabili legale.
Esempio di richiesta
Per un esempio completo, vedi Dettagli del luogo (novità).