Fehlermeldungen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite werden die Fehlermeldungen beschrieben, die von der Maps JavaScript API zurückgegeben werden können. Die Maps JavaScript API schreibt Fehler- und Warnmeldungen in die JavaScript-Konsole. Außerdem können bestimmte Fehlerbedingungen auftreten, die dazu führen, dass eine dunkle Karte mit einem Wasserzeichen angezeigt wird.

API-Schlüssel und Abrechnungsfehler

Fehlerbehebung

Unter bestimmten Umständen wird eine dunkle Karte oder ein auszuschließendes Street View-Bild mit dem Text „Nur für Entwicklungszwecke“ angezeigt. Das weist in der Regel auf Probleme mit einem API-Schlüssel oder der Abrechnung hin. Damit Sie Google Maps Platform-Produkte nutzen können, muss die Abrechnung für Ihr Konto aktiviert sein und alle Anfragen müssen einen gültigen API-Schlüssel enthalten. Hilfe bei der Suche nach Fehlermeldungen finden Sie im Abschnitt Fehler im Browser prüfen.

Der folgende Ablauf hilft Ihnen bei der Fehlerbehebung.

Maps JavaScript API-Fehlercodes für Entwickler und Websiteinhaber

In den folgenden Tabellen sind die von der Maps JavaScript API zurückgegebenen Fehlercodes mit einer Beschreibung der Ursache und einer Lösung des Problems aufgeführt. Hilfe bei der Suche nach Fehlermeldungen finden Sie im Abschnitt Fehler im Browser prüfen.

Fehler beim Laden der Karte

Wenn beim Laden der Maps JavaScript API ein Fehler auftritt, finden Sie in der folgenden Tabelle Erläuterungen zu den Fehlercodes.

Fehlercode Meldung Beschreibung
NotLoadingAPIFromGoogleMapsError Die Maps JavaScript API muss direkt von den Google-Servern heruntergeladen werden.

Das Skriptelement, über das die Maps JavaScript API geladen wird, ist nicht korrekt auf deiner Seite zu finden. Damit die API richtig funktioniert, muss sie direkt von https://maps.googleapis.com geladen werden.

Weitere Informationen finden Sie unter Maps JavaScript API laden.

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service. The Google Maps API has been disabled for this website.

Nach mehreren E-Mail-Benachrichtigungen wurde deine App aufgrund von Verstößen gegen die Nutzungsbedingungen der Google Maps Platform gesperrt. Wenn Sie Einspruch gegen die Sperrung einlegen und Ihre Implementierung prüfen lassen möchten, füllen Sie bitte dieses Formular aus. Innerhalb weniger Arbeitstage erhalten Sie eine Antwort per E-Mail.

Wenn du eine Lizenz für die Google Maps Platform-Premiumoption hast, kannst du diesen Fehler mit den Anmeldedaten für die Google Maps Platform-Premiumoption beheben. Weitere Informationen findest du unter Authentifizierung für die Premiumoption.

UnauthorizedURLForClientIdMapError This URL is not authorized to use the Google Maps Client ID provided.

Die im Skript geladene Premiumoption oder Maps APIs for Work-Client-ID ist ungültig oder abgelaufen oder die aktuelle Adresse, über die die Maps JavaScript API geladen wird, wurde der Liste der autorisierten URLs nicht hinzugefügt.

Weitere Informationen findest du unter Autorisierte URLs registrieren.

Maps JavaScript API-Fehlercodes

Wenn in der Chrome JavaScript Console, in der Firefox Web Console oder in einem gleichwertigen Tool in deinem Browser ein Fehler auftritt, findest du in der folgenden Tabelle Erläuterungen zu den Fehlercodes.

Die Maps JavaScript API gibt sowohl Fehler als auch Warnungen zurück. Ein Fehler weist auf ein schwerwiegendes Problem hin, das beim Laden der Maps JavaScript API aufgetreten ist. Die Seite kann die API nicht richtig laden und die API funktioniert dort nicht. Eine Warnung ist eine ergänzende Nachricht zum Laden der Maps JavaScript API. In der Warnung werden die möglichen Ursachen eines Fehlers beschrieben oder mögliche Probleme in Ihrem Code vorgeschlagen, durch die die Maps JavaScript API geladen wird. Wenn Sie nur Warnungen ohne Fehler erhalten, funktioniert die API auf dieser Seite korrekt. Wir empfehlen jedoch, diese potenziellen Probleme ebenfalls zu beheben.

