L'API Places supporta Completamento automatico e le API di completamento automatico delle query. Se hai familiarità con queste API, Autocompletamento (nuovo) 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,
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
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 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 dei campi non sono obbligatorie per le richieste di completamento automatico (nuova), ma possono essere
utilizzati per filtrare risultati specifici nella risposta. Ad esempio,
utilizza una maschera di campo in modo che la risposta includa solo
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 ulteriori informazioni sull'utilizzo delle maschere dei campi, consulta Dettagli luogo (Nuova).