Weather API einrichten

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

Wenn Sie die Weather API verwenden möchten, können Sie entweder einen Demoschlüssel für Google Maps anfordern oder ein Konto einrichten und die Abrechnung aktivieren.

Demoschlüssel für Google Maps abrufen

Der Demoschlüssel für Google Maps ist eine kostenlose Funktion, die es Ihnen ermöglicht, mit dem Prototyping mit der Weather API zu beginnen, ohne Zahlungsinformationen einzugeben. Der Demoschlüssel für Google Maps ist nur für Test- und Prototyping-Zwecke gedacht und nicht für die Produktion geeignet. Weitere Informationen finden Sie unter Demoschlüssel für Google Maps abrufen und mit der Weather API verwenden.

Standard-API-Schlüssel abrufen

Wenn Sie Ihren Code in die Produktion verschieben möchten, führen Sie die folgenden Schritte aus, um einen API-Schlüssel zu erstellen und die Abrechnung zu aktivieren.

Vorbereitung

In diesem Verfahren werden Sie durch die Einrichtung eines Google Cloud-Kontos und eines Google Cloud-Projekts mit aktivierter Abrechnung geführt. Außerdem sollten Sie wissen, wie die Nutzung der Weather API abgerechnet wird.

1. Informationen zur Abrechnung und zu den Kosten für die Nutzung finden Sie unter Weather API – Nutzung und Abrechnung.

2. Prüfen Sie, ob Sie ein Google Cloud-Konto haben.

   Melden Sie sich in der Google Cloud Console an.
   Hinweis: Wenn Sie ein neuer Nutzer sind und kein Google Cloud-Konto haben, sich also nicht in der Console anmelden können, lesen Sie den Hilfeartikel Erste Schritte mit der Google Maps Platform.

3. Prüfen Sie, ob Sie ein Google Cloud-Projekt mit aktivierter Abrechnung haben.

   Zur Seite „Abrechnung“
   Hinweis: Wenn Sie ein neuer Nutzer sind und kein Google Cloud-Projekt haben, lesen Sie den Artikel Erste Schritte mit der Google Maps Platform.
1. Wählen Sie Ihr Projekt aus, um die Seite Abrechnung zu öffnen.

2. Auf der Seite Abrechnung:

   • Wenn die Abrechnung für das ausgewählte Projekt bereits aktiviert ist und Sie nur ein einziges Rechnungskonto haben, wird die Seite Abrechnung geöffnet.
   • Wenn Sie mehrere Rechnungskonten haben, wählen Sie Zum verknüpften Rechnungskonto aus, um die Details zum Rechnungskonto aufzurufen, das mit dem Projekt verknüpft ist.
   • Wenn ein Rechnungskonto vorhanden, aber nicht mit dem Projekt verknüpft ist, werden Sie aufgefordert, ein Rechnungskonto mit dem Projekt zu verknüpfen.
   • Wenn kein Rechnungskonto vorhanden ist oder Sie ein neues Rechnungskonto erstellen möchten, wählen Sie Rechnungskonten verwalten aus, um ein neues Rechnungskonto zu erstellen. Weitere Informationen finden Sie unter Neues Selfservice-Cloud-Rechnungskonto erstellen.

API aktivieren

Bevor Sie die Weather API verwenden können, müssen Sie sie in Ihrem Google Cloud-Projekt mit der Google Cloud Console oder dem Befehl gcloud aktivieren.

Hinweis: Nachdem Sie eine API aktiviert haben, müssen Sie möglicherweise einige Minuten warten, bevor Sie eine Anfrage an sie senden können.

So aktivieren Sie die API:

Console

1. Öffnen Sie die Produktseite in der Google Cloud Console:

   Weather API aktivieren

2. Klicken Sie auf Aktivieren.

   Hinweis: Wenn die API bereits aktiviert ist, wird der Button Verwalten anstelle von Aktivieren angezeigt.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "weather.googleapis.com"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

• gcloud services enable
• gcloud services disable

API-Schlüssel für die Verwendung mit der Weather API abrufen

Wichtig: Dieser Einrichtungsleitfaden enthält sowohl die Anleitung zum Konfigurieren eines API-Schlüssels als auch 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. Zuerst wird der API-Schlüssel erstellt. Wenn Sie stattdessen ein OAuth-Token verwenden möchten, lesen Sie die Informationen unter OAuth-Token erstellen.

Ein API-Schlüssel ist ein eindeutiger alphanumerischer String, über den Ihr Cloud-Rechnungskonto und Ihr Google Cloud-Projekt mit der Anfrage verknüpft werden, die Ihre Anwendung an eine Google Maps Platform API oder ein Google Maps Platform SDK sendet. Folgen Sie dieser Anleitung, um einen neuen Schlüssel zu erstellen oder eine API oder ein SDK zu einem vorhandenen Schlüssel hinzuzufügen.

Console

1. Rufen Sie die Seite Google Maps Platform > Schlüssel und Anmeldedaten auf.

   Zur Seite „Schlüssel und Anmeldedaten“

2. Wählen Sie bei Aufforderung Ihr Projekt aus.

