L'API Places supporta l'attuale Place Details (Dettagli luogo). Se conosci l'API Places esistente, la nuova versione di Place Details apporta le seguenti modifiche:
- Il mascheramento dei campi è obbligatorio. Devi specificare quali campi vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore. Per maggiori informazioni, vedi FieldMask.
- Il nuovo Place Details supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- Nel nuovo Place Details è supportato solo JSON come formato di risposta.
- Il formato della risposta JSON per l'API Place Details (nuova) è cambiato rispetto a quello delle API esistenti. Per maggiori dettagli, consulta Eseguire la migrazione della risposta dell'API Places.
Nella tabella seguente sono elencati i parametri dei Place Details esistenti che sono stati rinominati o modificati per i nuovi Place Details oppure i parametri non più supportati.
Parametro attuale | Nuovo parametro | Note |
---|---|---|
place_id |
places/PLACE_ID |
La stringa places/PLACE_ID è denominata anche
nome risorsa del luogo. Nella risposta a una richiesta Place Details (Nuova), Nearby Search (Nuova) e Text Search (Nuova) ricerca, questa stringa è contenuta nel campo name della risposta.
L'ID luogo autonomo è contenuto nel campo id della risposta. |
language |
languageCode |
|
region |
regionCode |
Esempio di richiesta
La richiesta GET di esempio seguente utilizza
l'elemento Place Details esistente. In questo esempio, richiedi una risposta JSON contenente informazioni su un ID luogo e passi tutti i parametri come parametri URL. Anche questo esempio utilizza fields
, quindi la risposta include solo il
nome visualizzato e l'indirizzo formattato del luogo:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Con Place Details (novità), puoi effettuare una richiesta GET e passare tutti i parametri nei parametri e nelle intestazioni URL come parte della richiesta. Questo esempio utilizza anche una maschera di campo in modo che la risposta includa solo il nome visualizzato e l'indirizzo formattato del luogo:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
La stringa places/PLACE_ID
è denominata anche nome risorsa del luogo. Nella risposta a una richiesta Place Details
(Nuova), Nearby Search (Nuova) e
Text Search (Nuova) richiesta, questa stringa è contenuta nel
campo name
della risposta. L'ID luogo autonomo è contenuto nel campo id
della risposta.