Introduzione
L'API Places supporta Place Details (legacy). Se hai familiarità con l'API Places (precedente), Place Details (nuova) apporta le seguenti modifiche:
- 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. Per ulteriori informazioni, consulta FieldMask.
- Dettagli dei luoghi (nuovo) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Dettagli dei luoghi (nuovo) è supportato solo il formato JSON come formato di risposta.
- Il formato della risposta JSON per l'API Places (nuova) è cambiato rispetto a quello delle API precedenti. Per maggiori dettagli, consulta Eseguire la migrazione della risposta dell'API Places.
La seguente tabella elenca i parametri in Dettagli dei luoghi (legacy) che sono stati rinominati o modificati per Dettagli dei luoghi (nuovo) o i parametri che non sono più supportati.
| Parametro corrente | Nuovo parametro | Note |
|---|---|---|
place_id |
places/PLACE_ID |
La stringa places/PLACE_ID è chiamata anche
nome della risorsa del luogo. Nella risposta di una richiesta di dettagli dei luoghi (novità),
ricerca nelle vicinanze (novità) e ricerca di testo (novità),
questa stringa è contenuta nel campo name della risposta.
L'ID luogo autonomo è contenuto nel campo id della risposta. |
language |
languageCode |
|
region |
regionCode |
Richiesta di esempio
L'esempio di richiesta GET seguente utilizza la funzionalità Dettagli dei luoghi (legacy). In questo
esempio, richiedi una risposta JSON contenente informazioni su un ID luogo e
trasmetti tutti i parametri come parametri URL. Questo esempio utilizza anche fields, pertanto 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 la nuova API Places Details, puoi effettuare una richiesta GET e passare tutti i parametri nei parametri URL e nelle intestazioni come parte della richiesta. Questo esempio utilizza anche una maschera di campo, pertanto la risposta include 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 è chiamata anche nome della risorsa del luogo. Nella risposta di una richiesta di dettagli dei luoghi (novità), di ricerca nelle vicinanze (novità) e di ricerca di testo (novità), questa stringa è contenuta nel campo name della risposta. L'ID luogo autonomo è contenuto nel campo id della risposta.