L'API Places supporta Completamento automatico e le API di completamento automatico delle query. Se hai dimestichezza con queste API, Autocomplete (novità) apporta le seguenti modifiche:
- Il completamento automatico (nuova) utilizza richieste POST HTTP. Trasmetti i parametri in il corpo della richiesta o nelle intestazioni come parte di una richiesta POST HTTP. Al contrario, con le API esistenti, passi i parametri URL utilizzando Richiesta HTTP GET.
- Il completamento automatico (novità) supporta entrambe le chiavi API e OAuth come meccanismo di autenticazione.
- Nel completamento automatico (novità) è supportato solo JSON come formato di risposta.
Nella tabella seguente sono elencati i parametri nell'elenco API Autocomplete e Query Autocomplete che sono state rinominate o modificate per Autocomplete (novità) o parametri non più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Se ometti sia locationBias sia locationRestriction, il valore
L'API utilizza la differenziazione degli 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 il modello
Place Autocomplete. In questo esempio, richiedi un file JSON
risposta contenente informazioni su luoghi chiamati "Amebe" di tipo
establishment e passa 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 (novità), effettui una richiesta POST passare tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta richiesta. Questo esempio utilizza anche una maschera di campo in modo che la risposta includa solo nome visualizzato e 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