L'API Places supporta le API di completamento automatico e completamento automatico delle query esistenti. Se hai dimestichezza con queste API, Autocomplete (novità) apporta le seguenti modifiche:
- Il 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, passi i parametri URL utilizzando una richiesta HTTP GET.
- Il completamento automatico (novità) supporta sia i token delle chiavi API sia i token OAuth come meccanismo di autenticazione.
- Nel completamento automatico (novità) è supportato solo JSON come formato di risposta.
La seguente tabella elenca i parametri nelle API di completamento automatico e di completamento automatico delle query esistenti che sono stati rinominati o modificati per il completamento automatico (nuova) o i parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Se ometti sia locationBias sia locationRestriction, l'API utilizza la differenziazione IP per impostazione predefinita. |
|
offset |
inputOffset |
|
radius |
locationBias o locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Esempio di richiesta
La richiesta GET di esempio seguente utilizza
l'elemento Place Autocomplete esistente. In questo esempio, richiedi una risposta JSON contenente informazioni sui luoghi di tipo "Amebe" 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 Autocomplete New, effettui una richiesta POST e passi tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta POST. 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 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" \
https://places.googleapis.com/v1/places:autocomplete