Häufig gestellte Fragen zu Geocoding

In diesen häufig gestellten Fragen werden Fragen speziell zur Geocoding API beantwortet. Allgemeine Fragen zur Google Maps Platform finden Sie in den häufig gestellten Fragen zur Google Maps Platform. Weitere Informationen finden Sie unter Best Practices beim Geocoding von Adressen.

Fehlerbehebung

Fehlerbehebung

Mit dem Geocoder erhalte ich mehr Abfragen, die ZERO_RESULTS zurückgeben. Woran liegt das?

Durch den Geocoder neigen mehrdeutige, unvollständige und schlecht formatierte Abfragen (z. B. falsch geschriebene oder nicht vorhandene Adressen) zur Ausgabe von ZERO_RESULTS. Wenn die Adresse nicht gefunden werden kann, ist ZERO_RESULTS einem Teilergebnis vorzuziehen (z. B. wird nur der Vorort anstelle einer Adresse zurückgegeben).

Wenn in Ihrer Anwendung Adresseingaben durch Nutzer verarbeitet werden, liefert die Funktion Place Autocomplete in der Places API möglicherweise bessere Ergebnisse. Mit Place Autocomplete können Nutzer aus einer Reihe von Ergebnissen auswählen, die auf ihrer Eingabe basieren. Nutzer können dann zwischen Ergebnissen mit ähnlichen Namen wählen und ihre Suchanfrage anpassen, wenn sie eine Adresse falsch schreiben.

Bei Anwendungen, die mehrdeutige oder unvollständige Abfragen oder Abfragen mit Fehlern verarbeiten müssen, empfehlen wir die Verwendung der Place Autocomplete-Funktion in der Places API anstelle des Forward Geocoders, der in der Geocoding API verfügbar ist. Weitere Informationen finden Sie unter Best Practices beim Geocoding von Adressen und im Blogpost zur Geocodierung von Adressen im Google Maps APIs-Blogpost.

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

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

Die Adress-Geocodierung in der Geocoding API ist für vollständige, eindeutige und korrekt formatierte Adressen optimiert, z. B. Lieferadressen, die in Onlineformulare eingegeben wurden. Daher ist die Latenz höher als bei Place Autocomplete. Der Forward Geocoder bietet eine größere Abdeckung und bessere Ergebnisqualität, allerdings mit einer etwas höheren 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 die Places Library in der Maps JavaScript API. Weitere Informationen finden Sie in den Informationen zur Option placeIdOnly, mit der Sie die Kosten von Place Autocomplete senken können.

Wenn die Directions API oder die Distance Matrix API mit einem Adressstring statt mit einer Orts-ID oder einem „latlng“-Wert abgefragt wird, verwenden sie dasselbe Back-End wie die Geocoding API, um die Adresse vor der Berechnung der Route in eine Orts-ID umzuwandeln. Place Autocomplete ist schneller als das Adress-Geocoding. Für Anwendungen, die die Directions API oder die Distance Matrix API in extrem latenzempfindlichen Situationen verwenden, z. B. wenn sie auf Nutzereingaben reagieren, empfehlen wir die Verwendung von Place Autocomplete, um die Orts-IDs für diese Adressen abzurufen und sie an die Directions API oder die Distance Matrix API zu übergeben. Dieser Ansatz reduziert die Latenz erheblich. In der Dokumentation finden Sie ein Beispiel für die Verwendung von „Place Autocomplete“ mit Wegbeschreibungen.

Wie melde ich Fehler im Geocoder?

Falls Sie Fehlerberichte oder Funktionsanfragen für den Forward Geocoder-Dienst 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 dies bitte über unseren öffentlichen Issue Tracker mit und teilen Sie uns einige konkrete Fragen mit. So können wir prüfen, ob Programmfehler oder systemische Probleme zu Problemen mit der Ergebnisqualität führen oder ob wir Änderungen am Best Practices-Leitfaden vornehmen können, um Entwicklern dabei zu helfen, bessere Ergebnisse zu erzielen.

Wie erhalte ich die besten Ergebnisse mit dem Geocoder, der den Komponentenfilter verwendet?

Beim Geocoder werden durch den Komponentenfilter nur die Einschränkungen postal_code und country erzwungen. Die folgenden Beispiele veranschaulichen, wie Sie die Komponentenfilterung je nach den benötigten Ergebnissen am besten verwenden. Ersetzen Sie in den URLs der Beispielanfrage „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel.

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

    Beispiele:

    • Durch die Geocodierung für components=country:FRA|locality:gallus wird die Gemeinde Gallus in Frankfurt am Main, Deutschland, zurückgegeben. Das liegt daran, dass der aus drei Buchstaben bestehende Ländercode für Frankreich (FRA) nicht unterstützt wird. Daher sind Ergebnisse in jedem Land zulässig und das Ergebnis für Frankfurt eignet sich besser als alles in Frankreich. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Das Geocoding API gibt nicht unbedingt mehrere Ergebnisse für mehrdeutige Abfragen zurück. Solche Abfragen lassen sich mit Place Autocomplete besser beantworten.

    Beispiele:

    • Beim Geocoding für components=country:US|locality:madrid wird „Madrid, NM 87010, USA“ zurückgegeben, jedoch keine andere Stadt 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 zusätzlich mit location und radius einen Darstellungsbereich festlegen, 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