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:
- Il completamento automatico (nuovo) utilizza richieste HTTP POST. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta POST HTTP. Al contrario, con le API legacy, passi i parametri URL utilizzando una richiesta HTTP GET.
- Completamento automatico (nuovo) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Completamento automatico (nuovo) è 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 (nuovo) oppure i parametri non più supportati.
Parametro corrente | Nuovo parametro | Note |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Se ometti sia locationBias che locationRestriction , l'API utilizza la ponderazione 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 trasmetti 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 Completamento automatico (nuovo), 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 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
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, vedi Dettagli luogo (nuovo).