3. Führen Sie einen der folgenden Schritte aus:

   • Neuen Schlüssel erstellen:

     1. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
     2. Öffnen Sie im Bereich API-Schlüssel erstellen die Liste API-Einschränkungen auswählen.
     3. Löschen Sie alle APIs, die für diesen Schlüssel nicht erforderlich sind, und achten Sie darauf, dass die Weather API ausgewählt bleibt.
     4. Klicken Sie auf Erstellen. Im Bereich wird der neue API-Schlüssel angezeigt.

   • Vorhandenen Schlüssel verwenden:

     1. Klicken Sie auf den Namen des Schlüssels.
     2. Wählen Sie in der Liste API-Einschränkungen auswählen die Option Weather API aus.
     3. Klicken Sie auf Speichern.

   Wenn Sie hier eine API auswählen, wird sie nicht aktiviert. Prüfen Sie, ob die Weather API auf der Seite „API-Bibliothek“ aktiviert ist.

4. Wenn Sie den Schlüsselstring später sehen möchten, rufen Sie die Seite Schlüssel und Anmeldedaten auf und klicken Sie für den Schlüssel auf Schlüssel anzeigen.

Wenn die Console anders aussieht als in diesen Schritten, finden Sie weitere Informationen in der Google Cloud-Dokumentation unter API-Schlüssel erstellen und API-Einschränkungen hinzufügen.

gcloud

Ersetzen Sie in den folgenden Befehlen PROJECT_ID durch Ihre Projekt-ID.

• Neuen Schlüssel erstellen: Führen Sie den folgenden Befehl aus und ersetzen Sie DISPLAY_NAME durch einen Namen für den Schlüssel.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=weather.googleapis.com

  Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

  • gcloud services api-keys create

• Vorhandenen Schlüssel verwenden: Führen Sie den folgenden Befehl aus und ersetzen Sie KEY_ID durch die ID des Schlüssels. Mit dem Flag --append werden die APIs beibehalten, die der Schlüssel bereits zulässt. Ohne diesen Parameter werden sie durch den Befehl ersetzt.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=weather.googleapis.com

  Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

  • gcloud services api-keys update
  • gcloud services api-keys list

  Die Schlüssel-ID ist nicht der Schlüsselstring oder der Anzeigename. Führen Sie gcloud services api-keys list --project="PROJECT_ID" aus, um sie zu finden. Die ID ist der letzte Teil des Felds name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Führen Sie gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" aus, um den Schlüsselstring aufzurufen.

API-Anfrage stellen

Stellen Sie eine Weather API-Anfrage, um eine JSON-Antwort mit den aktuellen Wetterbedingungen für Mountain View, Kalifornien, zu erhalten. Sie müssen den alphanumerischen String Ihres API-Schlüssels in jede Anfrage einfügen und HTTPS für Anfragen verwenden, die den API-Schlüssel enthalten.

1. Klicken Sie im Code unten auf API_KEY, um den alphanumerischen String des Schlüssels einzufügen:

   curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841"
   

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 im folgenden Format:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

Einschränkungen für API-Schlüssel anwenden

Achtung: Mit einem uneingeschränkten API-Schlüssel können Anfragen an alle Google Maps Platform-Dienste gestellt werden, einschließlich der Weather API. Sie sind finanziell für die Kosten verantwortlich, die durch den Missbrauch uneingeschränkter API-Schlüssel entstehen.

Google empfiehlt dringend, die API-Schlüssel einzuschränken, indem Sie ihre Nutzung auf die APIs und Apps beschränken, die sie benötigen. Wenn Sie Ihre API-Schlüssel einschränken, wird Ihre App sicherer und es wird dafür gesorgt, dass nur autorisierte Anfragen gesendet werden. API-Schlüssel unterstützen zwei Arten von Einschränkungen:

• API-Einschränkungen geben an, welche SDKs und APIs mit dem API-Schlüssel aufgerufen werden können. In der Console und der gcloud CLI ist beim Erstellen eines Schlüssels mindestens eine API-Einschränkung erforderlich.
• Anwendungseinschränkungen geben an, welche Websites, IP-Adressen oder Anwendungen einen API-Schlüssel verwenden dürfen.

Weitere Informationen zum Anwenden von Einschränkungen finden Sie unter API-Schlüssel einschränken.

OAuth-Token erstellen

Die Weather 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 Weather API-Aufruf in Ihrer Entwicklungsumgebung übergeben. Weitere Informationen zur Verwendung von OAuth in einer Produktionsumgebung finden Sie unter Authentifizierungsmethoden bei Google.

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 Weather 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 Weather API verwenden möchten, müssen Sie dem OAuth-Token den folgenden Bereich zuweisen:

https://www.googleapis.com/auth/cloud-platform

Beispiel: REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie keine Umgebung haben, die Tokens generiert, und die Weather API mit einem OAuth-Token ausprobieren möchten, verwenden Sie das Verfahren 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 Weather API mit einem OAuth-Token auf:

1. Ersetzen Sie im folgenden Codebeispiel PROJECT_NUMBER_OR_ID durch die Nummer oder ID Ihres Google Cloud-Projekts:

   curl -X GET \
   -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://weather.googleapis.com/v1/currentConditions:lookup?location.latitude=37.4220&location.longitude=-122.0841"

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.

Die Antwort ist ein JSON-Objekt:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

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.

Nächste Schritte

Nachdem Sie die Weather API aktiviert und eine erfolgreiche Anfrage gestellt haben, finden Sie unter Aktuelle Bedingungen abrufen weitere Informationen zur Verwendung der API.