Fehlerbehebung

API-Schlüssel- und Abrechnungsfehler

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. Der folgende Ablauf hilft bei der Fehlerbehebung:

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:

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.

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

Sehr gut. Dann sollten Sie jetzt nachsehen, ob mit Ihrem Projekt ein 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:

  1. Wechseln Sie am linken Seitenrand unter Google Maps Platform > Anmeldedaten zu Anmeldedaten.
  2. 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.
  3. 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.

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.

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

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

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:

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

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.

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.