Entwickler-Fehlercode Typ Beschreibung
ApiNotActivatedMapError Fehler

Die Maps JavaScript API ist in Ihrem API-Projekt nicht aktiviert. Möglicherweise müssen Sie die Maps JavaScript API in der Google Cloud Console unter „APIs“ aktivieren.

Klicken Sie auf die Schaltfläche unten, um die Maps JavaScript API für Ihr Projekt zu aktivieren.
Weitere Informationen

ApiTargetBlockedMapError Fehler

Dieser API-Schlüssel ist nicht zur Verwendung dieses Dienstes oder dieser API autorisiert. Prüfen Sie in der Google Cloud Console die Einstellungen für die API-Einschränkungen Ihres API-Schlüssels, um sicherzustellen, dass alle benötigten APIs und Dienste in der Liste der aktivierten APIs korrekt angegeben sind.

Siehe API-Schlüssel in der Cloud Console. Weitere Informationen findest du unter Best Practices für die API-Sicherheit.

DeletedApiProjectMapError Fehler

Ihr API-Projekt wurde möglicherweise aus der Cloud Console gelöscht. Prüfen Sie das Projekt, für das Sie den API-Schlüssel generiert haben, der im JavaScript API-Ladeprogramm enthalten ist. Sie können ein neues API-Projekt erstellen und in der Cloud Console einen neuen Schlüssel abrufen.

Wenn Sie ein neues Projekt erstellen und einen API-Schlüssel dafür abrufen möchten, klicken Sie auf die Schaltfläche unten.
Weitere Informationen

ClientBillingNotEnabledMapError Fehler

Sie haben die Abrechnung für Ihr Projekt nicht aktiviert. Sie müssen die Abrechnung für das Google Cloud-Projekt aktivieren, das mit dieser Client-ID verknüpft ist.

BillingNotEnabledMapError Fehler

Sie haben die Abrechnung für Ihr Projekt nicht aktiviert, was diesen Fehler verursacht. Sie müssen die Abrechnung für das Google Cloud-Projekt hier aktivieren.

Weitere Informationen

ExpiredKeyMapError Fehler

Der API-Schlüssel im Skriptelement, über das die API geladen wird, ist abgelaufen oder wird vom System nicht erkannt. Dieser Fehler kann nach dem Erstellen eines neuen API-Schlüssels auftreten, wenn Sie versuchen, ihn zu verwenden, bevor er vom System erkannt wird. Warten Sie einige Minuten und versuchen Sie es noch einmal. Andernfalls müssen Sie in der Cloud Console einen neuen API-Schlüssel generieren.

Wenn Sie einen API-Schlüssel anfordern möchten, klicken Sie auf die Schaltfläche unten.
Jetzt starten

InvalidClientIdMapError Fehler

Die Client-ID im Skriptelement, das die API lädt, ist ungültig oder abgelaufen. Achte darauf, dass du deine Client-ID korrekt verwendest. Die Client-ID muss mit dem Präfix "gme-" beginnen. Wenn dieser Fehler angezeigt wird, obwohl du deine Client-ID korrekt verwendest, ist die Client-ID möglicherweise abgelaufen. Wenden Sie sich in diesem Fall an Ihren Google Account Manager.

Wenn du keine Premiumoption oder Maps APIs for Work-Lizenz hast, musst du anstelle des Parameters client einen key-Parameter mit deinem API-Schlüssel verwenden.

Weitere Informationen findest du unter Authentifizierung für die Premiumoption.

InvalidKeyMapError Fehler

Der API-Schlüssel im Skriptelement, das die API lädt, wurde nicht gefunden. Stellen Sie sicher, dass Sie einen korrekten API-Schlüssel verwenden. Sie können in der Cloud Console einen neuen API-Schlüssel generieren.

Wenn Sie einen API-Schlüssel anfordern möchten, klicken Sie auf die Schaltfläche unten.
Jetzt starten

MalformedCredentialsMapError Fehler

Ihre Anwendung verwendet ein nicht unterstütztes URI-Schema. Überprüfen Sie, ob die Anwendung ein gültiges URI-Format gemäß RFC 3986 verwendet.

