Time Zone API einrichten

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

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 sich mit den Kosten für die Nutzung der Time Zone API vertraut machen.

  1. Informationen zu Abrechnung und Kosten für die Nutzung finden Sie unter Time Zone API – Nutzung und Abrechnung.

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

    Melden Sie sich in der Google Cloud Console an.

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

    Zur Seite „Abrechnung“
    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 Time Zone API verwenden können, müssen Sie sie in Ihrem Google Cloud-Projekt mit der Google Cloud Console oder dem Befehl gcloud aktivieren.

So aktivieren Sie die API:

Console

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

    Time Zone API aktivieren

  2. Klicken Sie auf Aktivieren.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "timezone-backend.googleapis.com"

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

API-Schlüssel für die Time Zone API abrufen

Google Maps Platform-Produkte sind vor unbefugter Nutzung geschützt, da API-Aufrufe nur mit einem API-Schlüssel möglich sind.

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. Entfernen Sie alle APIs, die für diesen Schlüssel nicht erforderlich sind, und achten Sie darauf, dass die Time Zone 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 Time Zone API aus.
      3. Klicken Sie auf Speichern.

    Wenn Sie hier eine API auswählen, wird sie nicht aktiviert. Prüfen Sie, ob die Time Zone 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=timezone-backend.googleapis.com

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

  • 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=timezone-backend.googleapis.com

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

    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 Time Zone API-Anfrage, um eine JSON-Antwort mit den Zeitzoneninformationen für Nevada, USA, zu erhalten. Der Zeitstempel ist auf den 5. Dezember 2024 festgelegt. 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 -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'
  2. Klicken Sie im Codebeispiel auf das Kopiersymbol Wählen Sie das Symbol zum Kopieren aus., 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:

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}

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

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.

Nächste Schritte

Nachdem Sie die Time Zone API aktiviert und eine erfolgreiche Anfrage gestellt haben, finden Sie unter Anfragen und Antworten für die Time Zone API weitere Informationen zur Verwendung der API.