Introduzione
L'API Places supporta le API Place Autocomplete (Legacy) e Query Autocomplete (Legacy). Se hai familiarità con queste API, Autocomplete (New) apporta le seguenti modifiche:
- Autocomplete (New) utilizza le richieste HTTP POST. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta HTTP POST. Al contrario, con le API legacy, passi i parametri URL utilizzando una richiesta GET.
- Autocomplete (New) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Autocomplete (New) è supportato solo il formato JSON come formato di risposta.
La tabella seguente elenca i parametri di Place Autocomplete (Legacy) e Query Autocomplete (Legacy) che sono stati rinominati o modificati per Autocomplete (New) o i 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 polarizzazione IP. |
|
offset |
inputOffset |
|
radius |
locationBias o locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Esempio di richiesta
La seguente richiesta GET di esempio utilizza Place Autocomplete (Legacy). In questo esempio, richiedi una risposta JSON contenente informazioni sui 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 Autocomplete (New), 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 Autocomplete (New), ma possono essere utilizzate per filtrare risultati specifici nella risposta. Ad esempio, la seguente richiesta 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 saperne di più sull'utilizzo delle maschere di campo, consulta Dettagli luogo (nuovo).