Esegui la migrazione al completamento automatico (novità)

L'API Places supporta le API Autocomplete e Completamento automatico delle query esistenti. Se conosci queste API, la funzionalità di completamento automatico (nuova) apporta le seguenti modifiche:

  • La funzionalità di completamento automatico (nuova) utilizza le 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 esistenti, i parametri URL vengono passati utilizzando una richiesta HTTP GET.
  • La funzionalità di completamento automatico (nuova) 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 delle API Autocomplete e Query Autocomplete esistenti che sono stati rinominati o modificati per Autocomplete (nuovo) o i parametri non più supportati.

Parametro corrente 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

Il seguente esempio di richiesta GET utilizza la funzionalità di completamento automatico dei luoghi esistente. In questo esempio, richiedi una risposta JSON contenente informazioni su 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 la funzionalità di completamento automatico (nuova), invii una richiesta POST e trasmetti 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 completamento automatico (nuove), ma possono essere utilizzate per filtrare i risultati specifici nella risposta. Ad esempio, la seguente richiesta utilizza una maschera di campo, pertanto la risposta include solo il 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 Dettagli dei luoghi (novità).