Esegui la migrazione al completamento automatico (novità)

Sviluppatori dello Spazio economico europeo (SEE)

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).