MissingKeyMapError Fehler

Beim Skriptelement zum Laden der API fehlt der erforderliche Authentifizierungsparameter.

Wenn du die Standard-Maps JavaScript API verwendest, musst du einen key-Parameter mit einem gültigen API-Schlüssel verwenden. Weitere Informationen findest du unter Erste Schritte mit der Google Maps Platform.

Wenn du die Premiumoption nutzt, musst du entweder einen client-Parameter mit deiner Client-ID oder einen key-Parameter mit einem gültigen API-Schlüssel verwenden. Weitere Informationen findest du unter API-Schlüssel und Client-IDs.

Wenn Sie NICHT der Websiteinhaber sind, können Sie diesen Fehler nicht beheben. Sie sollten jedoch den Inhaber der Website nach Möglichkeit benachrichtigen.

ProjectDeniedMapError Fehler

Ihre Anforderung wurde nicht abgeschlossen. Möglicherweise finden Sie in der Cloud Console weitere Details zum Fehler.

Siehe Cloud Console.

RefererDeniedMapError Fehler

Nach mehreren E-Mail-Benachrichtigungen wurde deine App aufgrund von Verstößen gegen die Nutzungsbedingungen der Google Maps Platform gesperrt. Wenn Sie Einspruch gegen die Sperrung einlegen und Ihre Implementierung prüfen lassen möchten, füllen Sie bitte dieses Formular aus. Innerhalb weniger Arbeitstage erhalten Sie eine Antwort per E-Mail.

RefererNotAllowedMapError Fehler

Die aktuelle URL, über die die Maps JavaScript API geladen wird, wurde der Liste der zulässigen Verweis-URLs nicht hinzugefügt. Prüfe die Verweiseinstellungen deines API-Schlüssels in der Cloud Console.

Siehe Maps JavaScript API und API-Schlüssel abrufen.

OverQuotaMapError Fehler

Die Anzahl der Anfragen hat die Nutzungslimits für die Maps JavaScript API überschritten. Die Anfragen Ihrer App funktionieren nach dem nächsten Zurücksetzen des Tageskontingents wieder.

Wenn Sie NICHT der Websiteinhaber sind, können Sie den Fehler nicht beheben. Sie sollten jedoch den Inhaber der Website nach Möglichkeit benachrichtigen.

Weitere Informationen findest du in der Anleitung zu Nutzungslimits. Auf dieser Seite wird auch erläutert, wie Sie höhere Nutzungslimits erreichen können.

ApiProjectMapError Fehler

Der bereitgestellte API-Schlüssel oder das API-Projekt, mit dem er verknüpft ist, konnte nicht aufgelöst werden. Dieser Fehler kann vorübergehend sein. Wenn diese Fehlermeldung weiterhin angezeigt wird, müssen Sie möglicherweise einen neuen API-Schlüssel anfordern oder ein neues API-Projekt erstellen.

Weitere Informationen findest du unter Erste Schritte mit der Google Maps Platform.

ClientIdLooksLikeCryptoKey Warnung

Möglicherweise haben Sie im Parameter client einen kryptografischen Schlüssel angegeben. Wenn du eine Premiumoption oder Maps APIs for Work-Lizenz hast, gib bitte deine Client-ID als client-Parameter an. Du musst deinen kryptografischen Schlüssel nicht für die Maps JavaScript API verwenden.

Weitere Informationen findest du in der Anleitung zu Client-IDs für Kunden mit Premiumoption und Maps APIs for Work.

ClientIdLooksLikeKey Warnung

Möglicherweise haben Sie im Parameter client einen API-Schlüssel angegeben. Wenn du eine Premiumoption oder Maps APIs for Work-Lizenz hast, gib bitte deine Client-ID als client-Parameter an. Wenn du die Google Maps Platform-Premiumoption hast, kannst du den Parameter client oder key verwenden. Wenn du keine Lizenzen hast, musst du einen key-Parameter anstelle eines client -Parameters verwenden.

Weitere Informationen findest du unter Authentifizierung für die Premiumoption.

InvalidChannel Warnung

Möglicherweise haben Sie einen ungültigen channel-Parameter angegeben. Der Kanal muss ein alphanumerischer ASCII-String sein, der einen Punkt (.), einen Unterstrich (_) und einen Bindestrich (-) enthält. Gib unbedingt einen gültigen channel-Parameter an.

