Anleitung zur Client-ID-Migration

Übersicht

Um die Sicherheit und Zuverlässigkeit der Authentifizierung zu erhöhen, werden Maps Platform-Client-IDs seit dem 26. Mai 2025 nicht mehr unterstützt und können nach dem 31. Mai 2026 nicht mehr verwendet werden.

Statt einer Client-ID müssen Sie API-Schlüssel-Anmeldedaten verwenden, um Ihren Google Maps API-Dienst-Traffic zu authentifizieren. In dieser Anleitung erfahren Sie, wie Sie von der Verwendung von Client-IDs zur Verwendung von API-Schlüsseln migrieren.

Führen Sie dazu die folgenden Schritte durch:

  1. Aktuelle Nutzung der Client-ID prüfen
  2. API-Schlüssel vorbereiten
  3. Kontingenteinstellungen überprüfen
  4. Code aktualisieren
  5. Traffic der Client-ID beobachten
  6. Client-ID pausieren

Aktuelle Nutzung der Client-ID prüfen

Bevor Sie mit der Migration beginnen, sollten Sie Folgendes auflisten:

  • Maps Platform-Dienste, die Sie mit Ihrer Client-ID verwenden.
  • Anwendungen, Websites oder Systeme, die Sie mit Ihrer Client-ID verwenden.

Google hat betroffene Kunden im Mai 2025 per E-Mail über die Einstellung der Unterstützung von Client-IDs informiert. Diese Informationen finden Sie auch in der Benachrichtigungs-E-Mail.

In der Cloud Console können Sie den aktuellen Status der Nutzung Ihrer Client-ID prüfen auf der Seite „Messwerte der Google Maps Platform“.

Liste der Maps Platform-Dienste:

  1. Öffnen Sie in der Cloud Console die Seite „Messwerte“.
  2. Filtern Sie die Nutzung mit den folgenden Einstellungen:
    • Anmeldedaten: Wählen Sie nur „project_number:<numerische Kennung>“ aus.
  3. Legen Sie den folgenden Filter fest:
    • Gruppiert nach: API

Hinweise zu Anwendungen, Websites oder Systemen:

In der Cloud Console werden keine Details zu Ihren Anwendungen, Websites oder Systemen angezeigt. Sie können aber einige Hinweise zu den Quellen Ihres Client-ID-Traffics finden. Gehen Sie dazu so vor:

  1. Öffnen Sie in der Cloud Console die Seite „Messwerte“.
  2. Wählen Sie im Drop-down-Menü einen Maps Platform-Dienst aus.
  3. Filtern Sie die Nutzung mit den folgenden Einstellungen:
    • Anmeldedaten: Wählen Sie nur „project_number:<numerische Kennung>“ aus.
  4. Legen Sie den folgenden Filter fest:
    • Gruppieren nach: Plattform oder Domain
  5. Wiederholen Sie die Schritte ab Schritt 2 für jeden Maps Platform-Dienst, für den Sie den Traffic prüfen müssen.

API-Schlüssel vorbereiten

Alle Client-IDs sind mit einem Google Cloud-Projekt verknüpft. Wenn Sie einen API-Schlüssel aus diesem Projekt verwenden, haben Sie Zugriff auf dieselben Funktionen, auf die Sie zuvor mit Ihrer Client-ID zugegriffen haben. Wir empfehlen, zum verknüpften Projekt zu migrieren, um Probleme mit Kontingenten oder fehlenden Funktionen zu vermeiden.

  1. Suchen Sie das Cloud-Projekt, mit dem Ihre Client-ID verknüpft ist:
  2. Achten Sie darauf, dass Ihr Cloud-Projekt mit einem offenen Rechnungskonto verknüpft ist.
  3. Erstellen Sie einen neuen API-Schlüssel für die Migration der Client-ID.

API-Schlüssel sichern

Sichern Sie Ihren API-Schlüssel, um ihn vor unbefugtem Zugriff zu schützen.

  • Legen Sie eine Anwendungseinschränkung für Ihren API-Schlüssel fest (z.B. Websites, IP-Adressen, Android-Apps oder iOS-Apps).
  • Legen Sie API-Einschränkungen für Ihren API-Schlüssel fest.

Weitere Informationen finden Sie im Sicherheitsleitfaden für die Google Maps Platform.

Für die Maps JavaScript API, die Maps Static API und die Street View Static API können Sie die vertrauenswürdigen Verweis-URLs Ihrer Client-ID zu den API-Schlüssel-Einschränkungen migrieren. Die Liste der vertrauenswürdigen Verweis-URLs finden Sie in der Cloud Console.

Kontingenteinstellungen überprüfen

Achten Sie darauf, dass in Ihrem Cloud-Projekt die erwarteten Kontingenteinstellungen festgelegt sind. Das ist nur erforderlich, wenn Sie die clientseitigen Dienste der Maps JavaScript API über eine Client-ID aufrufen. Sie können Ihre Kontingenteinstellungen auf der Seite „Kontingente der Google Maps Platform“ prüfen und anpassen.

Weitere Informationen zu Kontingentberichten

Kontingenterhöhung für clientseitige Dienste der Maps JavaScript API

Wenn Sie die folgenden Dienste in der Maps JavaScript API verwenden, steigt die Kontingentnutzung nach der Migration des API-Schlüssels.

Überprüfen Sie Ihre aktuelle Kontingentkonfiguration und die aktuelle Nutzung und passen Sie Ihre Kontingentlimits entsprechend an.

  1. Prüfen Sie, ob Sie clientseitige Dienste der Maps JavaScript API mit einer Client-ID verwenden.
    • Öffnen Sie in der Cloud Console die Seite „Messwerte“.
    • Filtern Sie die Nutzung mit den folgenden Einstellungen:
      • Gruppiert nach: API-Methode
      • Anmeldedaten: Wählen Sie nur „project_number:<numerische Kennung>“ aus.
    • Anschließend wird im Diagramm „Traffic nach API-Methode“ eine Liste mit Methodennamen und dem zugehörigen Traffic angezeigt.

API-Methode

Clientseitiger Dienst

Dienst zum Anpassen des Kontingents

google.routes.Directions.Javascript

„Directions“-Dienst

Directions API

google.routes.DistanceMatrix.Javascript

„Distance Matrix“-Dienst

Distance Matrix API

google.maps.Elevation.Javascript

„Elevation“-Dienst

Elevation API

google.places.Geocoding.Javascript

„Geocoding“-Dienst

Geocoding API

google.places.*.Javascript, außer google.places.Geocoding.Javascript

Places Library

Places API
  • Wenn Sie diese API-Methoden nicht verwenden, müssen Sie sich keine Gedanken über die Kontingenteinstellungen machen, da Ihr Client-ID-Traffic bereits auf Ihr Projektkontingent angerechnet wird.
  • Kontingentnutzung der Client-ID schätzen
    • Prüfen Sie für jeden Dienst sowohl die Granularität „Pro Sekunde“ als auch „Pro Tag“.
    • Diagramm „Pro Sekunde“: Multiplizieren Sie den Spitzen-Traffic mit 60, um den zusätzlichen Kontingentbedarf pro Minute zu ermitteln.
    • Diagramm „Pro Tag“: Der Spitzen-Traffic sollte dem zusätzlichen Kontingentbedarf pro Tag entsprechen.
  • Passen Sie das Kontingent für die entsprechenden Maps Platform-Dienste an.
    • Passen Sie das Kontingent für die entsprechenden Dienste anhand des Methodennamens an, den Sie in Schritt 1 finden.

Code aktualisieren

Client-Parameter durch Schlüsselparameter ersetzen

Aktualisieren Sie die Authentifizierungsanmeldedaten in Ihren ausgehenden GMP API-Aufrufen von URL&client={value} zu URL&key={value}. Wenn Ihre Apps HTTP verwenden, um auf GMP-Dienste zuzugreifen, aktualisieren Sie sie so, dass HTTPS verwendet wird.

Channel-Parameter für die Berichterstellung aktualisieren

Sie können Ihre Nutzung nach Channel verfolgen, indem Sie den Channel-Parameter in Ihren API-Anfragen angeben. API-Schlüssel unterstützen nur numerische Werte für den Channel-Parameter. Wenn Sie Ihre Client-ID mit nicht numerischen Werten für den Channel-Parameter verwenden, aktualisieren Sie sie auf einen unterstützten numerischen Wert.

Weitere Informationen finden Sie unter Berichterstellung für die Google Maps Platform.

Signaturparameter für Webdienste entfernen

Für die folgenden Webdienst-APIs ist der Signaturparameter nicht erforderlich, wenn Sie mit einem API-Schlüssel darauf zugreifen. Entfernen Sie den Signaturparameter nur aus Ihren API-Anfragen.

  • Directions API (Legacy)
  • Distance Matrix API (Legacy)
  • Geocoding API
  • Elevation API
  • Time Zone API

Weitere Informationen finden Sie unter Premiumoption – Übersicht.

Signatur-Secret für Imagery APIs

Für die Maps Static API und die Street View Static API ist weiterhin der Signaturparameter erforderlich. Für Testzwecke werden eine kleine Anzahl von Anfragen ohne Signatur akzeptiert. Sobald jedoch der Schwellenwert in Ihrer Produktionsumgebung erreicht wird, schlagen sie fehl. Ersetzen Sie Ihr Signatur-Secret für die Client-ID durch das für den API-Schlüssel. Sie können denselben Signaturalgorithmus verwenden, müssen aber ein anderes Signatur-Secret verwenden. Weitere Informationen finden Sie unter Digitale Signatur verwenden.

Traffic der Client-ID beobachten

Bestätigen Sie nach der Bereitstellung, dass Ihr Traffic erfolgreich migriert wurde mit den Cloud Console-Dashboards. Sie werden einen Rückgang des Client-ID-Traffics feststellen, der im Dashboard im Format „project_number:123456“ angezeigt wird, wenn Sie nach Anmeldedaten gruppieren.

Client-ID pausieren

Wir empfehlen Entwicklern dringend, Client-IDs nach der Migration zu pausieren. So schützen Sie Ihre Anmeldedaten vor unbeabsichtigtem Traffic und bestätigen, dass die verbleibende Nutzung Ihrer Client-ID nicht kritisch ist (z. B. Tests, Caches, Bots usw.) und Fehler zurückgeben kann, ohne geschäftliche Auswirkungen zu haben. Sie können Ihre Client-ID in der Cloud Console pausieren. Weitere Informationen finden Sie unter Authentifizierung für die Premiumoption.

Fehlerbehebung

Wie können wir feststellen, ob unsere Anfrage fehlschlägt?

Sie können Ihre Fehlerstatistiken in den Diagrammen für Antwortcodes prüfen.

Fehler ApiNotActivatedMapError oder REQUEST_DENIED

Der Fehler ApiNotActivatedMapError oder REQUEST_DENIED wird angezeigt, wenn Sie den Dienst in Ihrem Cloud-Projekt nicht aktiviert haben. Folgen Sie der Anleitung, um den Dienst zu aktivieren.

Fehler RefererNotAllowedMapError

Der Fehler „RefererNotAllowedMapError“ wird angezeigt, wenn Ihre Quelldomain nicht zu Ihrem API-Schlüssel hinzugefügt wurde. Prüfen Sie den Abschnitt „API-Schlüssel sichern“ und fügen Sie Ihre Domain zum API-Schlüssel hinzu.

Fehler OverQuotaMapError oder OVER_QUERY_LIMIT

Der Fehler OverQuotaMapError oder OVER_QUERY_LIMIT wird angezeigt, wenn Ihr konfiguriertes Kontingent nicht ausreicht, um Ihren Traffic abzudecken. Prüfen Sie den Abschnitt „Kontingenteinstellungen überprüfen“ und passen Sie Ihr Kontingent entsprechend an.

Fehler „Requests to this API must be over SSL“

Wenn Sie die folgende Fehlermeldung erhalten, aktualisieren Sie Ihre API-Anfragen von „http://“ zu „https://“.

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}