L'API Places supporta le API Autocomplete (legacy) e Query Autocomplete (legacy). Se hai familiarità con queste API, Autocompletamento (nuovo) apporta le seguenti modifiche:
- La funzionalità di completamento automatico (nuova) utilizza richieste POST HTTP. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta POST HTTP. Al contrario, con le API precedenti, i parametri URL vengono trasmessi utilizzando una richiesta HTTP GET.
- Il completamento automatico (nuovo) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Compilazione automatica (nuova) è supportato solo il formato JSON come risposta.
La tabella seguente elenca i parametri delle API Autocomplete e Query Autocomplete precedenti 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
L'esempio seguente di richiesta GET utilizza il completamento automatico dei luoghi (legacy). In questo esempio, richiedi una risposta JSON contenente informazioni su luoghi chiamati "Amoeba" che
sono 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 Autocompletamento (nuovo), effettui una richiesta POST e passi 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 (nuovo), 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à).