Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengradkoordinaten oder Orts-ID akzeptiert. Dabei wird die Adresse in Breiten- und Längengradkoordinaten und eine Orts-ID umgewandelt oder Breiten- und Längengradkoordinaten oder eine Orts-ID in eine Adresse.
Die Geocoding API v4 bietet sowohl hyperlokale Ziel- und Ankunftsinformationen als auch grundlegende Funktionen zur Auflösung von Koordinaten in Adressen. Egal, ob Sie eine Anwendung für die Zustellung auf der letzten Meile, für Mitfahrgelegenheiten oder für die detaillierte Routenführung entwickeln oder Adressen in Koordinaten normalisieren möchten – Version 4 bietet dedizierte Endpunkte, die auf Ihren Anwendungsfall zugeschnitten sind.
Sie sind sich nicht sicher, welcher Endpunkt für Ihre Anwendung geeignet ist? Weitere Informationen finden Sie unter Geocoding-Methode auswählen.
Möglichkeiten mit der Geocoding API
Die Geocoding API v4 bietet die folgenden Funktionen und Endpunkte:
- Nach Zielen suchen: Sie können hyperlokale Ankunftsdetails für ein Ziel anhand einer Adresse, einer Orts-ID oder von Koordinaten abrufen, einschließlich Gebäudeeingängen, routingfähigen Navigationspunkt-Tokens, Gebäude- und Grundstücksumrissen, Unterzielen und Sehenswürdigkeiten in der Nähe.
- Geocoding einer Adresse durchführen: Adressen in geografische Koordinaten und Orts-IDs umwandeln (Geocoding).
- Standort geocodieren: Wandeln Sie Breiten- und Längengradkoordinaten in menschenlesbare Adressen oder Verwaltungsgebiete um (umgekehrte Geocodierung).
- Ort geocodieren: Sie können formatierte Adressdetails und Koordinaten für eine bekannte Google Maps-Orts-ID abrufen.
Sie können festlegen, wo die Ergebnisse angezeigt werden, und die Ergebnisse auf eine bestimmte Region, einen bestimmten Bezirk oder eine bestimmte Postleitzahl beschränken.
Demo ansehen
Funktionsweise der Geocoding API
Die Geocoding API v4 unterstützt neben der einfachen Geocodierung auch die Zielsuche:
- Destination Search (
SearchDestinations): Löst eine Adresse, Orts-ID oder ein Koordinatenpaar in ein umfangreichesDestination-Objekt auf. Verwenden Sie diese Methode, wenn die physische Ankunft wichtig ist, z. B. um bevorzugte Gebäudeeingänge zu identifizieren, Fahrer mithilfe von Navigationspunkt-Tokens zu bestimmten Abhol- oder Absetzpunkten zu leiten, Gebäudegrundrisse auf einer Karte darzustellen oder in Gebäudekomplexen zu navigieren. - Einfaches Geocoding: Konvertiert Adressen, Koordinaten und Orts-IDs:
- Geocoding: Wandelt Adressen wie „1600 Amphitheatre Parkway, Mountain View, CA“ in Breiten- und Längengradkoordinaten oder Orts-IDs um, um Kartenmarkierungen zu platzieren oder den Kartenausschnitt zu zentrieren.
- Umgekehrte Geocodierung: Breiten- und Längengradkoordinaten oder Orts-IDs werden in menschenlesbare Adressen umgewandelt, die für von Nutzern gesetzte Markierungen, die Standortauswahl oder die Anzeige in der Benutzeroberfläche verwendet werden können.
- Geocoding für Orte: Ruft Adressdetails und Koordinaten für eine bekannte Google Maps-Orts-ID ab.
In der folgenden Tabelle sind die über die Geocoding API v4 verfügbaren Ressourcen sowie die von den einzelnen Methoden zurückgegebenen Daten zusammengefasst:
| Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
|---|---|---|
| Nach Zielen suchen ( POST /v4/geocode/destinations)
|
Gibt hyperlokale Ankunftsinformationen zurück: Polygone für Gebäude und Gelände (displayPolygon), physische entrances, routingfähige navigationPoints (mit Tokens), hierarchische containingPlaces und subDestinations, relationale landmarks und Details zum primären Ort. Nach Reisezielen suchen
|
|
| Geocoding einer Adresse durchführen ( GET /v4/geocode/address)
|
Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Geocode-Antwort. | |
| Standort geocodieren ( GET /v4/geocode/location)
|
Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Antwort bei umgekehrter Geocodierung. | |
| Geocoding für einen Ort ( GET /v4/geocode/places)
|
Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Geocoding-Antwort für Orte. |
Kanäle für Einführungsphasen
Version 4 der Geocoding API hat separate Kanäle für GA-, Vorabversion- und experimentelle Funktionen. Wenn Sie Funktionen der Vorabversion oder experimentelle Funktionen verwenden möchten, müssen Sie in Ihrer Anfrage den richtigen Kanal angeben. Wenn Sie beispielsweise auf Funktionen des Destinations-Endpunkts in der experimentellen Version zugreifen möchten, verwenden Sie diese HTTP-Anfrage: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Startphase | Kanalname |
|---|---|
| GA | /v4/ |
| Vorschau | /v4beta/ |
| Experimentell | /v4alpha/ |
- Eine Liste und Beschreibung aller verfügbaren REST-Ressourcen finden Sie in der REST-Referenz.
- Weitere Informationen zu den einzelnen Phasen finden Sie unter Phasen der Markteinführung.
Funktionen in der Geocoding API v4
Version 4 der Geocoding API bietet die folgenden neuen Funktionen.
Suchmethode für Zielorte
In Version 4 wird die Methode „Destination Search“ eingeführt, mit der Sie detaillierte Informationen zu verschiedenen Zielen anhand verschiedener Eingabekriterien wie Adresse, Orts-ID oder Breiten- und Längengrad abrufen können. Die Antwort enthält KI-basierte Zusammenfassungen und Navigationspunkt-Tokens mit Kontextinformationen, die für eine genaue Routenplanung an das Navigation SDK übergeben werden können.
Implementiert auf der Google Cloud-Standardplattform
Die Geocoding API v4 ist in der Dienstinfrastruktur von Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses standardmäßige API-Design sorgt für eine gewisse Konsistenz zwischen den APIs, was die Entwicklung mit der Geocoding API v4 effizienter macht.
OAuth-Unterstützung hinzugefügt
Die Geocoding API v4 unterstützt die Verwendung von OAuth 2.0 für die Authentifizierung. Google unterstützt gängige OAuth 2.0-Szenarien, z. B. für einen Webserver.
Unterstützung für Feldmasken hinzugefügt
Verwenden Sie Feldmasken, um anzugeben, welche Informationen die Antwort enthalten soll. Bei den Methoden Adresse geocodieren, Ort geocodieren und Ort geocodieren werden standardmäßig alle Felder im Antwortobjekt zurückgegeben. Für die Methode Nach Zielen suchen müssen Sie in der API-Anfrage eine Feldmaske angeben.
API-Sicherheit
Die Geocoding API v4 ist als Server-zu-Server-API konzipiert. Direkte clientseitige Aufrufe über einen Browser bergen ein erhebliches Risiko für Diebstahl und Missbrauch von API-Schlüsseln, da Einschränkungen vom Typ „HTTP-Referrer“ keinen ausreichenden Schutz für Webdienst-Endpunkte bieten.
Wir empfehlen dringend, die Geocoding API v4 von Ihrem eigenen Backend-Server aufzurufen. Weitere Informationen zu sicheren Implementierungsmustern und Alternativen für clientseitige Anforderungen finden Sie unter Sicherheitsaspekte.