Zur automatischen Vervollständigung migrieren (neu)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

Die Places API unterstützt die APIs Place Autocomplete (Legacy) und Query Autocomplete (Legacy). Wenn Sie mit diesen APIs vertraut sind, beachten Sie die folgenden Änderungen bei Autocomplete (New):

  • Autocomplete (New) verwendet HTTP-POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Bei den Legacy-APIs übergeben Sie URL-Parameter dagegen mit einer HTTP-GET-Anfrage.
  • Autocomplete (New) unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
  • In Autocomplete (New) wird nur JSON als Antwortformat unterstützt.

In der folgenden Tabelle sind Parameter in Place Autocomplete (Legacy) und Query Autocomplete (Legacy) 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

In der folgenden GET-Beispielanfrage wird Place Autocomplete (Legacy) verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten namens „Amoeba“ an, die vom Typ establishment sind, und übergeben alle Parameter als URL-Parameter:

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'

Bei Autocomplete (New) stellen Sie eine POST-Anfrage und übergeben alle Parameter im JSON-Anfragetext oder in den Headern als Teil der POST-Anfrage.

Feldmasken sind für Autocomplete (New)-Anfragen nicht erforderlich, können aber verwendet werden, um nach bestimmten Ergebnissen in der Antwort zu filtern. In der folgenden Anfrage wird beispielsweise eine Feldmaske verwendet, sodass die Antwort nur den suggestions.placePrediction.text des Vorschlags 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' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

Weitere Informationen zur Verwendung von Feldmasken finden Sie unter Place Details (New).