Auf der Google Maps Platform ist bald eine neue Version der Funktionen für das cloudbasierte Gestalten von Karteninhalten verfügbar. Die Aktualisierung umfasst eine neue Standardfarbvorlage und Optimierungen in Bezug auf die Nutzerfreundlichkeit der Karten. Alle Kartenstile werden im März 2025 automatisch aktualisiert. Weitere Informationen zur Verfügbarkeit und Aktivierung sind unter Neuer Kartenstil für die Google Maps Platform verfügbar.

Fehlermeldungen

Auf dieser Seite werden die Fehlermeldungen beschrieben, die von der Maps JavaScript API zurückgegeben werden können. Die Maps JavaScript API gibt Fehler- und Warnmeldungen in der JavaScript-Konsole aus. Bei bestimmten Fehlerbedingungen wird eine dunkle Karte mit einem Wasserzeichen angezeigt.

API-Schlüssel- und Abrechnungsfehler

Fehlerbehebung

Unter bestimmten Umständen werden dunkle Karten oder „negative“ Street View-Bilder ausgegeben, die mit dem Wasserzeichen „for development purposes only“ (nur für Entwicklungszwecke) versehen sind. 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. Außerdem müssen alle Anfragen einen gültigen API-Schlüssel enthalten. Informationen zur Suche nach Fehlermeldungen finden Sie im Abschnitt Fehler im Browser überprüfen.

Der folgende Ablauf hilft bei der Fehlerbehebung.

Verwenden Sie einen API-Schlüssel?

Ich bin mir nicht sicher. Wie finde ich heraus, ob ich einen API-Schlüssel verwende?

Ein API-Schlüssel wird als key-Parameter in der URL übergeben, über die die Maps JavaScript API geladen wird. So können Sie herausfinden, ob Sie einen API-Schlüssel verwenden:

Verwenden Sie die Chrome-Erweiterung Google Maps Platform API Checker. Mit ihr lässt sich prüfen, ob die lizenzierten Maps APIs auf Ihrer Website richtig implementiert werden.
Wenn Sie zum Laden der Maps JavaScript API eine Bibliothek oder ein Plug-in verwenden, prüfen Sie die entsprechenden Einstellungen und suchen Sie nach einer Option für API-Schlüssel.
Sehen Sie sich die Fehler im Browser an. Wenn die folgenden Meldungen angezeigt werden, verwenden Sie den API-Schlüssel nicht richtig:

Google Maps JavaScript API-Warnung: NoApiKeys
Google Maps JavaScript API-Fehler: MissingKeyMapError

Für Webentwickler:

Wenn Sie Zugriff auf den Quellcode Ihrer Anwendung haben, suchen Sie das <script>-Tag, mit dem die Maps JavaScript API geladen wird. Ersetzen Sie beim Laden der Maps JavaScript API YOUR_API_KEY im Code unten durch Ihren API-Schlüssel.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sehen Sie sich den Netzwerkverkehr an, der von Ihrer Website im Browser generiert wird. In Chrome können Sie dazu in DevTools den Tab Network öffnen. Dort sehen Sie die Netzwerkanfragen, die von Ihrer Website gestellt wurden. Anfragen über die Maps JavaScript API finden Sie unter dem Pfad maps/api/js. Dort können Sie prüfen, ob der key-Parameter für die Anfragen verwendet wird. Sie können den Netzwerkverkehr auf dem Tab Network nach maps/api/js filtern.

Nein, ich verwende keinen API-Schlüssel.

Wenn Sie einen API-Schlüssel anfordern möchten, klicken Sie auf die Schaltfläche unten. Falls kein Einrichtungsassistent angezeigt wird, folgen Sie der Anleitung unter Erste Schritte mit der Google Maps Platform.
Jetzt starten

Ja, ich verwende einen API-Schlüssel.

Sehr gut. Dann sollten Sie jetzt nachsehen, ob mit Ihrem Projekt ein Rechnungskonto verknüpft ist.

