API-Schlüssel verwenden

Google Maps Platform-Produkte sind vor unbefugter Nutzung geschützt, da API-Aufrufe nur nach Eingabe korrekter Authentifizierungsdaten möglich sind. Diese Daten werden als API-Schlüssel bereitgestellt. Das ist ein eindeutiger alphanumerischer String, über den Ihr Google-Rechnungskonto mit Ihrem Projekt und der jeweiligen API oder dem jeweiligen SDK verknüpft ist.

In diesem Leitfaden wird beschrieben, wie Sie einen API-Schlüssel für die Google Maps Platform erstellen, einschränken und verwenden.

Hinweis

Um die Maps Embed API nutzen zu können, benötigen Sie ein Projekt mit einem Rechnungskonto. Außerdem muss die Maps Embed API aktiviert sein. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.

API-Schlüssel erstellen

Der API-Schlüssel ist eine eindeutige ID. Damit werden die mit Ihrem Projekt verknüpften Anfragen zu Nutzungs- und Abrechnungszwecken authentifiziert. Mit Ihrem Projekt muss mindestens ein API-Schlüssel verknüpft sein.

So erstellen Sie einen API-Schlüssel:

Cloud Console

  1. Rufen Sie die Seite Google Maps Platform > Anmeldedaten auf.

    Zur Seite „Anmeldedaten“

  2. Klicken Sie auf der Seite Anmeldedaten auf Anmeldedaten erstellen > API-Schlüssel.
    Im Dialogfeld API-Schlüssel erstellt wird der neu erstellte API-Schlüssel angezeigt.
  3. Klicken Sie auf Schließen.
    Der neue API-Schlüssel wird auf der Seite Anmeldedaten unter API-Schlüssel aufgeführt.
    Es empfiehlt sich, den API-Schlüssel einzuschränken, bevor Sie ihn in der Produktionsumgebung verwenden.

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgendem Befehl:

API-Schlüssel einschränken

Google empfiehlt dringend, die API-Schlüssel einzuschränken, indem Sie deren Nutzung auf die APIs beschränken, die für Ihre Anwendung erforderlich sind. Wenn Sie Ihre API-Schlüssel einschränken, wird Ihre App sicherer und es wird dafür gesorgt, dass nur autorisierte Anfragen gesendet werden. Weitere Informationen finden Sie unter Best Practices für die API-Sicherheit.

So schränken Sie einen API-Schlüssel ein:

Cloud Console

  1. Rufen Sie die Seite Google Maps Platform > Anmeldedaten auf.

    Zur Seite „Anmeldedaten“

  2. Wählen Sie den API-Schlüssel aus, für den Sie eine Einschränkung festlegen möchten. Die Seite mit den Eigenschaften des API-Schlüssels wird angezeigt.
  3. Nehmen Sie unter Schlüsseleinschränkungen folgende Einstellungen vor:
    • Anwendungseinschränkungen:
      1. Wenn Sie Anfragen der aufgelisteten Websites zulassen möchten, die Sie angegeben haben, wählen Sie in der Liste der Anwendungseinschränkungen den Eintrag HTTP-Referrer-URLs (Websites) aus.
      2. Geben Sie mindestens eine Referrer-URL (Website) an. Sie können Platzhalterzeichen verwenden, um alle Subdomains zu autorisieren (bei https://*.google.com werden z. B. alle Websites akzeptiert, die auf .google.com enden, wenn darauf über HTTPS zugegriffen wird). Wenn Sie www.domain.com angeben, wird sie als Platzhalter www.domain.com/* verwendet, mit dem jeder Unterpfad dieses Hostnamens autorisiert wird. Es werden nur die Verweisquellenschemata https:// und http:// unterstützt.
    • API-Einschränkungen:
      1. Klicken Sie auf Schlüssel einschränken.
      2. Wählen Sie im Drop-down-Menü APIs auswählen die Option Maps Embed API aus. Ist die Maps Embed API nicht aufgeführt, müssen Sie sie zuerst aktivieren.
      3. Falls Sie für Ihr Projekt die Places Library nutzen, wählen Sie auch die Option Places API aus. Ebenso müssen Sie die entsprechende API in dieser Liste aktivieren und auswählen, wenn in Ihrem Projekt andere Dienste der JavaScript API verwendet werden (Directions Service, Distance Matrix Service, Elevation Service und/oder Geocoding Service).
  4. Klicken Sie abschließend auf Speichern.

Cloud SDK

Listen Sie die vorhandenen Schlüssel auf. 

gcloud services api-keys list --project="PROJECT"

Löschen Sie die vorhandenen Einschränkungen für einen vorhandenen Schlüssel. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Legen Sie neue Einschränkungen für den Schlüssel fest. 

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-embed-backend.googleapis.com
    --allowed-referrers="referer"

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

API-Schlüssel für die Anfrage angeben

Für jede Maps Embed API-Anfrage muss ein API-Schlüssel angegeben werden. Ersetze YOUR_API_KEY im folgenden Beispiel durch deinen API-Schlüssel. 

  https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&parameters