L'API Places supporta Luogo Details (Dettagli sul luogo). Se conosci l'API Places, il Nuova versione di Place Details apporta le seguenti modifiche:
- 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. Per ulteriori informazioni, vedi FieldMask.
- Il nuovo Place Details supporta Chiavi API e OAuth come meccanismo di autenticazione.
- Solo JSON è supportato come formato di risposta nella nuova funzionalità dettagli dei luoghi.
- Formato della risposta JSON per Place Details (novità) L'API è cambiata rispetto al formato delle API esistenti. Per ulteriori dettagli, vedi Esegui la migrazione della risposta dell'API Places.
La tabella seguente elenca i parametri esistenti di Dettagli dei luoghi che sono stati rinominati o modificati per i nuovi Dettagli dei luoghi o i parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
place_id |
places/PLACE_ID |
La stringa places/PLACE_ID è chiamata anche
luogo nome risorsa. Nella risposta da un luogo Dettagli luogo (novità),
Ricerca nelle vicinanze (novità) e Ricerca testuale (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
La richiesta GET di esempio seguente utilizza il modello
Place Details. In questo esempio, richiedi un file JSON
risposta contenente informazioni su un ID luogo e passare tutti i parametri come URL
parametri. Anche questo esempio utilizza fields, quindi la risposta include solo
nome visualizzato e 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 i dettagli dei luoghi (nuova versione), puoi effettuare una richiesta GET e trasmettere tutti i parametri nei parametri 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 è chiamata anche il luogo
nome risorsa. Nella risposta di una richiesta di dettagli sul luogo
(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 nei
Campo id della risposta.