L'API Places supporta le API Place 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 Completamento automatico (nuovo) è supportato solo il formato JSON come risposta.
La tabella seguente elenca i parametri in Ricerca automatica (legacy) e Completamento automatico dei luoghi (legacy) che sono stati rinominati o modificati per il Completamento automatico (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" 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 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 (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à).