Ist mit Ihrem Projekt ein Rechnungskonto verknüpft?

Ich bin mir nicht sicher. Wie finde ich heraus, ob mein Projekt mit einem Rechnungskonto verknüpft ist?

Rufen Sie in der Google Cloud Console die Seite „Abrechnung“ auf und wählen Sie das Projekt aus, in dem Sie Ihren API-Schlüssel erstellt haben. So prüfen Sie, ob der Schlüssel mit dem Projekt verknüpft ist:

Wechseln Sie am linken Seitenrand unter Google Maps Platform > Anmeldedaten zu Anmeldedaten.
Sehen Sie nach, ob der API-Schlüssel aufgeführt ist, den Sie derzeit auf Ihrer Website verwenden. Sollte das nicht der Fall sein, wechseln Sie zu einem anderen Projekt und prüfen Sie dort die Anmeldedaten.
Wenn Sie das Projekt für Ihren API-Schlüssel nicht finden können, haben Sie möglicherweise keinen Zugriff mehr darauf. Bitten Sie andere Nutzer in Ihrer Organisation um Hilfe. Wenn das ursprüngliche Projekt nicht auffindbar ist, versuchen Sie Folgendes:
1. Erstellen Sie ein neues Projekt. Dazu können Sie entweder Neues Projekt aus der Projektliste auswählen oder auf der Seite Resource Manager auf Projekt erstellen klicken.
2. Erstellen Sie einen neuen API-Schlüssel. Rufen Sie dazu die Seite Anmeldedaten auf. Klicken Sie dort auf Anmeldedaten erstellen und wählen Sie API-Schlüssel aus.

Wenn Sie Ihr Projekt in der Cloud Console gefunden haben, können Sie im Menü auf der linken Seite unter Abrechnung nachsehen, ob ein Rechnungskonto verknüpft wurde.

Nein, mein Projekt ist nicht mit einem Rechnungskonto verknüpft.

Rufen Sie in der Cloud Console die Seite Abrechnung aktivieren auf und fügen Sie in Ihrem Projekt ein Rechnungskonto hinzu. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.

Ja, mein Projekt ist mit einem Rechnungskonto verknüpft.

Sehr gut. Dann prüfen Sie, ob die angegebene Abrechnungsmethode gültig ist.

Ist die angegebene Abrechnungsmethode nicht mehr gültig (z. B. eine abgelaufene Kreditkarte)?

In der Cloud Console können Sie eine Zahlungsmethode hinzufügen, entfernen oder aktualisieren.

Wurde ein selbst auferlegtes Tageslimit für die API überschritten?

Wenn Sie für eine Ihrer APIs ein Tageslimit festgelegt haben, um sich vor einem unerwarteten Anstieg der API-Nutzung zu schützen, können Sie einfach das Tageslimit erhöhen.

Die Tageslimits lassen sich in der Cloud Console auf dem Dashboard „APIs und Dienste“ einsehen. Gehen Sie dort so vor:

Wählen Sie ein Projekt aus, wenn Sie dazu aufgefordert werden.
Wählen Sie eine API aus der Liste aus und klicken Sie dann auf den Tab Kontingente.

Gibt es für Ihren API-Schlüssel eine Einschränkung vom Typ „IP-Adressen“?

API-Schlüssel mit einer Einschränkung vom Typ IP-Adressen unterstützen nur Webdienste, die serverseitig genutzt werden sollen, z. B. die Geocoding API und andere Web Service APIs. Für die meisten dieser Webdienste gibt es einen entsprechenden clientseitigen Dienst in der Maps JavaScript API (z. B. den Geocoding-Dienst). Wenn Sie die clientseitigen Dienste der Maps JavaScript API nutzen möchten, müssen Sie einen separaten API-Schlüssel erstellen, der mit einer Einschränkung vom Typ HTTP-Referrer-URLs gesichert werden kann. Entsprechende Informationen finden Sie unter Get an API Key.