Weitere Informationen findest du unter Berichterstellung | Google Maps Platform-Premiumoption.

InvalidClientId Warnung

Der Parameter client enthält anscheinend keine richtige Client-ID. Eine Client-ID muss mit „gme-"“ beginnen.

Weitere Informationen findest du unter Authentifizierung für die Premiumoption.

InvalidKey Warnung

Der API-Schlüssel im Skriptelement, mit dem die API geladen wird, scheint nicht korrekt zu sein. Stellen Sie sicher, dass Sie einen korrekten API-Schlüssel verwenden. Sie können einen neuen API-Schlüssel in der Cloud Console generieren.

Wenn Sie einen API-Schlüssel anfordern möchten, klicken Sie auf die Schaltfläche unten.
Jetzt starten

InvalidVersion Warnung

Sie haben offensichtlich eine unzulässige Versionsnummer in Ihrem Skriptelement angegeben. Stellen Sie sicher, dass Sie eine korrekte Versionsnummer verwenden.

Weitere Informationen finden Sie unter Versionsverwaltung | Google Maps JavaScript API.

KeyLooksLikeClientId Warnung Möglicherweise hast du eine Client-ID als key-Parameter angegeben. Wenn du eine Premiumoption oder eine Maps APIs for Work-Lizenz hast, gib bitte deine Client-ID als client-Parameter und nicht als key-Parameter an. Wenn du die Google Maps Platform-Premiumoption hast, kannst du den Parameter client oder key verwenden. Wenn du keine Lizenzen hast, musst du einen key-Parameter anstelle eines client -Parameters verwenden.

Weitere Informationen findest du unter Authentifizierung für die Premiumoption.

KeyLooksLikeCryptoKey Warnung

Möglicherweise haben Sie einen kryptografischen Schlüssel oder ein Signatur-Secret als key-Parameter angegeben. Wenn du eine Premiumoption oder eine Maps APIs for Work-Lizenz hast, gib bitte deine Client-ID als client-Parameter an und entferne den key-Parameter aus deinem Skriptelement. Der kryptografische Schlüssel ist für die Maps JavaScript API nicht erforderlich. Wenn du die Google Maps Platform-Premiumoption hast, kannst du den Parameter client oder key verwenden. Wenn Sie keine Lizenzen haben, können Sie in der Cloud Console einen API-Schlüssel abrufen.

Weitere Informationen findest du unter Client-ID beim Laden der API angeben.

KeyLooksLikeProjectNumber Warnung

Möglicherweise haben Sie eine Projektnummer als key-Parameter angegeben. Stellen Sie sicher, dass Sie einen korrekten API-Schlüssel verwenden. Sie können einen neuen API-Schlüssel in der Cloud Console generieren.

Informationen zum Abrufen eines API-Schlüssels

NoApiKeys Warnung

Das Skriptelement zum Laden der API verfügt über keinen API-Schlüssel. Gib als Parameter key einen gültigen API-Schlüssel an. Sie können einen neuen API-Schlüssel in der Cloud Console generieren.

Klicke unten auf die Schaltfläche, um einen API-Schlüssel anzufordern.
Jetzt starten

Wenn du die Maps JavaScript API aus dem verworfenen Pfad der Version 2 lädst, wird die Warnung NoApiKeys angezeigt, auch wenn du den Parameter key angegeben hast. Bitte lesen Sie den Upgrade-Leitfaden für Version 2 zu Version 3 und migrieren Sie Ihre Anwendung zu Version 3 der Maps JavaScript API.

RetiredVersion Warnung

Sie haben offensichtlich eine abgelaufene Version in Ihrem Skriptelement angegeben. Bitte aktualisieren Sie Ihre Anwendung, sodass Sie eine der verfügbaren Versionen verwenden.

Weitere Informationen finden Sie unter Versionsverwaltung | Google Maps JavaScript API.

SensorNotRequired Warnung

Der Parameter sensor ist für die Maps JavaScript API nicht mehr erforderlich. Die Maps JavaScript API wird dadurch nicht ordnungsgemäß ausgeführt. Wir empfehlen jedoch, den Parameter sensor aus dem Skriptelement zu entfernen.

SignatureNotRequired Warnung

