L'API Places supporta le API Autocomplete e Completamento automatico delle query esistenti. Se conosci queste API, la funzionalità di completamento automatico (nuova) apporta le seguenti modifiche:
- La funzionalità di completamento automatico (nuova) utilizza le richieste HTTP POST. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta POST HTTP. Al contrario, con le API esistenti, i parametri URL vengono passati utilizzando una richiesta HTTP GET.
- La funzionalità di completamento automatico (nuova) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Completamento automatico (nuovo) è supportato solo il formato JSON come formato di risposta.
La tabella seguente elenca i parametri delle API Autocomplete e Query Autocomplete esistenti che sono stati rinominati o modificati per Autocomplete (nuovo) o i parametri non più supportati.
Parametro corrente | Nuovo parametro | Note |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Se ometti sia locationBias sia locationRestriction , l'API utilizza per impostazione predefinita la distorsione IP. |
|
offset |
inputOffset |
|
radius |
locationBias o locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Richiesta di esempio
Il seguente esempio di richiesta GET utilizza la funzionalità di completamento automatico dei luoghi esistente. In questo esempio, richiedi una risposta JSON contenente informazioni su luoghi chiamati "Amoeba" di tipo establishment
e passi tutti i parametri come parametri URL:
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'
Con la funzionalità di completamento automatico (nuova), invii una richiesta POST e trasmetti tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta POST.
Le maschere di campo non sono obbligatorie per le richieste di completamento automatico (nuove), ma possono essere utilizzate per filtrare i risultati specifici nella risposta. Ad esempio, la seguente
richiesta utilizza una maschera di campo, pertanto la risposta include solo il
suggestions.placePrediction.text
del suggerimento:
curl -X POST -d '{ "input": "Amoeba", "locationBias": { "circle": { "center": { "latitude": 37.76999, "longitude": -122.44696 }, "radius": 500.0 } } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: suggestions.placePrediction.text' \ https://places.googleapis.com/v1/places:autocomplete
Per scoprire di più sull'utilizzo delle maschere di campo, consulta Dettagli dei luoghi (novità).