L'API Places supporta le API Autocomplete e Query Autocomplete esistenti. 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 esistenti, 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 Completamento automatico (nuovo) è supportato solo il formato JSON come 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
L'esempio seguente di richiesta GET utilizza la funzionalità Autocompletamento dei luoghi esistente. In questo esempio, richiedi una risposta JSON contenente informazioni su luoghi chiamati "Amoeba" di tipoestablishment 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à).