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 prüfen
4. Code aktualisieren
5. Traffic Ihrer Client-ID im Blick behalten
6. Client-ID pausieren
7. Vorübergehende Reaktivierung der Client-ID im 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 im Mai 2025 eine E‑Mail-Benachrichtigung an betroffene Kundenunternehmen gesendet, in der die Einstellung der Client-ID angekündigt wurde. Diese Informationen finden Sie auch in der E‑Mail-Benachrichtigung.

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

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 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, erhalten 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:
   • 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 jeden Maps Platform-Dienst oder den Traffic von verschiedenen Plattformen (Browser, mobile App usw.) zu trennen. Best Practices für die Verwaltung von API-Schlüsseln finden Sie im Sicherheitsleitfaden.

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 Leitfaden zur Sicherheit der 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 Referrer Ihrer Client-ID zu den API-Schlüsseleinschränkungen migrieren. Die Liste der vertrauenswürdigen Referrer finden Sie in der Cloud Console.

Kontingenteinstellungen prüfen

Prüfen Sie, ob die Kontingenteinstellungen für Ihr Cloud-Projekt Ihren Erwartungen entsprechen. 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“ prüfen und anpassen.

Weitere Informationen zu Berichten zum Kontingent

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

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

Prü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 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
  • 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 Bedarf an Kontingent pro Minute zu ermitteln.
  • Diagramm „Pro Tag“: Der Spitzenwert sollte dem zusätzlichen Kontingent pro Tag entsprechen.
• Kontingent für die entsprechenden Maps Platform-Dienste anpassen
  • Passen Sie das Kontingent für die entsprechenden Dienste basierend auf dem Methodennamen 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 Anwendungen HTTP für den Zugriff auf GMP-Dienste verwenden, aktualisieren Sie sie, damit sie HTTPS verwenden.

Channelparameter 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 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 Web Service APIs ist der Signaturparameter nicht erforderlich, wenn Sie mit einem API-Schlüssel darauf zugreifen. Entfernen Sie nur den Signaturparameter 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 der Signaturparameter weiterhin erforderlich. Sie akzeptieren zu Testzwecken eine kleine Anzahl von Anfragen ohne Signatur, schlagen aber fehl, sobald der Grenzwert in Ihrer Produktion erreicht ist. Ersetzen Sie das 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 Ihrer Client-ID im Blick behalten

Prüfen Sie nach der Bereitstellung in den Cloud Console-Dashboards, ob der Traffic erfolgreich migriert wurde. Der Traffic Ihrer Client-ID wird abnehmen. Er wird im Dashboard im Format „project_number:123456“ angezeigt, 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. Außerdem können Sie so bestätigen, dass die verbleibende Nutzung Ihrer Client-ID nicht kritisch ist (z. B. Tests, Caches, Bots usw.) und Fehler zurückgegeben werden können, 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 im Selfservice

Da die Google Maps Platform-Client-IDs im Mai 2026 eingestellt werden, ist die Dienstverfügbarkeit nicht mehr gewährleistet. Der Zugriff wird im Rahmen der geplanten Diensteinstellung 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üssen, können Sie die Reaktivierung selbst über die Google Cloud Console vornehmen:

• Rufen Sie die Google Maps Platform-Seite „Anmeldedaten“ auf.
• Suchen Sie das Cloud-Projekt, das mit Ihrer Client-ID verknüpft ist.
• Klicken Sie ganz rechts im Eintrag auf das Symbol „Pausierung aufheben“, 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
• Zieldatum für die Migration
• Bewertung der Auswirkungen auf das Unternehmen

Nutzungsbericht zur Client-ID – aus Abrechnungsberichten

Die Prüfung von Abrechnungsberichten anstelle von Projektmesswerten 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 anzeigen.

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 relevant) Wenden Sie einen Filter an, um das gewünschte Unterrechnungskonto auszuwählen.
3. Gruppieren Sie die Berichtsdaten nach dem Labelschlüssel goog-maps-api-key-suffix. In diesem Label werden die letzten Zeichen eines API-Schlüssels angezeigt.
4. Suchen Sie nach Einträgen, bei denen das Label goog-maps-api-key-suffix fehlt oder leer ist, da dieses Label für Client-ID-Anfragen nicht ausgefüllt wird.
5. Ignorieren Sie SKUs, die nicht mit API-Anfragen verknüpft werden sollen, z. B. Abo-SKUs.

Fehlerbehebung

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

Sie können Ihre Fehlerstatistiken in den Antwortcodediagrammen prüfen.

ApiNotActivatedMapError- oder REQUEST_DENIED-Fehler

Wenn Sie den Dienst in Ihrem Cloud-Projekt nicht aktiviert haben, wird der Fehler ApiNotActivatedMapError oder REQUEST_DENIED angezeigt. 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 sichern“ an und fügen Sie Ihre Domain zum API-Schlüssel hinzu.

OverQuotaMapError- oder OVER_QUERY_LIMIT-Fehler

Wenn Ihr konfiguriertes Kontingent nicht ausreicht, um Ihren Traffic abzudecken, wird OverQuotaMapError oder OVER_QUERY_LIMIT angezeigt. Sehen Sie sich den Abschnitt „Kontingenteinstellungen prüfen“ an 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://“ auf „https://“.

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

  "results" : [],

  "status" : "REQUEST_DENIED"
}