Maps JavaScript API-Fehlercodes für Entwickler und Websiteinhaber

Die folgenden Tabellen enthalten die Fehlercodes, die von der Maps JavaScript API zurückgegeben werden können, mit einer Beschreibung der Ursache und einer Anleitung zur Fehlerbehebung. Informationen zur Suche nach Fehlermeldungen finden Sie im Abschnitt Fehler im Browser überprü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

Fehlercode	Meldung	Beschreibung
`NotLoadingAPIFromGoogleMapsError`	The Maps JavaScript API must be downloaded directly from Google's servers. (Die Maps JavaScript API muss direkt von den Google-Servern heruntergeladen werden.)	Das Skriptelement, über das die Maps JavaScript API geladen wird, ist nicht richtig in Ihre Seite eingebunden. Damit die API richtig funktioniert, muss sie direkt über 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. (Diese Website verstößt offenbar gegen die Nutzungsbedingungen für die Google Maps API. Die Google Maps API wurde für diese Website deaktiviert.)	Ihre Anwendung wurde aufgrund von Verstößen gegen die Nutzungsbedingungen der Google Maps Platform, über die Sie mehrmals per E-Mail informiert wurden, gesperrt. Wenn Sie Einspruch gegen die Sperrung einlegen und Ihre Implementierung überprüfen lassen möchten, füllen Sie bitte dieses Formular aus. Sie erhalten dann innerhalb weniger Arbeitstage eine Antwort per E-Mail. Wenn Sie eine Lizenz für die Google Maps Platform-Premiumoption haben, verwenden Sie bitte die Anmeldedaten für die Premiumoption, um den Fehler zu beheben. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung für die Premiumoption.
`UnauthorizedURLForClientIdMapError`	This URL is not authorized to use the Google Maps Client ID provided. (Diese URL ist nicht berechtigt, die angegebene Google Maps-Client-ID zu verwenden.)	Die im Skript geladene Client-ID für die Premiumoption oder die Google Maps APIs for Work ist ungültig oder abgelaufen oder die Adresse, über die die Maps JavaScript API geladen wird, ist nicht in der Liste der autorisierten URLs enthalten. Weitere Informationen finden Sie unter Autorisierte URLs registrieren.

NotLoadingAPIFromGoogleMapsError

The Maps JavaScript API must be downloaded directly from Google's servers. (Die Maps JavaScript API muss direkt von den Google-Servern heruntergeladen werden.)

Das Skriptelement, über das die Maps JavaScript API geladen wird, ist nicht richtig in Ihre Seite eingebunden. Damit die API richtig funktioniert, muss sie direkt über 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. (Diese Website verstößt offenbar gegen die Nutzungsbedingungen für die Google Maps API. Die Google Maps API wurde für diese Website deaktiviert.)

Ihre Anwendung wurde aufgrund von Verstößen gegen die Nutzungsbedingungen der Google Maps Platform, über die Sie mehrmals per E-Mail informiert wurden, gesperrt. Wenn Sie Einspruch gegen die Sperrung einlegen und Ihre Implementierung überprüfen lassen möchten, füllen Sie bitte dieses Formular aus. Sie erhalten dann innerhalb weniger Arbeitstage eine Antwort per E-Mail.

Wenn Sie eine Lizenz für die Google Maps Platform-Premiumoption haben, verwenden Sie bitte die Anmeldedaten für die Premiumoption, um den Fehler zu beheben. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung für die Premiumoption.

UnauthorizedURLForClientIdMapError

This URL is not authorized to use the Google Maps Client ID provided. (Diese URL ist nicht berechtigt, die angegebene Google Maps-Client-ID zu verwenden.)

Die im Skript geladene Client-ID für die Premiumoption oder die Google Maps APIs for Work ist ungültig oder abgelaufen oder die Adresse, über die die Maps JavaScript API geladen wird, ist nicht in der Liste der autorisierten URLs enthalten.

