Anleitung zur Client-ID-Migration

Übersicht

Führen Sie dazu die folgenden Schritte durch:

1. Aktuelle Client-ID-Nutzung prüfen
2. API-Schlüssel vorbereiten
3. Kontingenteinstellungen überprüfen
4. Code aktualisieren
5. Client-ID-Traffic beobachten
6. Client-ID pausieren
7. Temporäre Reaktivierung der Client-ID per Selfservice

Aktuelle Client-ID-Nutzung 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 Client-IDs informiert. Diese Informationen finden Sie auch in der Benachrichtigungs-E-Mail.

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

Liste der Maps Platform-Dienste:

1. Öffnen Sie in der Cloud Console die Seite „Messwerte“.
2. Filtern Sie Ihre 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 Ihre 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:
   • FAQs zur Portalmigration
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.
   • Sie können alle vorhandenen API-Schlüssel im Cloud-Projekt wiederverwenden.
   • Sie können mehrere API-Schlüssel aus demselben Cloud-Projekt verwenden, z. B. um den Traffic für jeden Maps Platform-Dienst zu trennen oder um den Traffic von verschiedenen Plattformen (Browser, mobile App usw.) zu trennen. Im Sicherheitsleitfaden finden Sie Best Practices für die API-Schlüsselverwaltung.

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.

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 Ihre Nutzung mit den folgenden Einstellungen:
     • Gruppiert nach: API-Methode
     • Anmeldedaten: Wählen Sie nur „project_number:<numerische Kennung>“ aus.
   • In der Grafik „Traffic nach API-Methode“ sehen Sie dann eine Liste der Methodennamen mit dem jeweiligen Traffic.

• Wenn Sie diese API-Methoden nicht verwenden, müssen Sie sich keine Gedanken über die Kontingenteinstellungen machen, da Ihr Client-ID-Traffic bereits Ihr Projektkontingent verbraucht.
• Kontingentnutzung der Client-ID schätzen
  • Prüfen Sie für jeden Dienst sowohl die Granularität pro Sekunde als auch pro Tag.
  • Grafik „Pro Sekunde“: Multiplizieren Sie den Spitzen-Traffic mit 60, um den zusätzlichen Kontingentbedarf pro Minute zu ermitteln.
  • Grafik „Pro Tag“: Der Spitzen-Traffic sollte dem zusätzlichen Kontingentbedarf 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

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 pro Channel verfolgen, indem Sie den Channel-Parameter in Ihren API-Anfragen angeben. API-Schlüssel unterstützen für den Channel-Parameter nur numerische Werte. 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.

Signaturschlüssel für Imagery APIs

Für die Maps Static API und die Street View Static API ist weiterhin der Signaturparameter erforderlich. Sie akzeptieren für Testzwecke eine kleine Anzahl von Anfragen ohne Signatur, aber sie schlagen fehl, sobald der Schwellenwert in Ihrer Produktion erreicht wird. Ersetzen Sie Ihren Signaturschlüssel für die Client-ID durch den für den API-Schlüssel. Sie können denselben Signaturalgorithmus verwenden, aber Sie benötigen einen anderen Signaturschlüssel. Weitere Informationen finden Sie unter Digitale Signatur verwenden.

Client-ID-Traffic 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.

Temporäre Reaktivierung der Client-ID per Selfservice

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

Wenn Sie den Zugriff dringend wiederherstellen müssen, können Sie die Reaktivierung per Selfservice über die Google Cloud Console durchführen:

• 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 neben dem Eintrag auf das Symbol zum Aufheben der Pausierung, 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 mit den folgenden Informationen an das Google Maps Platform-Supportteam:

• Client-ID
• Spezifischer Anwendungsfall
• Geplantes Migrationsdatum
• Folgenabschätzung für das Unternehmen

Bericht zur Client-ID-Nutzung aus Abrechnungsberichten

Abrechnungsberichte statt Projektmesswerte 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 bis 2 Tagen, bieten aber den Vorteil, dass sie Nutzungs- und Kostenstatistiken für mehr als 30 Tage enthalten.

Sie können die Client-ID-Nutzung über die Google Cloud Console beobachten. Gehen Sie dazu so vor:

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 Unterabrechnungskonto auszuwählen.
3. Gruppieren Sie die Berichtsdaten nach dem Labelschlüssel goog-maps-api-key-suffix. Dieses Label zeigt die letzten Zeichen eines API-Schlüssels.
4. Identifizieren Sie den Client-ID-Traffic, indem Sie nach Einträgen suchen, bei denen das Label goog-maps-api-key-suffix fehlt oder leer ist. Dieses Label wird für Client-ID-Anfragen nicht ausgefüllt.
5. Ignorieren Sie Artikelnummern, die nicht mit API-Anfragen verknüpft werden sollen, z. B. Abo-Artikelnummern.

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