Geocoding API einrichten

In diesem Dokument werden die Schritte beschrieben, die Sie ausführen müssen, um die Geocoding API zu verwenden.

Bei Google Maps Platform-Produkten müssen API-Aufrufe entweder einen API-Schlüssel oder ein OAuth-Token enthalten, um eine nicht autorisierte Nutzung zu verhindern. Sie können das Einrichtungsverfahren auswählen, das zu Ihrer Bereitstellungsumgebung passt.

API-Schlüssel OAuth-Token

OAuth-Token erstellen

Die Geocoding API unterstützt OAuth 2.0 für die Authentifizierung. Google unterstützt gängige OAuth 2.0-Szenarien, z. B. Szenarien für einen Webserver.

In diesem Dokument wird beschrieben, wie Sie ein OAuth-Token an einen Geocoding API-Aufruf in Ihrer Entwicklungsumgebung übergeben. Weitere Informationen zur Verwendung von OAuth in einer Produktionsumgebung finden Sie unter Authentifizierungsmethoden bei Google.

Sie können Google Maps APIs direkt aufrufen, indem Sie API-Anfragen an den Server senden, oder Sie können Clientbibliotheken verwenden, um Ihren Code zu vereinfachen. Google Maps bietet Clientbibliotheken für Go, Java, Node.js und Python. Weitere Informationen finden Sie unter Geocoding API-Clientbibliotheken.

OAuth-Übersicht

Je nach Bereitstellungsumgebung können Sie Zugriffstokens mit OAuth auf verschiedene Arten erstellen und verwalten.

Sie können OAuth 2.0 für Server-zu-Server-Interaktionen zwischen Ihrer Anwendung und einem Google-Dienst verwenden. In diesem Szenario verwenden Sie ein Dienstkonto, das mit Ihrer Anwendung und nicht mit einem einzelnen Nutzer verknüpft ist. Sie können API-Anfragen mit dem Dienstkonto stellen, ohne Nutzer direkt einzubeziehen. Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Authentifizierungsmethoden bei Google.

Alternativ können Sie die Geocoding API in eine mobile Android- oder iOS-App einbinden. Weitere Informationen zur Verwendung von OAuth und zur Verwaltung von Zugriffstokens für verschiedene Bereitstellungsumgebungen finden Sie unter OAuth 2.0 für den Zugriff auf Google APIs verwenden.

OAuth-Bereiche

Wenn Sie OAuth mit der Geocoding API verwenden möchten, müssen Sie dem OAuth-Token den richtigen Bereich zuweisen. Die Geocoding API unterstützt die folgenden Bereiche:

• https://www.googleapis.com/auth/maps-platform.geocode: Verwenden Sie diesen Parameter mit allen Geocoding API-Methoden.
• https://www.googleapis.com/auth/maps-platform.destinations: Nur mit SearchDestinations für Ziel- und Ankunftsabfragen verwenden.
• https://www.googleapis.com/auth/maps-platform.geocode.address: Nur mit GeocodeAddress für die Geocodierung verwenden.
• https://www.googleapis.com/auth/maps-platform.geocode.location: Nur mit GeocodeLocation für die umgekehrte Geocodierung verwenden.
• https://www.googleapis.com/auth/maps-platform.geocode.place: Nur mit GeocodePlace für die Geocodierung von Orten verwenden.

Sie können auch den allgemeinen Bereich https://www.googleapis.com/auth/cloud-platform für alle Geocoding API-Methoden verwenden. Dieser Zugriffsbereich ist während der Entwicklung nützlich, da er der Standardzugriffsbereich ist, wenn Sie Tokens mit der gcloud-Befehlszeile erstellen.

Beispiel: REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie keine Umgebung haben, die Tokens generiert, und die Geocoding API mit einem OAuth-Token ausprobieren möchten, folgen Sie der Anleitung in diesem Abschnitt.

In diesem Beispiel wird beschrieben, wie Sie das OAuth-Token verwenden, das von Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) bereitgestellt wird, um den Aufruf auszuführen. Weitere Informationen zur Verwendung von ADC zum Aufrufen von Google APIs mit Clientbibliotheken finden Sie unter Mit Clientbibliotheken authentifizieren.

Verwenden Sie das folgende REST-Verfahren nur für die Entwicklung oder für Tests, nicht für die Produktion.

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen, verwenden Sie die gcloud-Befehlszeile, um Anmeldedaten für ADC bereitzustellen:

1. Installieren und initialisieren Sie gcloud CLI. Weitere Informationen finden Sie unter gcloud CLI installieren.

2. Authentifizieren Sie sich mit der gcloud-Befehlszeile:

   gcloud auth application-default login

3. Schließen Sie die Anmeldung ab, um Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC zu speichern.

Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen für eine lokale Entwicklungsumgebung einrichten.

REST-Anfrage stellen

In diesem Beispiel übergeben Sie zwei Anfrageheader:

• Übergeben Sie das OAuth-Token im Authorization-Header. Verwenden Sie dazu den folgenden Befehl, um das Token zu generieren:

  gcloud auth application-default print-access-token

  Das zurückgegebene Token hat den Bereich https://www.googleapis.com/auth/cloud-platform.

• Übergeben Sie die ID oder den Namen Ihres Google Cloud-Projekts, für das die Abrechnung im Header X-Goog-User-Project aktiviert ist.

So rufen Sie die Geocoding API mit einem OAuth-Token auf:

1. Ersetzen Sie im folgenden Codebeispiel PROJECT_ID durch Ihre Google Cloud-Projekt-ID:

   curl -X GET -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. Klicken Sie im Codebeispiel auf Kopieren, um den Befehl curl zu kopieren.

3. Fügen Sie den Befehl in ein Terminalfenster ein und führen Sie ihn aus.

Fehlerbehebung

Wenn Ihre Anfrage eine Fehlermeldung zurückgibt, die angibt, dass diese API keine Endnutzeranmeldedaten unterstützt, finden Sie weitere Informationen unter Fehlerbehebung für die ADC-Einrichtung.