Geocoding ist der Vorgang der Konvertierung von Adressen (z. B. Adressen) in geografische Koordinaten (Breiten- und Längengrad), mit denen Sie Markierungen auf einer Karte platzieren oder die Karte positionieren können. In diesem Dokument werden die Überlegungen zum Geocoding von Adressen erläutert. Sie beschreibt, wann die Verwendung der Geocoding API optimal ist und wann es vorteilhaft ist, den Place Autocomplete-Dienst der Places API zu verwenden.
Verwenden Sie im Allgemeinen die Geocoding API für das Geocoding von vollständigen Adressen (z. B. „48 Pirrama Rd, Pyrmont, NSW, Australien“). Verwenden Sie den „Place Autocomplete“-Dienst der Places API beim Geocoding mehrdeutiger (unvollständiger) Adressen oder für latenzempfindliche Anwendungen, z. B. beim Beantworten von Nutzereingaben.
Anwendungsfälle und API-Empfehlungen
| Anwendungsfälle und API-Empfehlungen | |
|---|---|
| In Echtzeit auf Nutzereingaben reagieren (einschließlich mehrdeutiger, unvollständiger, schlecht formatierter oder falsch geschriebener Adressen, die von einem Nutzer eingegeben wurden) | Verwenden Sie den Place Autocomplete-Dienst der Places API, um eine Orts-ID zu erhalten, und dann die Geocoding API, um die Orts-ID in einen „latlng“-Wert zu geocodieren. |
| Automatische Systemverarbeitung vollständiger, eindeutiger Postadressen (z. B. „48 Pirrama Rd, Pyrmont, NSW, Australien“) | Verwenden Sie den Geocoding API-Webdienst. |
| Mehrdeutige Abfragen werden von automatisierten Systemen verarbeitet, z. B. unvollständige, falsch formatierte oder falsch geschriebene Adressen | Automatisierte Systeme sollten den Geocoding API-Webdienst verwenden. Bei automatisierten Systemen mit vielen mehrdeutigen, unvollständigen oder falsch geschriebenen Abfragen, die aus Nutzereingaben abgeleitet werden, kann jedoch ein interaktives Place Autocomplete-Widget hilfreich sein. So können Nutzer ein Ergebnis auswählen und vermeiden, dass Adressen falsch geschrieben werden. |
| Latenzprobleme mit der Directions API oder der Distance Matrix API, bei denen Ursprünge, Ziele oder Wegpunkte als Adressstrings angegeben wurden | Reduzieren Sie die Geocoding-Latenz, indem Sie den Place Autocomplete-Dienst der Places API verwenden, um Orts-IDs abzurufen. Übergeben Sie dann die Place IDs an die Directions API oder Distance Matrix API. |
Reaktion auf Nutzereingaben
Bei Anwendungen, die in Echtzeit auf Nutzereingaben reagieren, müssen zwei wichtige Aspekte beachtet werden, die sich auf die Wahl der API auswirken:
- Bei Nutzereingaben wird die Adresse in der Regel progressiv eingegeben (z. B. „Hauptstraße 123“). Daher ist es sinnvoll, unvollständige, mehrdeutige Adressen zu geocodieren, da der Nutzer so schneller ein Ergebnis erhält.
- Anwendungen, die auf Nutzereingaben reagieren, sind in hohem Maße latenzsensitiv.
Aufgrund dieser beiden Aspekte ist der „Place Autocomplete“-Dienst in der Places API ideal für den Anwendungsfall der Reaktion auf Nutzereingaben. „Place Autocomplete“ wurde entwickelt, um mehrere mögliche Optionen zurückzugeben und den Nutzern die Wahl zu lassen. Die Places API kann auf Geocoding-Adressen oder Adressen beschränkt werden, während Unternehmen ausgeschlossen werden. Außerdem kann die Funktion zur Suche nach der automatischen Vervollständigung so beeinflusst werden, dass standortspezifische Ergebnisse zurückgegeben werden. Die Places API gibt eine Orts-ID zurück, die als vollständig eindeutiger Standort an den Geocoding API-Webdienst übergeben werden kann. Dieser gibt dann vollständige Adressdetails zurück und geocodiert die Adresse in eine „latlng“-Adresse. Orts-IDs können auch an andere APIs wie die Directions API und die Distance Matrix API übergeben werden (siehe unten).
Die Adressen-Geocoding in der Geocoding API hat eine viel höhere Latenz und führt außerdem zu weniger genauen Ergebnissen für unvollständige oder zweideutige Abfragen. Daher wird sie nicht für Anwendungen empfohlen, die in Echtzeit auf Nutzereingaben reagieren müssen.
Weitere Informationen zum Place Autocomplete-Dienst für Android, iOS, JavaScript und die Places API.
Automatisierte Systeme
Automatische Systemverarbeitung vollständiger, eindeutiger Postadressen: Uneindeutige Abfragen wie vollständige Postanschrifts-Strings (z. B. „48 Pirrama Rd, Pyrmont, NSW, Australia“) funktionieren am besten mit dem Geocoding API-Webdienst. Das Back-End für die Adress-Geocoding bietet eine größere Abdeckung weltweit von Adressen und ist für hochwertige Ergebnisse mit diesen Arten von vollständigen, eindeutigen Abfragen optimiert.
Automatisierte Systemverarbeitung mehrdeutiger Abfragen: Mehrdeutige Abfragen sind schlecht formatierte Adressen, unvollständige Adressen oder Rechtschreibfehler. Für automatisierte Systeme empfehlen wir die Verwendung des Geocoding API-Webdiensts. Die Geocoding API ist jedoch nicht auf mehrdeutige Abfragen ausgelegt und kann bei mehrdeutigen Abfragen weniger genaue Ergebnisse oder keine Ergebnisse liefern. Wenn Ihr automatisiertes System eine hohe Anzahl uneindeutiger Abfragen verarbeitet, die aus Nutzereingaben abgeleitet werden, kann es hilfreich sein, Ihrer App mit dem „Place Autocomplete“-Dienst in der Places API ein interaktives Element hinzuzufügen. Es hat die Möglichkeit, mehrere mögliche Optionen zurückzugeben und dem Nutzer die Wahl zwischen diesen zu geben. Die Places API gibt eine Orts-ID zurück, die als vollständig eindeutiger Standort an den Geocoding API-Webdienst übergeben werden kann. Dieser gibt dann vollständige Adressdetails zurück und geocodiert die Adresse in eine „latlng“-Adresse. Weitere Informationen zum Place Autocomplete-Dienst für Android, iOS, JavaScript und die Places API.
Latenzzeiten für die Directions API und die Distance Matrix API reduzieren
Wenn Start- und Zielorte oder Wegpunkte als Adressstrings angegeben werden, verwenden die Directions API und die Distance Matrix API dasselbe Back-End wie die Geocoding API, um diese Adressen vor der Berechnung der Route zu geocodieren. Dies erhöht die Latenz erheblich, verglichen mit den Angaben für dieselben Standorte wie Latngs oder Place IDs.
Wenn Ihre Anwendung die Directions API oder die Distance Matrix API in einer latenzempfindlichen Situation verwendet, z. B. bei der Antwort auf eine Nutzereingabe, und Ihre Ursprünge, Ziele oder Wegpunkte anfangs als Adressstrings angegeben sind, sollten Sie die Latenz minimieren. Verwenden Sie dazu den Place Autocomplete-Dienst der Places API, um Adressstrings in Orts-IDs zu konvertieren. Übergeben Sie dann die Orts-IDs an die Directions API oder Distance Matrix API. Weitere Informationen zum Place Autocomplete-Dienst für Android, iOS, JavaScript und die Places API. Hier findest du ein JavaScript-Beispiel für die automatische Vervollständigung von Orten und Wegbeschreibungen.
Fazit
Je nach Anwendungsfall können Sie beim Geocoding von Adressen mit der Geocoding API oder dem Place Autocomplete-Dienst in Verbindung mit der Geocoding API Anwendungen erstellen, die Nutzern genaue Geocoding-Ergebnisse sowie eine reduzierte Latenz bieten.
Fehler und Wiederholversuche
Wenn Sie UNKNOWN_ERROR-Antworten erhalten, werden diese durch vorübergehende Fehler verursacht und sollten am besten nach einer kurzen Verzögerung wiederholt werden. Wir empfehlen dir, die Clientbibliotheken der Google Maps Platform-Webdienste zu verwenden, die Wiederholungslogik enthalten und die Authentifizierung der Google Maps Platform-Premiumoption unterstützen.
Der Java-Client, der Python-Client, der Go-Client und der Node.js-Client für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die auf GitHub heruntergeladen und veröffentlicht werden können. Dort finden Sie auch eine Installationsanleitung und Beispielcode.
Wenn Sie als Antwort den Statuscode OVER_QUERY_LIMIT erhalten, haben Sie die Nutzungslimits für die API überschritten. Wir empfehlen Ihnen, diese Strategien zur Nutzungsoptimierung auszuprobieren.