Häufig gestellte Fragen zu Geocoding

In diesen FAQs werden spezifische Fragen zur Geocoding API behandelt. Weitere Informationen finden Sie in den häufig gestellten Fragen zur Google Maps Platform. Weitere Informationen findest du unter Best Practices für das Geocoding von Adressen.

Fehlerbehebung

Fehlerbehebung

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

Wenn der Geocoder mehrdeutig, unvollständig oder fehlerhaft formatiert ist, beispielsweise bei falsch geschriebenen oder nicht vorhandenen Adressen, besteht die Gefahr, ZERO_RESULTS zu erzeugen. Wenn die Adresse nicht gefunden werden kann, ist ZERO_RESULTS besser als ein Teilergebnis (z. B. nur der Vorort statt einer Adresse).

Wenn Ihre Anwendung Nutzereingaben verarbeitet, können Sie mit der Funktion Place Autocomplete in der Places API bessere Ergebnisse erzielen. Mit Place Autocomplete können Nutzer aus einer Reihe von Ergebnissen auswählen, was sie eingegeben haben. So können Nutzer zwischen ähnlichen Ergebnissen auswählen und ihre Abfrage anpassen, wenn sie eine Adresse falsch geschrieben haben.

Wenn Ihre Anwendung mehrdeutige oder unvollständige Abfragen oder Abfragen enthält, die Fehler enthalten können, empfehlen wir die Verwendung der Funktion Place Autocomplete in der Places API statt des in der Geocoding API verfügbaren Forward Geocoders. Weitere Informationen findest du in den Best Practices für die Geocoding-Adressen und im Adressen-Geocoding im Google Maps APIs-Blogpost.

Ich brauche schnelle Antworten und der Geocoder ist für meine Anwendung zu langsam. Was kann ich für schnellere Antworten nutzen?

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

Die Adressen-Geocoding in der Geocoding API ist für die Verwendung vollständiger, eindeutiger und gut formatierter Adressen optimiert, z. B. Lieferadressen, die in Online-Formulare eingegeben werden, und hat daher eine höhere Latenz als Place Autocomplete. Der Forward Geocoder bietet eine größere Abdeckung und bessere Ergebnisqualität, allerdings mit etwas höherer Latenz.

Wie kann ich die Latenz für die Directions API und die Distance Matrix API verringern?

Verwende anstelle von Adressen Orts-IDs, um Wegpunkte, Start- und Zielorte anzugeben. Orts-IDs finden Sie am besten über die Funktion Place Autocomplete in der Places API oder in der Places Library in der Maps JavaScript API. Siehe auch die Informationen zur Option placeIdOnly, mit denen die Kosten der Place Autocomplete-Funktion reduziert werden können.

Wenn die Directions API oder Distance Matrix API mit einem Adressstring statt mit einer Orts-ID oder einem Längen- und Breitengrad abgefragt wird, verwenden sie dasselbe Back-End wie die Geocoding API, um diese Adresse vor der Berechnung der Route in eine Orts-ID umzuwandeln. Place Autocomplete ist schneller als das Geocoding von Adressen. Bei Anwendungen, die die Directions API oder Distance Matrix API in sehr latenzempfindlichen Situationen wie etwa der Reaktion auf Nutzereingaben verwenden, empfehlen wir die Verwendung von Place Autocomplete, um die Orts-IDs abzurufen, die diesen Adressen entsprechen. Die Orts-IDs müssen an die Directions API oder Distance Matrix API übergeben werden. Dieser Ansatz reduziert die Latenz erheblich. In unserer Dokumentation finden Sie ein Beispiel für die Verwendung von Place Autocomplete mit Wegbeschreibungen.

Wie melde ich Programmfehler im Geocoder?

Wenn Sie Fehlerberichte oder Funktionsanfragen für den Geocoding-Dienst für die Weiterleitung haben, teilen Sie uns das bitte über unsere öffentliche Problemverfolgung mit.

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

Teilen Sie uns über die öffentliche Problemverfolgung mit und geben Sie dabei einige spezifische Abfragen an, damit wir untersuchen können, ob es Fehler oder systemische Probleme gibt, die zu Problemen mit der Ergebnisqualität führen, oder ob wir Änderungen am Best Practices-Leitfaden vornehmen, damit Entwickler bessere Ergebnisse erzielen können.

Wie erhalte ich mit dem Geocoder die besten Ergebnisse bei Verwendung der Komponentenfilterung?

Im Geocoder gelten für die Komponentenfilterung nur die Einschränkungen postal_code und country. Die folgenden Beispiele zeigen, wie die Komponentenfilterung am besten verwendet wird, abhängig von den benötigten Ergebnissen. Ersetzen Sie in den Beispiel-Anfrage-URLs „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel.

  • Wenn du Postleitzahlen auf ein bestimmtes Land beschränken möchtest, musst du 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 du Suchanfragen auf ein bestimmtes Land beschränken möchtest, musst du die Ländereinschränkung mit einem ISO 3166-2-Ländercode angeben. Bei Ländernamen und anderen Abkürzungen ist nicht garantiert, dass sie mit den Ländercodes übereinstimmen.

    Beispiele:

    • Die Geocoding-Funktion für components=country:FRA|locality:gallus gibt den Gallus-Unterort in Frankfurt am Main zurück. 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 in Frankfurt ist besser geeignet als alles in Frankreich. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Für mehrdeutige Suchanfragen gibt die Geocoding API nicht unbedingt mehrere Ergebnisse zurück. Solche Abfragen werden vom Place Autocomplete-Dienst besser beantwortet.

    Beispiele:

    • Die Geocoding-Funktion 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 einen Darstellungsbereich mithilfe von location und radius 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