Zur automatischen Vervollständigung migrieren (neu)

Die Places API unterstützt die vorhandenen APIs Autocomplete und Query Autocomplete. Wenn Sie mit diesen APIs vertraut sind, nimmt Autocomplete (New) die folgenden Änderungen vor:

  • Autocomplete (New) verwendet HTTP POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu werden bei den vorhandenen APIs URL-Parameter mit einer HTTP-GET-Anfrage übergeben.
  • „Autocomplete (New)“ unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
  • In „Autocomplete (New)“ wird nur JSON als Antwortformat unterstützt.

In der folgenden Tabelle sind Parameter in den vorhandenen Autocomplete und Query Autocomplete APIs aufgeführt, die für „Autocomplete (New)“ umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.

Aktueller Parameter Neuer Parameter Hinweise
components includedRegionCodes
language languageCode
location locationBias
ipbias Wenn Sie sowohl locationBias als auch locationRestriction weglassen, verwendet die API standardmäßig die IP-Gewichtung.
offset inputOffset
radius locationBias oder locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Beispielanfrage

Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene „Place Autocomplete“-Funktion verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten namens „Amoeba“ an, die vom Typ establishment sind und alle Parameter als URL-Parameter übergeben:

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'

Mit „Autocomplete New“ stellen Sie eine POST-Anfrage und übergeben alle Parameter im JSON-Anfragetext oder in Headern als Teil der POST-Anfrage. In diesem Beispiel wird auch eine Feldmaske verwendet, sodass die Antwort nur den Anzeigenamen und die formatierte Adresse des Orts enthält:

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" \
https://places.googleapis.com/v1/places:autocomplete