Geocoding API einrichten

Entwickler im Europäischen Wirtschaftsraum (EWR)

Wenn sich Ihre Rechnungsadresse im Europäischen Wirtschaftsraum befindet, unterliegt Ihre Nutzung der Dienste ab dem 8. Juli 2025 den Nutzungsbedingungen der Google Maps Platform für den EWR. Die Funktionalität variiert je nach Region. Weitere Informationen

In diesem Dokument wird beschrieben, wie Sie die Geocoding API verwenden können.

1. Konto und Abrechnung Prüfen Sie, ob Sie die Voraussetzungen erfüllen.

2. API aktivieren Aktivieren Sie die API in Ihrem Google Cloud-Projekt.

3. Erste Anfrage senden Konfigurieren Sie einen API-Schlüssel oder OAuth, um eine authentifizierte API-Anfrage zu stellen.

Wichtig: Diese Einrichtungsanleitung enthält die Schritte zum Konfigurieren eines API-Schlüssels und zum Erstellen eines OAuth-Tokens. Wählen Sie das Verfahren aus, das für Ihre Bereitstellungsumgebung gilt.

Google Maps Platform-Produkte sind vor unbefugter Nutzung geschützt, da API-Aufrufe entweder einen API-Schlüssel oder ein OAuth-Token enthalten müssen.

API-Schlüssel OAuth-Token

OAuth-Token erstellen

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

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

Hinweis :

Sie können Google Maps APIs zwar direkt verwenden, indem Sie API-Anfragen an den Server senden, aber Clientbibliotheken bieten Vereinfachungen, die den zu schreibenden Code erheblich reduzieren. Google Maps bietet Clientbibliotheken für viele Programmiersprachen, darunter Go, Java, Node.js und Python.

Dokumentation und Beispiele

OAuth

Je nach Bereitstellungsumgebung gibt es viele Möglichkeiten, Zugriffstokens mit OAuth zu erstellen und zu verwalten.

Das Google OAuth 2.0-System unterstützt beispielsweise Server-zu-Server-Interaktionen, z. B. zwischen Ihrer Anwendung und einem Google-Dienst. Für dieses Szenario benötigen Sie ein Dienstkonto. Ein solches Konto ist einer Anwendung zugeordnet und nicht einem bestimmten Endnutzer. Ihre Anwendung ruft Google APIs im Namen des Dienstkontos auf, sodass Nutzer nicht direkt beteiligt sind. Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Authentifizierungsmethoden bei Google.

Alternativ können Sie die Geocoding API auch in einer Android- oder iOS-App verwenden. Allgemeine Informationen zur Verwendung von OAuth mit der Geocoding API, einschließlich Informationen zur Verwaltung von Zugriffstokens für verschiedene Bereitstellungsumgebungen, finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

OAuth-Bereiche

Wenn Sie OAuth mit der Geocoding API verwenden möchten, muss dem OAuth-Token der richtige Bereich zugewiesen sein. Die Geocoding API unterstützt die folgenden Bereiche:

• https://www.googleapis.com/auth/maps-platform.geocode – Für alle Geocoding API-Endpunkte verwenden.
• https://www.googleapis.com/auth/maps-platform.geocode.address – Nur mit GeocodeAddress für die Vorwärtsgeocodierung 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 Orts-Geocodierung verwenden.

Außerdem können Sie den allgemeinen https://www.googleapis.com/auth/cloud-platform-Bereich für alle Geocoding API-Endpunkte verwenden. Dieser Bereich ist während der Entwicklung nützlich, da er der Standardbereich ist, der beim Erstellen von Tokens mit gcloud verwendet wird.

Beispiel: REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie die Geocoding API mit einem OAuth-Token testen möchten, aber keine Umgebung zum Generieren von Tokens eingerichtet haben, können Sie den Aufruf mit der Anleitung in diesem Abschnitt ausführen.

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

Hinweis: Die folgende Vorgehensweise zum Ausführen eines REST-Aufrufs ist nicht für die Verwendung in einer Produktionsumgebung vorgesehen. Verwenden Sie dieses Verfahren nur für eine Entwicklungs- oder Testumgebung.

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen können, müssen Sie mit der Google Cloud CLI Anmeldedaten für ADC bereitstellen:

1. Installieren und initialisieren Sie die gcloud CLI.

2. Führen Sie den folgenden gcloud-Befehl auf Ihrem lokalen Computer aus, um die Datei mit den Anmeldedaten zu erstellen:

   gcloud auth application-default login

3. Ein Anmeldebildschirm wird angezeigt. Nach der Anmeldung werden Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC gespeichert.

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

REST-Anfrage stellen

In diesem Beispiel werden zwei Anfrageheader übergeben:

• Ü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 aktiviert ist, im X-Goog-User-Project-Header.

Im folgenden Beispiel wird die Geocoding API mit einem OAuth-Token aufgerufen.

1. Bearbeiten Sie das Feld PROJECT_ID, um die ID Ihres Google Cloud-Projekts zu übergeben.

   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/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. Klicken Sie im Codebeispiel auf das Kopiersymbol , um den Befehl curl zu kopieren.
3. Fügen Sie den Befehl in ein Terminalfenster ein und führen Sie ihn aus.

Die Antwort ist ein JSON-Objekt:

Fehlerbehebung

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