Weitere Informationen finden Sie unter Autorisierte URLs registrieren.

Maps JavaScript API-Fehlercodes

Wenn in der JavaScript-Konsole in Chrome, der Webkonsole von Firefox oder einem gleichwertigen Tool Ihres Browsers ein Fehler auftritt, finden Sie in der Tabelle unten 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. Ihre Seite kann die API nicht richtig laden und die API funktioniert auf dieser Seite nicht. Eine Warnung ist eine zusätzliche Meldung zum Laden der Maps JavaScript API. In der Warnung werden mögliche Fehlerursachen beschrieben oder mögliche Probleme in Ihrem Code aufgeführt, über den die Maps JavaScript API geladen wird. Wenn Sie ausschließlich Warnungen ohne Fehler erhalten, funktioniert die API auf dieser Seite richtig. Wir empfehlen Ihnen jedoch, die potenziellen Probleme zu beheben.

Fehlercodes für Entwickler	Typ	Beschreibung
`ApiNotActivatedMapError`	Fehler	Die Maps JavaScript API ist in Ihrem API-Projekt nicht aktiviert. Unter Umständen müssen Sie die Maps JavaScript API in der Google Cloud Console unter „APIs“ aktivieren. Klicken Sie auf die Schaltfläche unten, um nachzulesen, wie Sie die Maps JavaScript API für Ihr Projekt 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. Sehen Sie nach, ob alle erforderlichen APIs und Dienste richtig in der Liste der aktivierten APIs angegeben sind. Rufen Sie in der Cloud Console „API-Schlüssel“ auf. Weitere Informationen finden Sie 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. Klicken Sie auf die Schaltfläche unten, um nachzulesen, wie Sie ein neues Projekt erstellen und einen API-Schlüssel dafür abrufen. Weitere Informationen
`ClientBillingNotEnabledMapError`	Fehler	Sie haben die Abrechnung für Ihr Projekt nicht aktiviert. Sie müssen die Abrechnung in der Google Cloud Console für das Projekt aktivieren, das mit dieser Client-ID verknüpft ist.
`BillingNotEnabledMapError`	Fehler	Sie haben die Abrechnung für das Projekt, das diesen Fehler verursacht, nicht aktiviert. Sie müssen die Abrechnung in der Google Cloud Console für das Projekt 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 auftreten, wenn Sie versuchen, einen neu erstellten API-Schlüssel zu verwenden, bevor er vom System erkannt wird. Warten Sie einige Minuten und versuchen Sie es noch einmal. Eventuell müssen Sie in der Cloud Console auch 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, über das die API geladen wird, ist ungültig oder abgelaufen. Stellen Sie sicher, dass Sie Ihre Client-ID richtig verwenden. Die Client-ID muss mit dem Präfix „gme-“ beginnen. Wenn dieser Fehler auftritt, obwohl Sie Ihre Client-ID richtig verwenden, ist die ID vermutlich abgelaufen. Wenden Sie sich in diesem Fall an Ihren Google Account Manager. Wenn Sie keine Lizenz für die Premiumoption oder die Google Maps APIs for Work haben, müssen Sie anstelle des `client`-Parameters einen `key`-Parameter mit Ihrem API-Schlüssel verwenden. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung für die Premiumoption.
`InvalidKeyMapError`	Fehler	Der API-Schlüssel im Skriptelement, über das die API geladen wird, wurde nicht gefunden. Sie müssen 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	In Ihrer Anwendung wird ein nicht unterstütztes URI-Schema verwendet. Es muss ein gültiges URI-Format gemäß RFC 3986 verwendet werden.
`MissingKeyMapError`	Fehler	Im Skriptelement, über das die API geladen wird, fehlt der erforderliche Authentifizierungsparameter. Wenn Sie die standardmäßige Maps JavaScript API verwenden, müssen Sie einen `key`-Parameter mit einem gültigen API-Schlüssel verwenden. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform. Wenn Sie die Premiumoption nutzen, müssen Sie entweder einen `client`-Parameter mit Ihrer Client-ID oder einen `key`-Parameter mit einem gültigen API-Schlüssel verwenden. Weitere Informationen finden Sie im Leitfaden zu API-Schlüsseln und Client-IDs. Der Fehler kann NUR vom Websiteinhaber behoben werden. Falls möglich, sollten Sie jedoch den Websiteinhaber benachrichtigen.
`ProjectDeniedMapError`	Fehler	Die Anfrage wurde nicht abgeschlossen. Möglicherweise sind in der Cloud Console weitere Details zum Fehler verfügbar. Rufen Sie die Cloud Console auf.
`RefererDeniedMapError`	Fehler	Ihre Anwendung wurde aufgrund von Verstößen gegen die Nutzungsbedingungen der Google Maps Platform, über die Sie mehrmals per E-Mail informiert wurden, gesperrt. Wenn Sie Einspruch gegen die Sperrung einlegen und Ihre Implementierung überprüfen lassen möchten, füllen Sie bitte dieses Formular aus. Sie erhalten dann innerhalb weniger Arbeitstage eine Antwort per E-Mail.
`RefererNotAllowedMapError`	Fehler	Die URL, über die die Maps JavaScript API aktuell geladen wird, ist nicht in der Liste der zulässigen Verweis-URLs enthalten. Prüfen Sie die Verweiseinstellungen Ihres API-Schlüssels in der Cloud Console. Informationen finden Sie in der Maps JavaScript API-Referenz und unter API-Schlüssel abrufen.
`OverQuotaMapError`	Fehler	Die Anzahl der Anfragen hat die Nutzungslimits für die Maps JavaScript API überschritten. Sobald das Tageskontingent zurückgesetzt ist, sind wieder Anfragen möglich. Der Fehler kann NUR vom Websiteinhaber behoben werden. Sie sollten den Websiteinhaber jedoch nach Möglichkeit in jedem Fall benachrichtigen. Weitere Informationen finden Sie im Leitfaden zu Nutzungslimits. Dort wird auch erläutert, wie Sie höhere Nutzungslimits beantragen.
`ApiProjectMapError`	Fehler	Der angegebene API-Schlüssel oder das API-Projekt, mit dem er verknüpft ist, konnte nicht aufgelöst werden. Dabei kann es sich um einen vorübergehenden Fehler handeln. Wenn diese Fehlermeldung weiter angezeigt wird, müssen Sie möglicherweise einen neuen API-Schlüssel anfordern oder ein neues API-Projekt erstellen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
`ClientIdLooksLikeCryptoKey`	Warnung	Möglicherweise haben Sie einen kryptografischen Schlüssel als `client`-Parameter angegeben. Wenn Sie eine Lizenz für die Premiumoption oder die Google Maps APIs for Work haben, geben Sie bitte Ihre Client-ID als `client`-Parameter an. Sie müssen Ihren kryptografischen Schlüssel nicht für die Maps JavaScript API verwenden. Weitere Informationen finden Sie im Leitfaden zu Client-IDs für Kunden, die die Premiumoption und die Google Maps APIs for Work nutzen.
`ClientIdLooksLikeKey`	Warnung	Möglicherweise haben Sie im `client`-Parameter einen API-Schlüssel angegeben. Wenn Sie eine Lizenz für die Premiumoption oder die Google Maps APIs for Work haben, geben Sie bitte Ihre Client-ID als `client`-Parameter an. Wenn Sie eine Lizenz für die Google Maps Platform-Premiumoption haben, können Sie einen `client`- oder `key`-Parameter verwenden. Wenn Sie keine Lizenzen haben, müssen Sie einen `key`-Parameter anstelle eines `client`-Parameters verwenden. Weitere Informationen finden Sie im Leitfaden zur 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 und kann Punkte (.), Unterstriche (_) und Bindestriche (-) enthalten. Sie müssen einen gültigen `channel`-Parameter angeben. Weitere Informationen finden Sie unter Premiumoption – Berichte.
`InvalidClientId`	Warnung	Der `client`-Parameter enthält offenbar keine korrekte Client-ID. Die Client-ID muss mit dem Präfix „gme-“ beginnen. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung für die Premiumoption.
`InvalidKey`	Warnung	Im Skriptelement, über das die API geladen wird, ist kein korrekter API-Schlüssel enthalten. Sie müssen 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
`InvalidVersion`	Warnung	Möglicherweise haben Sie eine unzulässige Versionsnummer in Ihrem Skriptelement angegeben. Sie müssen eine korrekte Versionsnummer verwenden. Weitere Informationen finden Sie in der Dokumentation zur Maps JavaScript API unter Versionsverwaltung.
`KeyLooksLikeClientId`	Warnung	Möglicherweise haben Sie eine Client-ID als `key`-Parameter angegeben. Wenn Sie eine Lizenz für die Premiumoption oder die Google Maps APIs for Work haben, geben Sie Ihre Client-ID bitte als `client`-Parameter anstelle des `key`-Parameters an. Wenn Sie eine Lizenz für die Google Maps Platform-Premiumoption haben, können Sie einen `client`- oder `key`-Parameter verwenden. Wenn Sie keine Lizenzen haben, müssen Sie einen `key`-Parameter anstelle eines `client`-Parameters verwenden. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung für die Premiumoption.
`KeyLooksLikeCryptoKey`	Warnung	Möglicherweise haben Sie einen kryptografischen Schlüssel oder ein Signatur-Secret als `key`-Parameter angegeben. Wenn Sie eine Lizenz für die Premiumoption oder die Google Maps APIs for Work haben, geben Sie bitte Ihre Client-ID als `client`-Parameter an und entfernen Sie den `key`-Parameter aus dem Skriptelement. Der kryptografische Schlüssel ist für die Maps JavaScript API nicht erforderlich. Wenn Sie eine Lizenz für die Google Maps Platform-Premiumoption haben, können Sie einen `client`- oder `key`-Parameter verwenden. Wenn Sie keine Lizenzen haben, können Sie in der Cloud Console einen API-Schlüssel abrufen. Weitere Informationen finden Sie unter Client-ID beim Laden der API angeben.
`KeyLooksLikeProjectNumber`	Warnung	Möglicherweise haben Sie eine Projektnummer als `key`-Parameter angegeben. Sie müssen einen korrekten API-Schlüssel verwenden. Sie können in der Cloud Console einen neuen API-Schlüssel generieren. Informationen zum Abrufen eines API-Schlüssels
`NoApiKeys`	Warnung	Im Skriptelement zum Laden der API ist kein API-Schlüssel enthalten. Sie müssen einen gültigen API-Schlüssel als `key`-Parameter angeben. 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 Wenn Sie die Maps JavaScript API über den eingestellten Pfad der Version 2 laden, wird die Warnung `NoApiKeys` zurückgegeben, selbst wenn Sie den `key`-Parameter angegeben haben. Bitte lesen Sie Maps JavaScript API-Anwendung von Version 2 auf Version 3 aktualisieren und migrieren Sie Ihre Anwendung zur Maps JavaScript API Version 3.
`RetiredVersion`	Warnung	Möglicherweise haben Sie eine ausgemusterte Version in Ihrem Skriptelement angegeben. Bitte aktualisieren Sie Ihre Anwendung auf eine der verfügbaren Versionen. Weitere Informationen finden Sie in der Dokumentation zur Maps JavaScript API unter Versionsverwaltung.
`SensorNotRequired`	Warnung	Der `sensor`-Parameter ist nicht mehr für die Maps JavaScript API erforderlich. Die Maps JavaScript API funktioniert zwar weiterhin richtig, wir empfehlen aber, den `sensor`-Parameter aus dem Skriptelement zu entfernen.
`SignatureNotRequired`	Warnung	Der `signature`-Parameter ist für die Maps JavaScript API nicht erforderlich. Die Maps JavaScript API funktioniert zwar weiterhin richtig, der Parameter kann jedoch ein Sicherheitsrisiko darstellen. Bitte entfernen Sie ihn aus dem Skriptelement.
`SignedInNotSupported`	Warnung	Der `signed_in`-Parameter wurde eingestellt und wird in der Version der Maps JavaScript API, die Sie verwenden, nicht mehr unterstützt. Die Maps JavaScript API funktioniert zwar weiterhin richtig, das Verhalten Ihrer Anwendung kann sich aber ändern, wenn Sie Funktionen für angemeldete Nutzer verwenden.
`UrlAuthenticationCommonError`	Fehler	Es ist ein Fehler aufgetreten, der keiner der anderen Kategorien auf dieser Seite zugeordnet werden kann. Eventuell ist er auf ein vorübergehendes Problem zurückzuführen. Bitte warten Sie kurz und führen Sie die Anfrage dann noch einmal aus. Wenn das Problem weiter besteht, lesen Sie im Entwicklerhandbuch nach, ob die Anfrage das richtige Format hat.