Der Parameter signature ist für die Maps JavaScript API nicht erforderlich. Die Maps JavaScript API wird zwar nicht ordnungsgemäß ausgeführt, kann aber zu Sicherheitsrisiken führen. Bitte entfernen Sie die Angabe aus Ihrem Skriptelement.

SignedInNotSupported Warnung

Der Parameter signed_in wurde eingestellt und wird in der verwendeten Version der Maps JavaScript API nicht mehr unterstützt. Die Maps JavaScript API funktioniert dadurch zwar nicht, aber sie kann sich ändern, wenn du die Funktionen für angemeldete Nutzer verwendest.

UrlAuthenticationCommonError Fehler

Es ist ein Fehler aufgetreten, der nicht in die anderen Kategorien auf dieser Seite passt. Möglicherweise ist er auf ein vorübergehendes Problem zurückzuführen. Versuchen Sie es nach einer kurzen Verzögerung noch einmal. Wenn das Problem dadurch nicht behoben wird, lies dir den Entwicklerleitfaden durch, um sicherzustellen, dass die Anfrage das richtige Format hat.

Überprüfen von Fehlern im Browser

Die Maps JavaScript API schreibt Fehlermeldungen in window.console. In diesem Abschnitt wird erläutert, wie Sie die Ausgabe von window.console in Google Chrome prüfen können. Wenn Sie andere Browser verwenden, lesen Sie die Entwicklerdokumentation für Ihren Browser. Dies ist eine Liste von Tools, mit denen Sie die window.console-Ausgabe in einigen anderen Browsern prüfen können.

In Chrome können Sie die JavaScript Console verwenden, um die window.console-Ausgabe so zu prüfen.

  1. Wählen Sie zum Öffnen der Entwicklertools das Menüsymbol > Weitere Tools > Entwicklertools aus.
  2. Zum Öffnen der JavaScript-Konsole drücken Sie die ESC-Taste auf Ihrer Tastatur. Die ESC-Taste dient als Umschalttaste für die JavaScript-Konsole. Wenn Sie die Konsole schließen, drücken Sie noch einmal die Esc-Taste, um sie zu öffnen.

Wenn beim Laden der Maps JavaScript API Fehler oder Warnungen aufgetreten sind, werden sie in der Konsole als eine oder mehrere Zeilen angezeigt. Eine Fehler- bzw. Warnmeldung besitzt das folgende Format:

Google Maps API error: [ERROR CODE] [Link to API document]
oder
Google Maps API warning: [ERROR CODE] [Link to API document]

In der Tabelle der Fehlercodes finden Sie den Fehlercode in der Fehlermeldung. Die Details zur Fehlermeldung finden Sie auch im API-Dokument, das mit der Nachricht verknüpft ist.

Hinweis: Sie können programmatisch auf Authentifizierungsfehler achten.

Umgang mit nicht unterstützten Browsern

Prüfen Sie, ob die von Ihnen verwendete Browserversion derzeit von der Maps JavaScript API unterstützt wird.

Wenn der Code immer noch nicht funktioniert

Brendan Kenny und Mano Marks beschreiben in diesem Video einige häufige Fehler und zeigen Ihnen, wie Sie diese beheben können.

  • Suchen Sie nach Tippfehlern. Beachte, dass bei JavaScript zwischen Groß- und Kleinschreibung unterschieden wird.
  • Sehen Sie sich die Grundlagen an. Einige der häufigsten Probleme treten bei der ersten Kartenerstellung auf. Beispiele:
    • Prüfen Sie, ob Sie in den Kartenoptionen die Properties zoom und center angegeben haben.
    • Vergewissern Sie sich, dass Sie ein div-Element deklariert haben, in dem die Karte auf dem Bildschirm angezeigt wird.
    • Stellen Sie sicher, dass für das Element <div> für die Karte eine Höhe definiert ist. div-Elemente werden standardmäßig mit einer Höhe von 0 erstellt und sind daher nicht sichtbar.
    In unseren Beispielen finden Sie eine Referenzimplementierung.
  • Verwende einen JavaScript-Debugger, um Probleme zu identifizieren, wie beispielsweise den in den Chrome-Entwicklertools verfügbaren. Suchen Sie zunächst in der JavaScript-Konsole nach Fehlern.
  • Poste Fragen auf Stack Overflow. Richtlinien zum Posten großer Fragen finden Sie auf der Supportseite.