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 richieste POST HTTP. Passa i parametri nel corpo della richiesta o nelle intestazioni nell'ambito di una richiesta POST HTTP. Al contrario, con le API legacy, i parametri URL vengono passati utilizzando una richiesta GET HTTP.
- Autocomplete (New) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- Solo JSON è supportato come formato di risposta in Autocomplete (New).
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 che non sono più supportati.
| Parametro corrente | Nuovo parametro | Note |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Se ometti sia locationBias sia locationRestriction, l'API utilizza la priorità IP per impostazione predefinita. |
|
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), effettui una richiesta POST e passi tutti i parametri nel corpo della richiesta JSON o nelle intestazioni nell'ambito della richiesta POST.
Le maschere di campo non sono obbligatorie per le richieste di 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 il campo 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 Place Details (New).