Introduzione
Places API supporta Place Details (Legacy). Se hai familiarità con Places API (Legacy), Place Details (New) introduce le seguenti modifiche:
- La maschera di campo è 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. Per ulteriori informazioni, vedi FieldMask.
- Place Details (New) supporta sia chiavi API sia OAuth come meccanismo di autenticazione.
- In Place Details (New) è supportato solo il formato JSON come formato di risposta.
- Il formato di risposta JSON per Places API (New) è cambiato rispetto al formato delle API legacy. Per maggiori dettagli, vedi Migrare la risposta di Places API.
La seguente tabella elenca i parametri di Place Details (Legacy) che sono stati rinominati o modificati per Place Details (New) o i parametri non più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
place_id |
places/PLACE_ID |
La stringa places/PLACE_ID è detta anche
nome della risorsadel luogo. Nella risposta a una richiesta Place Details (New),
Nearby Search (New) e Text Search (New)
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 seguente richiesta GET di esempio utilizza Place Details (Legacy). In questo esempio, richiedi una risposta JSON contenente informazioni su un ID luogo e passi tutti i parametri come parametri URL. Questo esempio utilizza anche fields in modo che la risposta includa 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 (New), effettui una richiesta GET e passi tutti i parametri negli URL e nelle intestazioni 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 è detta anche
nome della risorsa del luogo. Nella risposta a una richiesta Place Details (New), Nearby Search (New) e Text Search (New), questa stringa è contenuta nel campo name della risposta. L'ID luogo autonomo è contenuto nel campo id della risposta.