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. Siehe auch Best Practices für das Geocoding von Adressen.

Fehlerbehebung

Fehlerbehebung

Ich erhalte mehr Abfragen, die mit ZERO_RESULTS vom Geocoder zurückgegeben werden. Was ist da los?

Im Geocoder führen mehrdeutige, unvollständige und schlecht formatierte Abfragen, z. B. falsch geschriebene oder nicht vorhandene Adressen, wahrscheinlich zu ZERO_RESULTS. Wenn die Adresse nicht gefunden werden kann, ist ZERO_RESULTS einem Teilergebnis vorzuziehen (z. B. nur die Rückgabe des Stadtteils anstelle einer Adresse).

Wenn Ihre Anwendung Nutzereingaben von Adressen verarbeitet, kann die Funktion Place Autocomplete in der Places API zu besseren Ergebnissen führen. Mit Place Autocomplete können Nutzer aus einer Reihe von Ergebnissen auswählen, die auf dem basieren, was sie eingegeben haben. So können sie zwischen Ergebnissen mit ähnlichen Namen wählen und ihre Anfrage anpassen, wenn sie eine Adresse falsch geschrieben haben.

Wenn Sie eine Anwendung haben, die mit mehrdeutigen oder unvollständigen Suchanfragen oder Suchanfragen mit Fehlern umgehen muss, empfehlen wir, die Funktion Place Autocomplete in der Places API anstelle des Forward Geocoders in der Geocoding API zu verwenden. Weitere Informationen finden Sie unter Best Practices für Geocoding-Adressen und im Blogpost Address Geocoding in the Google Maps APIs.

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

Für Anwendungen, die auf Nutzereingaben reagieren und daher sehr latenzempfindlich sind, empfehlen wir die Funktion Place Autocomplete in der Places API (auch in JavaScript, Android oder iOS verfügbar) anstelle der Adress-Geocodierung. Place Autocomplete ist für die interaktive Verwendung optimiert. Die Latenz ist bei dieser Funktion daher sehr gering.

Die Adressgeocodierung 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. Die Vorwärtsgeocodierung bietet eine bessere Abdeckung und Ergebnisqualität, aber mit einer etwas höheren Latenz.

Wie kann ich die Latenz bei der Directions API (Legacy) und der Distance Matrix API (Legacy) reduzieren?

Verwenden Sie anstelle von Adressen Orts-IDs, um Wegpunkte, Start und Ziel anzugeben. Orts-IDs lassen sich am besten über die Place Autocomplete-Funktion in der Places API oder die Places Library in der Maps JavaScript API abrufen. Weitere Informationen finden Sie auch unter der Option placeIdOnly, mit der die Kosten für Place Autocomplete gesenkt werden können.

Wenn die Directions API (Legacy) oder die Distance Matrix API (Legacy) mit einem Adressstring anstelle einer Orts-ID oder eines Breiten-/Längengrads abgefragt wird, wird dasselbe Backend wie bei der Geocoding API verwendet, um die Adresse vor der Berechnung der Wegbeschreibung in eine Orts-ID umzuwandeln. Place Autocomplete ist schneller als die Adressgeocodierung. Für Anwendungen, die die Directions API (Legacy) oder die Distance Matrix API (Legacy) in Situationen mit hoher Latenzempfindlichkeit verwenden, z. B. beim Antworten auf Nutzereingaben, empfehlen wir, Place Autocomplete zu verwenden, um die Orts-IDs für diese Adressen abzurufen und die Orts-IDs an die Directions API (Legacy) oder die Distance Matrix API (Legacy) zu übergeben. Dieser Ansatz reduziert die Latenz erheblich. Ein Beispiel für die Verwendung von Place Autocomplete mit Wegbeschreibungen finden Sie in unserer Dokumentation.

Wie melde ich Fehler im Geocoder?

Wenn Sie Fehlerberichte oder Feature Requests für den Forward-Geocoder-Dienst haben, können Sie uns diese über unseren öffentlichen Issue Tracker mitteilen.

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

Teilen Sie uns dies über unseren öffentlichen Issue Tracker mit und geben Sie einige konkrete Anfragen an, damit wir untersuchen können, ob Fehler oder systemische Probleme die Qualität der Ergebnisse beeinträchtigen oder ob wir Änderungen am Leitfaden zu Best Practices vornehmen können, um Entwicklern zu besseren Ergebnissen zu verhelfen.

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

Im Geocoder werden durch die Komponentenfilterung nur die Einschränkungen postal_code und country erzwungen. Die folgenden Beispiele veranschaulichen, wie Sie die Komponentenfilterung am besten verwenden, je nachdem, welche Ergebnisse Sie benötigen. Achten Sie darauf, in den Beispiel-Anfrage-URLs `YOUR_API_KEY` durch Ihren tatsächlichen API-Schlüssel zu ersetzen.

  • Wenn Sie Postleitzahlen auf ein bestimmtes Land beschränken möchten, müssen Sie die Länderbeschrä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 Abfragen auf ein bestimmtes Land beschränken möchten, müssen Sie die Länderbeschränkung mit einem Ländercode gemäß ISO 3166-2 angeben. Ländernamen und andere Abkürzungen führen möglicherweise nicht zu denselben Ergebnissen wie Ländercodes.

    Beispiele:

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

    Beispiele:

    • Die Geocodierung für components=country:US|locality:madrid gibt „Madrid, NM 87010, USA“ zurück, 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 auch einen Viewport mit location und radius angeben, um die Standortergebnisse zu gewichten, 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