Places SDK for Android supporta Place Details (Legacy). Se hai familiarità con Places SDK for Android (legacy), Dettagli luogo (nuovo) apporta le seguenti modifiche:
Utilizza un nuovo modello di prezzi. Per informazioni sui prezzi di tutte le API, consulta Places SDK for Android (New).
Devi inizializzare l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled(). Per saperne di più sulla selezione del servizio API Places, vedi Configurare il progetto Google Cloud.La mascheratura dei campi è obbligatoria. Devi specificare i campi che vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito di 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 di tipo. Places SDK for Android versione 3.3.0 e successive aggiunge molti nuovi valori di tipo. Per l'elenco completo, consulta Tipi di luoghi espansi.
Il metodo
Place.getPlaceTypes()
restituisce i valori di tipo come elenco di valori stringa. I valori restituiti
dipendono dalla versione di Places SDK for Android:
Places SDK for Android (New): restituisce le stringhe definite dalle tabelle A e B mostrate in Tipi di luoghi (nuovo), inclusi tutti i tipi di luoghi aggiunti nella versione 3.3.0.
Places SDK for Android: restituisce le enumerazioni definite da
Place.Types, che non include i nuovi tipi aggiunti nella versione 3.3.0 e successive.
Accedere alle recensioni dei luoghi
Places SDK for Android (New) 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 l'attribuzione
o l'attribuzione dell'autore. Per maggiori informazioni, vedi Visualizzare una
recensione.
Per saperne di più, consulta la documentazione relativa alle attribuzioni.
Accedere al codice lingua del nome del luogo
In Places SDK for Android (legacy),
il metodo Place.getName() 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 dei 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
Places SDK for Android (New) aggiunge il parametro di richiesta del codice regione a Place Details. 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 distorsione sui risultati di ricerca. Non esiste un valore predefinito. Per impostare il codice regione, devi attivare il nuovo SDK.
Se il nome del paese del campo dell'indirizzo nella risposta corrisponde al codice regione, il codice paese viene omesso dall'indirizzo.
La maggior parte dei codici CLDR sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD specifico per paese 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 applicabile.
Esempio di richiesta
Per un esempio completo, vedi Dettagli del luogo (novità).