Fehler im Browser überprüfen

Die Maps JavaScript API gibt Fehlermeldungen in der window.console aus. In diesem Abschnitt wird erläutert, wie Sie die window.console-Ausgabe in Google Chrome prüfen können. Falls Sie einen anderen Browser verwenden, lesen Sie bitte in der Entwicklerdokumentation Ihres Browsers nach. Hier ist eine Liste mit Tools, mit denen Sie die window.console-Ausgabe in einigen anderen Browsern prüfen können.

Webkonsole für Firefox
Remote-Debugging für Android
Web Inspector für iOS

In Chrome können Sie die JavaScript-Konsole verwenden, um die window.console-Ausgabe zu prüfen. Dazu gehen Sie so vor:

Wählen Sie das Dreipunkt-Menü > „Weitere Tools“ > „Entwicklertools“ aus.
Drücken Sie zum Öffnen der JavaScript-Konsole die Esc-Taste auf Ihrer Tastatur. Mit dieser Taste lässt sich die JavaScript-Konsole ein- und ausblenden. Wenn Sie die Konsole geschlossen haben, können Sie sie mit der Esc-Taste wieder öffnen.

Fehler oder Warnungen, die beim Laden der Maps JavaScript API ausgegeben werden, werden in der Konsole als eine oder mehrere Zeilen angezeigt. Sie haben 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 oben finden Sie die Fehlercodes, die in den Meldungen angegeben sind. Details zur Fehlermeldung sind außerdem im API-Dokument verfügbar, das in der Meldung verlinkt ist.

Hinweis: Sie können programmatisch auf Authentifizierungsfehler warten.

Nicht unterstützte Browser

Sie müssen eine Browserversion verwenden, die von der Maps JavaScript API unterstützt wird.

Wenn Sie eine native Windows-Anwendung entwickeln, die in einer WebView ausgeführt wird, ist es notwendig, WebView2 auf Grundlage von Edge zu verwenden. Frühere Versionen von WebView, die auf Internet Explorer basieren, werden nicht mehr unterstützt.

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 sie beheben können.

Suchen Sie nach Tippfehlern. Denken Sie daran, dass in 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 Eigenschaften zoom und center angegeben haben.
- Vergewissern Sie sich, dass Sie ein „div“-Element deklariert haben, in dem die Karte auf dem Bildschirm angezeigt wird.
- Kontrollieren Sie, dass für das „div“-Element 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.
Sehen Sie sich die Beispielimplementierung an.
Verwenden Sie eine JavaScript-Fehlersuche, z. B. die, die in den Chrome-Entwicklertools verfügbar ist. Suchen Sie zuerst in der JavaScript-Konsole nach Fehlern.
Posten Sie Fragen auf Stack Overflow. Richtlinien für gute Fragen sind auf der Supportseite verfügbar.