Häufig gestellte Fragen zu Geocoding

In diesen FAQs werden Fragen speziell zur Geocoding API behandelt. Allgemeine Fragen zur Google Maps Platform werden unter Google Maps Platform – FAQs beantwortet. Weitere Informationen finden Sie unter Best Practices für das Geocodieren von Adressen.

Fehlerbehebung

Fehlerbehebung

Ich erhalte immer mehr Abfragen, bei denen der Geocoder ZERO_RESULTS zurückgibt. Was ist da los?

Im Geocoder führen mehrdeutige, unvollständige und schlecht formatierte Suchanfragen, z. B. falsch geschriebene oder nicht vorhandene Adressen, häufig zu ZERO_RESULTS. Wenn die Adresse nicht gefunden werden kann, ist ZERO_RESULTS vorzuziehen, anstatt ein teilweises Ergebnis zurückzugeben (z. B. nur den Stadtteil anstelle einer Adresse).

Wenn Ihre Anwendung Nutzereingaben von Adressen verarbeitet, kann die Funktion Place Autocomplete in der Places API bessere Ergebnisse liefern. Mit Place Autocomplete können Nutzer anhand ihrer Eingabe aus einer Reihe von Ergebnissen auswählen. So können sie zwischen ähnlich benannten Ergebnissen wählen und ihre Suchanfrage anpassen, wenn sie eine Adresse falsch geschrieben haben.

Wenn Sie eine Anwendung haben, die mit mehrdeutigen oder unvollständigen Suchanfragen oder Suchanfragen arbeitet, die Fehler enthalten können, empfehlen wir, die Funktion Place Autocomplete in der Places API anstelle des Vorwärts-Geocoders in der Geocoding API zu verwenden. Weitere Informationen finden Sie unter Best Practices für das Geocoding von Adressen und im Blogpost Adressgeocoding in den Google Maps APIs.

Ich benötige schnelle Antworten und der Geocoder ist für meine Anwendung zu langsam. Was kann ich verwenden, um schnellere Antworten zu erhalten?

Für Anwendungen, die auf Nutzereingaben reagieren und daher sehr latensempfindlich sind, empfehlen wir, die Funktion Place Autocomplete in der Places API zu verwenden (auch in JavaScript, Android oder iOS verfügbar) und nicht das Geocoding von Adressen. Place Autocomplete ist für die interaktive Verwendung optimiert. Die Latenz ist bei dieser Funktion daher sehr gering.

Die Geocodierung von Adressen in der Geocoding API ist für die Verwendung mit vollständigen, eindeutigen und gut formatierten Adressen optimiert, z. B. Lieferadressen, die in Onlineformulare eingegeben werden. Daher ist die Latenz höher als bei Place Autocomplete. Der Vorwärtsgeocoder hat eine größere Abdeckung und eine bessere Ergebnisqualität, aber eine etwas höhere Latenz.

Wie kann ich die Latenz bei der Directions API und der Distance Matrix API verringern?

Verwenden Sie anstelle von Adressen Orts-IDs, um Wegpunkte, Start- und Zielort anzugeben. Orts-IDs erhalten Sie am besten über die Funktion Place Autocomplete in der Places API oder über die Places Library in der Maps JavaScript API. Weitere Informationen finden Sie unter placeIdOnly, mit der sich die Kosten für Place Autocomplete senken lassen.

Wenn die Directions API oder Distance Matrix API mit einem Adressstring anstelle einer Orts-ID oder eines Breiten-/Längengrads abgefragt wird, wird dasselbe Backend wie bei der Geocoding API verwendet, um diese Adresse vor dem Berechnen der Wegbeschreibung in eine Orts-ID umzuwandeln. Place Autocomplete ist schneller als das Geocoding von Adressen. Für Anwendungen, in denen die Directions API oder die Distance Matrix API in Situationen mit hoher Latenz verwendet wird, z. B. bei der Reaktion auf Nutzereingaben, empfehlen wir, die Orts-IDs, die diesen Adressen entsprechen, mithilfe der automatischen Ortsvervollständigung abzurufen und an die Directions API oder die Distance Matrix API zu übergeben. Dadurch wird die Latenz deutlich reduziert. In unserer Dokumentation finden Sie ein Beispiel für die Verwendung von Place Autocomplete mit Wegbeschreibungen.

Wie melde ich Fehler im Geocoder?

Wenn Sie Fehlerberichte oder Funktionsanfragen für den Vorwärtsgeocoder haben, teilen Sie uns dies bitte über unseren öffentlichen Issue Tracker mit.

Der Geocoder liefert für meinen Anwendungsfall keine guten Ergebnisse. Welche Arten von Hilfe kann ich erhalten?

Teilen Sie uns Ihre Fragen über unseren öffentlichen Issue-Tracker mit. Wir prüfen dann, ob es Fehler oder systemische Probleme gibt, die die Qualität der Ergebnisse beeinträchtigen, oder ob wir Änderungen am Leitfaden mit Best Practices vornehmen können, damit Entwickler bessere Ergebnisse erzielen.

Wie erziele ich mit dem Geocoder die besten Ergebnisse mithilfe der Komponentenfilterung?

Im Geocoder werden durch die Komponentenfilterung nur Einschränkungen für postal_code und country erzwungen. In den folgenden Beispielen wird veranschaulicht, wie Sie die Komponentenfilterung je nach gewünschten Ergebnissen am besten verwenden. Ersetzen Sie in den Beispielanfrage-URLs „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel.

  • Wenn Sie Postleitzahlen auf ein bestimmtes Land beschränken möchten, müssen Sie die Ländereinschränkung mit einem ISO 3166-2-Ländercode angeben. Beispiel: components=country:CH|postal_code:8000 gibt „8000 Zürich, Schweiz“ zurück. 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Wenn Sie Suchanfragen auf ein bestimmtes Land beschränken möchten, müssen Sie die Ländereinschränkung mit einem ISO 3166-2-Ländercode angeben. Ländernamen und andere Abkürzungen liefern nicht garantiert dieselben Ergebnisse wie Ländercodes.

    Beispiele:

    • Bei der Geocodierung von components=country:FRA|locality:gallus wird der Ortsteil Gallus in Frankfurt am Main, Deutschland, zurückgegeben. Das liegt daran, dass der dreistellige Ländercode für Frankreich (FRA) nicht unterstützt wird. Daher sind Ergebnisse für alle Länder zulässig und das Ergebnis in Frankfurt passt besser als alle Ergebnisse in Frankreich. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Die Geocoding API gibt bei mehrdeutigen Suchanfragen nicht unbedingt mehrere Ergebnisse zurück. Solche Suchanfragen werden besser von Place Autocomplete beantwortet.

    Beispiele:

    • Bei der Geocodierung von components=country:US|locality:madrid wird „Madrid, NM 87010, USA“ zurückgegeben, aber keine der anderen Städte in den USA mit dem Namen „Madrid“. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Wenn Sie Place Autocomplete für input=madrid&components=country:us&types=(regions) verwenden und mit location und radius einen Darstellungsbereich angeben, um die Standortergebnisse zu beeinflussen, wird eine Antwort mit mehreren Städten in den USA mit dem Namen „Madrid“ generiert. 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY