Anleitung zur Client-ID-Migration

Übersicht

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 Ihrer Client-ID im Blick behalten
6. Client-ID pausieren
7. Vorübergehende Reaktivierung der Client-ID per Selfservice

Aktuelle Nutzung der Client-ID prüfen

Listen Sie vor Beginn der Migration Folgendes auf:

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

Google hat betroffene Kunden im Mai 2025 per E-Mail über die Einstellung der Client-ID benachrichtigt. Diese Informationen finden Sie auch in der E‑Mail-Benachrichtigung.

In der Cloud Console können Sie auf der Seite Google Maps-Messwerte den aktuellen Status der Nutzung Ihrer Client-ID einsehen.

Liste der Google 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 auf Anwendungen, Websites oder Systeme:

In der Cloud Console werden keine Details zu Ihren Anwendungen, Websites oder Systemen angezeigt. Sie können jedoch Hinweise auf die Quellen des 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öchten.

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 wie zuvor mit Ihrer Client-ID. 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:
   • FAQs zur Portalmigration
2. Ihr Cloud-Projekt muss mit einem offenen Rechnungskonto verknüpft sein.
3. Erstellen Sie einen neuen API-Schlüssel für die Migration der Client-ID.
   • Sie können alle vorhandenen API-Schlüssel im Cloud-Projekt wiederverwenden.
   • Sie können mehrere API-Schlüssel aus demselben Cloud-Projekt verwenden, um beispielsweise den Traffic für die einzelnen Maps Platform-Dienste oder den Traffic von verschiedenen Plattformen (Browser, mobile App usw.) zu trennen. Im Sicherheitsleitfaden finden Sie Best Practices für die Verwaltung von API-Schlüsseln.

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. für Websites, IP-Adressen, Android-Apps oder iOS-Apps.
• Legen Sie API-Einschränkungen für Ihren API-Schlüssel fest.

Weitere Informationen finden Sie unter Google Maps Platform – Leitlinie zur Sicherheit.

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

Kontingenteinstellungen prüfen

Prüfen Sie, ob die erwarteten Kontingenteinstellungen für Ihr Cloud-Projekt 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 „Google Maps-Kontingente“ einsehen 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 API-Schlüsselmigration.

Prüfen Sie Ihre aktuelle Kontingentkonfiguration und ‑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:<numerical identifier>“ aus.
   • Anschließend wird im Diagramm „Traffic nach API-Methode“ eine Liste der Methodennamen mit dem zugehörigen Traffic angezeigt.

• Wenn Sie diese API-Methoden nicht verwenden, müssen Sie sich keine Gedanken über Kontingenteinstellungen machen, da der Traffic Ihrer Client-ID bereits Ihr Projektkontingent verbraucht.
• Kontingentnutzung für Client-ID schätzen
  • Sehen Sie sich für jeden Dienst sowohl die Granularität „Pro Sekunde“ als auch „Pro Tag“ an.
  • 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 Kontingent pro Tag entsprechen.
• Passen Sie Ihr 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

Clientparameter durch Schlüsselparameter ersetzen

Aktualisieren Sie die Authentifizierungsdaten in Ihren ausgehenden GMP API-Aufrufen von URL&client={value} auf URL&key={value}. Wenn Ihre Apps HTTP für den Zugriff auf GMP-Dienste verwenden, aktualisieren Sie sie so, dass sie HTTPS verwenden.

Channel-Parameter für Berichte aktualisieren

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

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

Signaturparameter für Webservices entfernen

Für die folgenden Web Service APIs ist der Signaturparameter nicht erforderlich, wenn Sie mit einem API-Schlüssel darauf zugreifen. Entferne nur den Signaturparameter aus deinen API-Anfragen.

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

Weitere Informationen finden Sie in der Übersicht über die Premiumoption.

Signatur-Secret für Imagery APIs

Für die Maps Static API und die Street View Static API ist der Signaturparameter weiterhin erforderlich. Sie akzeptieren zu Testzwecken eine kleine Anzahl von Anfragen ohne Signatur, schlagen aber fehl, sobald der Schwellenwert in Ihrer Produktion erreicht ist. Ersetzen Sie das Signierungsgeheimnis 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 Ihrer Client-ID im Blick behalten

Prüfen Sie nach der Bereitstellung in den Cloud Console-Dashboards, ob der Traffic erfolgreich migriert wurde. Sie werden einen Rückgang des Client-ID-Traffics feststellen, der auf dem 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 werden Ihre Anmeldedaten vor unbeabsichtigtem Traffic geschützt und Sie können bestätigen, dass die verbleibende Nutzung Ihrer Client-ID nicht kritisch ist (z. B. Tests, Caches, Bots usw.) und Fehler zurückgeben kann, ohne dass sich dies auf Ihr Unternehmen auswirkt. Sie können Ihre Client-ID in der Cloud Console pausieren. Weitere Informationen finden Sie unter Authentifizierung für die Premiumoption.

Vorübergehende Reaktivierung der Client-ID per Selfservice

Da Google Maps Platform-Client-IDs im Mai 2026 in die Phase der schrittweisen Einstellung eingetreten sind, ist die Verfügbarkeit der Dienste nicht mehr gewährleistet. Der Zugriff wird im Rahmen der geplanten Beendigung des Dienstes regelmäßig eingeschränkt. Der Dienst wird in der Regel innerhalb weniger Stunden automatisch wiederhergestellt. Sie können den Zugriff jedoch auch manuell reaktivieren, wenn eine sofortige Wiederherstellung erforderlich ist.

Wenn Sie den Zugriff dringend wiederherstellen möchten, können Sie die Reaktivierung selbst über die Google Cloud Console vornehmen:

• Rufen Sie die Google Maps Platform-Seite „Anmeldedaten“ auf.
• Suchen Sie nach dem Cloud-Projekt, das mit Ihrer Client-ID verknüpft ist.
• Klicken Sie ganz rechts im Eintrag auf das Symbol zum Fortsetzen, um den Dienst wiederherzustellen.

Wenn Sie nicht schnell zu API-Schlüsseln migrieren können und vorübergehend von weiteren Unterbrechungen ausgenommen werden möchten, wenden Sie sich bitte an das Google Maps Platform-Supportteam und geben Sie die folgenden Informationen an:

• Client-ID
• Spezifischer Anwendungsfall
• Angestrebtes Migrationsdatum
• Geschäftsauswirkungsanalyse

Bericht zur Client-ID-Nutzung – aus Abrechnungsberichten

Die Abrechnungsberichte anstelle von Projektmesswerten zu prüfen, kann für Nutzer nützlich sein, die keinen Zugriff auf Projektmesswerte haben, z. B. Abrechnungsadministratoren (insbesondere Maps Platform-Partner). Abrechnungsberichte haben zwar eine Latenz von 1–2 Tagen, bieten aber den Vorteil, dass sie Nutzungs- und Kostendaten für mehr als 30 Tage enthalten.

So können Sie die Nutzung der Client-ID über die Google Cloud Console überwachen:

1. Rufen Sie in der Google Cloud Console die Seite Abrechnung > Berichte auf.
2. Optional (nur für Partner): Wenden Sie einen Filter an, um das gewünschte Unter-Rechnungskonto auszuwählen.
3. Gruppieren Sie die Berichtsdaten nach dem Label-Schlüssel goog-maps-api-key-suffix. Dieses Label zeigt die letzten Zeichen eines API-Schlüssels an.
4. Traffic mit Client-ID erkennen Sie an Einträgen, in denen das Label goog-maps-api-key-suffix fehlt oder leer ist, da es für Anfragen mit Client-ID nicht ausgefüllt wird.
5. Ignorieren Sie Artikelnummern, die nicht mit API-Anfragen verknüpft werden sollen, z. B. Abonnement-Artikelnummern.

Fehlerbehebung

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

Sie können Ihre Fehlerstatistiken in den Diagrammen zu Antwortcodes einsehen.

ApiNotActivatedMapError- oder REQUEST_DENIED-Fehler

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.

RefererNotAllowedMapError Fehler

Der Fehler „RefererNotAllowedMapError“ wird angezeigt, wenn Ihre Quelldomain nicht zu Ihrem API-Schlüssel hinzugefügt wurde. Sehen Sie sich den Abschnitt „API-Schlüssel schützen“ an und fügen Sie Ihre Domain dem API-Schlüssel hinzu.

OverQuotaMapError- oder OVER_QUERY_LIMIT-Fehler

Sie sehen OverQuotaMapError oder OVER_QUERY_LIMIT, wenn Ihr konfiguriertes Kontingent nicht ausreicht, um Ihren Traffic abzudecken. Sehen Sie sich den Abschnitt „Kontingenteinstellungen überprüfen“ an und passen Sie Ihr Kontingent entsprechend an.

Fehler „Requests to this API must be over SSL“ (Anfragen an diese API müssen über SSL erfolgen)

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"
}