Informationen für Einsteiger
- Was ist die Google Maps Platform?
- Wo finde ich Informationen zum Einstieg in die Google Maps Platform?
- Welche API benötige ich?
- Wie verwende ich die APIs auf meiner Website?
- Welche Länder deckt die Google Maps Platform ab?
- Kann ich Google Maps in meine Website einbinden, ohne die Google Maps Platform-Produkte zu verwenden?
- Wie stelle ich Maps-Apps auf Mobilgeräten zur Verfügung?
- Welche Webbrowser werden von der Maps JavaScript API und der Maps Embed API unterstützt?
- Kann ich Karten über die Maps JavaScript API drucken?
- Wie werde ich über Änderungen an Google Maps Platform-Produkten informiert?
- Wie erreiche ich den technischen Support?
- Wann ist der technische Support erreichbar?
- Wie kann ich den Zugriff auf mein Google-Konto wiederherstellen?
- Wie kann ich den Zugriff auf ein bestimmtes Projekt wiederherstellen?
- Kann ich das Maps SDK for iOS und das Places SDK for iOS auf ARM-Macs verwenden?
Nutzungsbedingungen
- Wie lauten die Nutzungsbedingungen für die Google Maps Platform-Produkte?
- Erfüllt meine Website die Nutzungsbedingungen für die Google Maps Platform?
- Kann ich direkt auf Kartenkacheln und Satellitenbilder zugreifen?
- Kann ich Google Maps Platform-Produkte für Tracking-Anwendungen verwenden?
- Kann ich Google Maps Platform-Produkte in Anwendungen verwenden, die keine Webanwendungen sind?
- Kann ich Google Maps Platform-Produkte auf passwortgeschützten Websites verwenden?
- Kann ich eine Anwendung erstellen, die Google Maps Platform-Daten in ein Dokument einfügt?
- Wie kann ich verhindern, dass meine Inhalte in Google-Suchergebnissen angezeigt werden?
- Darf ich mit der Maps Static API ein Kartenbild erstellen, das auf meiner Website gespeichert und von dort bereitgestellt wird?
Nutzungslimits und Abrechnung
- Wie richte ich die Abrechnung für mein Projekt ein?
- Wie kann man von kostenlosen Google Cloud Platform Free Tier auf ein kostenpflichtiges Konto umstellen?
- Gibt es Nutzungslimits für die Google Maps Platform?
- Wie werden die Nutzungskosten berechnet?
- Wie werden Kartenaufrufe auf der Google Maps Platform gezählt?
- Wie kann ich meine Kontingentnutzung im Blick behalten?
- Was passiert, wenn ich die Nutzungslimits überschreite?
- Meine Website ist stark frequentiert. Kann ich Google Maps Platform-Produkte verwenden?
- Funktionieren meine Karten auch weiter, wenn meine Website schnell beliebter wird?
- Wie wird die Nutzung ermittelt und abgerechnet?
- Was kostet die Nutzung der Google Maps Platform?
- Sind die Preise auch in anderen Währungen verfügbar?
- Ich habe die Abrechnung eingerichtet. Wie kann ich meine Rechnung einsehen?
- Wie kann ich hohe Rechnungen vermeiden, wenn meine Nutzung unerwartet ansteigt?
- Ich wurde benachrichtigt, dass mein Projekt mit einem Google Maps Platform-Übergangskonto verknüpft ist, habe aber keinen Zugriff auf dieses Konto. Was soll ich tun?
- Warum ist mein Kontingentlimit auf eine Anfrage pro Tag festgelegt? Wie kann ich es erhöhen?
- Ich wurde über einen Verstoß bei der Abrechnung informiert. Was kann ich tun?
Google Maps Platform verwenden
- Welche Schlüssel oder Anmeldedaten soll ich für die einzelnen Google Maps Platform-Produkte verwenden?
- Wie ändere ich den Einschränkungstyp für meinen Schlüssel von „HTTP-Referrer“ zu „IP-Adressen“?
- Wie erhalte ich einen neuen API-Schlüssel?
- Wo kann ich die Änderungen für die einzelnen Versionen der Google Maps Platform einsehen?
- Wie kann ich die API asynchron in eine Webseite laden, nachdem die Seite bereits geladen ist?
- Wie kann ich Google Maps Platform-Produkte in einer anderen Sprache als Englisch anzeigen lassen?
- Ist der Zugriff auf die Google Maps Platform über SSL (HTTPS) möglich?
- Wie kann ich für die Google Maps Platform Fehler melden oder neue Funktionen vorschlagen?
- Wie werden Cookies von den Google Maps Platform APIs verwendet?
- Ich finde keine Antwort auf meine Frage. An wen kann ich mich wenden?
Fehler und Fehlerbehebung
- Was besagt dieser Fehler?
- Meine Karten werden dunkler als sonst angezeigt. Woran liegt das?
-
Wie behebe ich die Fehler
OVER_DAILY_LIMIT
undOVER_QUERY_LIMIT
? -
Wie behebe ich die Fehler
kGMSPlacesRateLimitExceeded
und9005 PLACES_API_RATE_LIMIT_EXCEEDED
? - Wie behebe ich den Fehler „This IP, site or mobile application is not authorized to use this API key.“ (Diese IP, Website oder mobile App ist nicht berechtigt, diesen API-Schlüssel zu verwenden.)?
- Wie behebe ich den Fehler „API keys with referer restrictions cannot be used with this API.“ (API-Schlüssel mit Einschränkungen vom Typ „HTTP-Referrer“ können nicht mit dieser API verwendet werden.)?
Google Maps Platform-Dienste
- Ich möchte Adressen in Längen- und Breitengradangaben umwandeln. Ist das mit der Google Maps Platform möglich?
- Für welche Länder ist Geocoding verfügbar?
- Warum geben die Geocoder der Google Maps Platform andere Positionen an als Google Maps?
- Wie sollten meine Geocoder-Anfragen formatiert sein, damit möglichst viele Anfragen erfolgreich sind?
- Wie formatiere ich Adressen für US-Highways mit Nummernschema für das Geocoding?
- Wann verwende ich eine API-Geocoder-Klasse und wann den HTTP-Geocoding-Dienst?
- Wie kann ich mit der Google Maps Platform Wegbeschreibungen bereitstellen?
- Für welche Länder sind Wegbeschreibungen verfügbar?
- Für welche Länder sind Routen für öffentliche Verkehrsmittel verfügbar?
- Welche Funktionen von KML und GeoRSS werden in der Maps JavaScript API unterstützt?
- Welche Beschränkungen gelten für die Größe und Komplexität von KML-Dateien, die mithilfe der Klasse „KmlLayer“ der Maps JavaScript API angezeigt werden können?
- Wie kann ich KML-Dateien, die auf Websites im Intranet gehostet werden, auf einer Karte rendern?
- Wie viele Markierungen oder Pfadeckpunkte werden maximal von der Maps Static API unterstützt?
- Warum kann ich in bestimmten Ländern nicht auf Google Maps Platform-Produkte zugreifen?
- Wie melde ich ein Problem auf der Google-Basiskarte?
- Wie wird die Leistung der Dienste überwacht, die mit der Maps JavaScript API verwendet werden?
Maps JavaScript API
Google Maps SDK for iOS
-
Wie behebe ich den Fehler
kGMSPlacesRateLimitExceeded
? - Beim Debugging mit einem iOS 8.x-Gerät kommt es zu Abstürzen. Was soll ich tun?
- Welche Auswirkungen haben abgerundete und breitere Displays auf das Google Maps SDK for iOS?
Google Maps SDK for Android
-
Wie behebe ich den Fehler
9001 Operation failed due to exceeding the quota usage limit
? - In meiner App werden nur leere graue Kacheln anstelle einer Karte angezeigt. Wie kann ich dieses Problem beheben?
URL-Signatur
- Kann ich URLs mit JavaScript signieren?
- Warum erhalte ich für meine Maps API-Webdienstanfragen den Fehler „HTTP 403 Forbidden“?
Informationen für Einsteiger
- Was ist die Google Maps Platform?
-
Die Google Maps Platform umfasst eine Reihe von APIs und SDKs, mit denen Entwickler Google Maps in mobile Apps und Webseiten einbetten oder Daten von Google Maps abrufen können. Es gibt verschiedene Optionen. Je nach Ihren Anforderungen können Sie eine dieser APIs oder eines dieser SDKs nutzen oder sie miteinander kombinieren.
Karten:
- Maps JavaScript API
- Maps SDK for Android
- Maps SDK for iOS
- Map Tiles API
- Aerial View API
- Maps Static API
- Street View Static API
- Maps URLs
- Maps Embed API
- Maps Datasets API
Routen:
Orte:
- Places API
- Places SDK for Android
- Places SDK for iOS
- Places Library, Maps JavaScript API
- Address Validation API
- Geocoding API
- Geolocation API
- Time Zone API
Umwelt:
- Wo finde ich Informationen zum Einstieg in die Google Maps Platform?
-
Entsprechende Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
- Welche API benötige ich?
-
Informationen zur Auswahl der richtigen API für Ihre Funktionsanforderungen finden Sie unter API-Auswahl.
- Wie verwende ich die APIs auf meiner Website?
-
Entsprechende Informationen finden Sie auf der Seite „Übersicht“ und in den Entwickler- und Startleitfäden der jeweiligen API oder des SDKs. Sie können sich beispielsweise die Leitfäden für das Maps SDK for Android oder die Maps JavaScript API ansehen.
- Welche Länder deckt die Google Maps Platform ab?
-
Das Google Maps-Team veröffentlicht ständig neue Kartendaten und erhöht die internationale Abdeckung. Aktuelle Informationen finden Sie unter Details zur Google Maps Platform-Abdeckung. Die Daten können mithilfe des Filters oben auf der Seite gefiltert werden. Die Abdeckung kann sich ändern, wenn Änderungen an den Lizenzvereinbarungen mit Datenanbietern vorgenommen werden.
Siehe auch:
- Kann ich Google Maps in meine Website einbinden, ohne die Google Maps Platform-Produkte zu verwenden?
-
Ja. In Google Maps können Sie jetzt die angezeigte Karte in Ihre Website oder Ihren Blog einbetten. Dazu sind weder Programmierkenntnisse noch die Google Maps Platform erforderlich. Weitere Informationen
- Wie stelle ich Maps-Apps auf Mobilgeräten zur Verfügung?
-
Wenn Sie Karten in eine Android-App einbinden möchten, müssen Sie das Maps SDK for Android verwenden.
Um Karten in eine native iOS-App einzubetten, müssen Sie das Maps SDK for iOS verwenden.
Die Maps JavaScript API wurde für Mobilgeräte entwickelt. Sie eignet sich auch für Browseranwendungen auf Computern und für Geräte mit einem Webbrowser mit einer kompletten JavaScript-Implementierung, wie das iPhone.
Bei Anwendungen auf Geräten, auf denen die Maps JavaScript API nicht verwendet werden kann, werden Kartenbilder im GIF-, JPG- oder PNG-Format über die Static Maps API bereitgestellt, einschließlich Markierungen und Polylinien. Wenn die Maps Static API außerhalb von browserbasierten Anwendungen genutzt wird, muss das Kartenbild mit Google Maps verknüpft sein.
- Welche Webbrowser werden von der Maps JavaScript API und der Maps Embed API unterstützt?
-
Die folgenden Webbrowser werden unterstützt:
Computer- aktuelle Version von Microsoft Edge (Windows), ohne Internet Explorer-Modus (IE-Modus)
- die zwei neuesten stabilen Hauptversionen von Firefox (Windows, macOS, Linux)
- die zwei neuesten stabilen Hauptversionen von Chrome (Windows, macOS, Linux)
- die zwei neuesten stabilen Hauptversionen von Safari (macOS)
- aktuelle Version von Chrome ab Android 4.1
- Chrome WebView ab Android 4.4
- Mobile Safari unter der aktuellen und den vorherigen Hauptversionen von iOS
- UIWebView und WKWebView unter der aktuellen und den vorherigen Hauptversionen von iOS
- aktuelle Version von Chrome für iOS
- Kann ich Karten über die Maps JavaScript API drucken?
-
Das ist nicht möglich, weil das Drucken in den gängigen Browsern nicht einheitlich unterstützt wird.
- Wie werde ich über Änderungen an Google Maps Platform-Produkten informiert?
-
Sie können den Google Maps Platform-Blog abonnieren, um aktuelle Informationen über die verschiedenen Angebote der Google Geo-Entwickler zu erhalten.
- Wie erreiche ich den technischen Support?
-
Informationen zu den verfügbaren Supportoptionen finden Sie auf der Seite Support und Ressourcen für Google Maps Platform.
- Wann ist der technische Support erreichbar?
- Das Supportteam ist von Montag, 09:00 Uhr JST (UTC+9) bis Freitag, 17:00 Uhr PST (UTC−8) bei Problemen mit nicht verwendbaren Diensten erreichbar (regionale Feiertage ausgenommen).
- Wie kann ich den Zugriff auf mein Google-Konto wiederherstellen?
-
Wenn Sie keinen Zugriff mehr auf Ihr Google-Konto haben (z. B. [email protected] oder [email protected]), können Sie versuchen, das Passwort abzurufen oder zurückzusetzen. Sehen Sie sich dazu den Artikel Google-Konto oder Gmail wiederherstellen an.
- Hinweis: Wenn Sie wieder Zugriff auf ein G Suite-Konto erhalten möchten, bitten Sie den Administrator Ihrer Organisation, das Konto wiederherzustellen.
- Wie kann ich den Zugriff auf ein bestimmtes Projekt wiederherstellen?
-
Wenn Sie nicht mehr auf das Projekt zugreifen können, über das Sie die Google Maps Platform-Implementierung verwalten, können Sie versuchen, es wiederherzustellen.
Falls Sie Zugriff auf das Google-Konto haben, das Ihrem Projekt zugewiesen ist:
- Wenn Sie den Project Owner kennen und Zugriff auf Ihr Google-Konto haben: Bitten Sie den Project Owner, Sie als Project Owner oder Project Editor hinzuzufügen.
- Wenn das Projekt zu einer Organisation gehört: Wenden Sie sich an die Administratoren Ihrer Organisation und bitten Sie sie, Sie als Project Owner hinzuzufügen.
- Wenn Sie nicht wissen, wer der Project Owner ist, oder er nicht verfügbar ist: Wenden Sie sich an das Supportteam. Es wird dann versucht, eine andere Lösung zum Wiederherstellen des Projekts zu finden.
Wenn Sie keinen Zugriff auf das Google-Konto haben, das Ihrem Projekt zugewiesen ist:
- Wenn Sie keinen Zugriff mehr auf Ihr Google-Konto haben: Versuchen Sie, Ihren Nutzernamen oder Ihr Passwort wiederherzustellen.
- Wenn Sie den Zugriff auf Ihr Google-Konto nicht wiederherstellen können: Erstellen Sie ein neues Google-Konto. Wenden Sie sich dann an einen bestehenden Project Owner und bitten Sie ihn, dem Projekt das neue Konto hinzuzufügen.
- Wenn Sie den Project Owner kennen und Zugriff auf Ihr Google-Konto haben: Bitten Sie den Project Owner, Sie als Project Owner oder Project Editor hinzuzufügen.
- Kann ich das Maps SDK for iOS und das Places SDK for iOS auf ARM-Macs verwenden?
-
Entwickler können auf ARM-Macs arbeiten, die Anwendung muss aber auf einem physischen iOS-Gerät erstellt und ausgeführt werden. Das ist eine vorübergehende Einschränkung. Wir arbeiten daran, die Unterstützung für die Entwicklung auf Simulatoren weiter auszubauen.
Nutzungsbedingungen
- Wie lauten die Nutzungsbedingungen für die Google Maps Platform-Produkte?
-
Die Nutzungsbedingungen für die Google Maps Platform sind hier verfügbar:
https://cloud.google.com/maps-platform/terms
- Erfüllt meine Website die Nutzungsbedingungen für die Google Maps Platform?
-
Solange Ihre Website die Nutzungsbedingungen für die Google Maps Platform erfüllt, können Sie die Google Maps Platform in Ihren Anwendungen nutzen.
Allerdings gibt es einige Verwendungen, die wir unter keinen Umständen tolerieren. Dazu gehören z. B. Karten, auf denen Orte für den Kauf illegaler Drogen in einer Stadt oder für andere illegale Aktivitäten markiert sind. Außerdem respektieren wir die Privatsphäre von Personen. Daher darf die Google Maps Platform nicht verwendet werden, um persönliche Informationen zu Einzelpersonen zu veröffentlichen.
Bevor Sie eine Anwendung entwickeln und einführen, müssen Sie selbst ermitteln, ob sie die Nutzungsbedingungen für die Google Maps Platform erfüllt. Die Entwickler von Google bieten nur technische Hilfe und keine Rechtsberatung. Google behält sich das Recht vor, Ihre Nutzung des Dienstes jederzeit auszusetzen oder zu beenden. Sie sollten sich daher die Nutzungsbedingungen für die Maps APIs sorgfältig durchlesen.
- Kann ich direkt auf Kartenkacheln und Satellitenbilder zugreifen?
-
Auf die Kartenkacheln und Satellitenbilder darf ausschließlich über die Google Maps Platform zugegriffen werden. Sie dürfen z. B. keine eigene API zum Kartografieren erstellen und auch kein Skript zum Bulk-Download von Kacheln verwenden. Greift Ihre Anwendung außerhalb der Google Maps Platform auf die Kacheln zu, wird ihr Zugriff gesperrt. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Google Maps Platform.
- Kann ich Google Maps Platform-Produkte für Tracking-Anwendungen verwenden?
-
Es gibt keine Einschränkungen für die Anzeige von Echtzeitdaten (Tracking) mit Google Maps Platform-Produkten, vorausgesetzt, die Anwendung erfüllt die Nutzungsbedingungen für die Google Maps Platform.
- Kann ich Google Maps Platform-Produkte in Anwendungen verwenden, die keine Webanwendungen sind?
-
Ja, Google Maps Platform-Produkte können jetzt auch in nicht internetbasierten Anwendungen verwendet werden, vorausgesetzt, diese erfüllen die Nutzungsbedingungen für die Google Maps Platform.
Die Maps JavaScript API funktioniert nur in einem der unterstützten Browser.
- Kann ich Google Maps Platform-Produkte auf passwortgeschützten Websites verwenden?
-
Ja, Google Maps-, Routes- und Places-Dienste können in nicht öffentlichen Anwendungen verwendet werden. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Google Maps Platform.
- Kann ich eine Anwendung erstellen, die Google Maps Platform-Daten in ein Dokument einfügt?
-
Wenn die Anwendung ein elektronisches oder gedrucktes Dokument generiert, dürfen keine Google Maps Platform-Daten, auch keine Bilder, darin enthalten sein. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Google Maps Platform unter „Kein Scraping“.
- Wie kann ich verhindern, dass meine Inhalte in Google-Suchergebnissen angezeigt werden?
-
Diese Daten werden von uns nicht mehr erhoben. Die Verwendung des Parameters
indexing
wurde eingestellt. Er hat daher keinerlei Wirkung. Sie müssen also nicht mehr explizit widersprechen. Wir empfehlen Ihnen aber, den Parameter so schnell wie möglich zu entfernen.Hier erfahren Sie, wie Sie Ihre Seite oder Website aus den Suchergebnissen ausschließen.
- Darf ich mit der Maps Static API ein Kartenbild erstellen, das auf meiner Website gespeichert und von dort bereitgestellt wird?
-
Kopien von Bildern, die mit der Maps Static API erstellt wurden, dürfen nicht auf Ihrer Website gespeichert und von dort bereitgestellt werden. Auf allen Webseiten, für die statische Bilder erforderlich sind, muss das
src
-Attribut eines HTML-img
-Tags oder das CSS-Attributbackground-image
eines HTML-div
-Tags direkt mit der Maps Static API verknüpft werden, damit alle Kartenbilder im HTML-Inhalt der Webseite angezeigt und von Google direkt für Endnutzer bereitgestellt werden.
Nutzungslimits und Abrechnung
- Wie richte ich die Abrechnung für mein Projekt ein?
- Entsprechende Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
- Wie kann man von der kostenlosen Google Cloud Platform-Stufe auf ein kostenpflichtiges Konto umstellen?
- Die kostenlose Stufe der Google Cloud Platform bietet Kunden ein kostenloses Probeabo mit einem Guthaben von 300 $, das sie mit beliebigen Google Cloud-Diensten, einschließlich der Google Maps Platform (GMP) APIs, nutzen können. Nach Ablauf des kostenlosen Testzeitraums müssen Sie Folgendes tun: Upgrade auf kostenpflichtiges Konto um diese Dienste weiterhin zu nutzen. Dieses Upgrade können Sie in der Cloud Console vornehmen.
- Gibt es Nutzungslimits für die Google Maps Platform?
-
Es gibt keine Tageslimits für die Anzahl der Anfragen an Google Maps Platform-Produkte. Die einzigen Nutzungslimits beziehen sich auf die Maximale Anzahl von Abfragen pro Minute (QPM).
Für Distance Matrix wird das Limit in Ereignissen pro Minute (EPM) festgelegt und ist die Summe von clientseitige und serverseitige Abfragen.
Für Routes:Compute Route Matrix ist das Limit in Elementen pro Minute (EPM) angegeben, wobei die Anzahl der -Elemente in einer Anfrage sind gleich: (Anzahl der Startorte mal Anzahl der Zielorte).
Nachfolgend finden Sie die Limits für die einzelnen APIs:
Zur Kostenkontrolle können Sie die API-Nutzung im Auge behalten und Tageslimits für alle Anfragen an kostenpflichtige APIs festlegen.
Die Bereitstellung von Google Maps Platform-Produkten muss in Übereinstimmung mit den standardmäßigen Nutzungsbedingungen für die Google Maps Platform erfolgen.
- Wie werden die Nutzungskosten berechnet?
-
Die Kosten für die einzelnen Google Maps Platform-Produkte finden Sie in der Preisübersicht.
Weitere Informationen zur Abrechnung von Google Maps Platform APIs finden Sie hier.
- Wie werden Kartenaufrufe auf der Google Maps Platform gezählt?
-
In folgenden Fällen wird ein einzelner Kartenaufruf berechnet:
- Auf einer Webseite oder in einer Anwendung wird mithilfe der Maps JavaScript API eine Karte angezeigt.
- In einer Anwendung wird ein einzelnes Kartenbild von der Maps Static API angefordert.
Street View-Panoramen werden getrennt von Kartenaufrufen abgerechnet:
- Für jede Anfrage an die Street View Static API, um ein statisches (nicht interaktives) Street View-Panorama einzubetten, wird ein statisches Street View-Panorama berechnet.
- Für jede Instanziierung eines Panoramaobjekts in einer Maps JavaScript API, einem Maps SDK for Android oder einem Maps SDK for iOS wird ein dynamisches Street View-Panorama berechnet.
Nachdem eine Karte, ein statisches Kartenbild oder ein Street View-Panorama auf einer Webseite oder in einer Anwendung geladen wurde, werden durch Nutzerinteraktionen wie Schwenken, Zoomen oder Wechseln von Kartenebenen keine weiteren Kartenaufrufe generiert. Sie wirken sich auch nicht auf die Nutzungslimits aus.
Durch das Hinzufügen von Markierungen werden keine zusätzlichen Kartenaufrufe generiert. Es können aber Kosten für die Bestimmung der Markierungsposition anfallen, z. B. für das Laden oder Neuladen der Klasse „google.maps.Map()“.
- Wie kann ich meine Kontingentnutzung im Auge behalten?
-
Die Nutzung einzelner APIs lässt sich in der Google Cloud Console überwachen.
- Wählen Sie das Projekt aus, in dem die entsprechende API enthalten ist.
- Klicken Sie im Dashboard in der Liste der APIs auf den Namen der API.
- Klicken Sie oben auf der Seite auf Messwerte oder Kontingente.
So rufen Sie einen Zugriffsbericht und Abrechnungsdaten für ein komplettes Projekt auf:
- Richten Sie die Abrechnung ein, falls noch nicht geschehen.
- Rufen Sie in der Cloud Console die Seite „Abrechnung“ auf.
- Wählen Sie ein Projekt aus.
- Klicken Sie in der linken Seitenleiste auf Berichte. Über die Filter in der rechten Seitenleiste können Sie Berichte zu Ihrem Rechnungskonto aufrufen.
Weitere Informationen finden Sie unter Berichterstellung für die Google Maps Platform, API-Nutzung überwachen und API-Nutzung deckeln.
- Was passiert, wenn ich die Limits für die Anforderungsrate überschreite?
-
Wenn Sie die QPM-Limits einer bestimmten Google Maps Platform-Produkt haben, gibt die API eine Fehlermeldung zurück. Werden die Limits mehrfach überschritten, kann Ihr Zugriff auf die API vorübergehend gesperrt werden.
Wenn Sie die QPM-Limits für Anfragen überschreiten oder Andernfalls wird bei Anfragen eine bestimmte Fehlermeldung zurückgegeben. Werden die Limits immer wieder überschritten, kann Ihr Zugriff auf die Google Maps Platform gesperrt werden.
Hinweis: Für vier der Web Service APIs gibt es einen entsprechenden clientseitigen Dienst in der Maps JavaScript API: Directions, Distance Matrix, Elevation und Geocoding.
Nutzungslimits überschritten
Wenn Sie die Nutzungslimits überschreiten, erhalten Sie eine
OVER_QUERY_LIMIT
Statuscode als Antwort ein.Diese Meldung bedeutet, dass der Webdienst keine normalen Antworten mehr bereitstellt und nur noch den Statuscode
OVER_QUERY_LIMIT
zurückgibt, bis eine weitere Nutzung wieder zulässig ist. Dieses Szenario kann innerhalb weniger Sekunden eintreten, wenn der Fehler erhalten, da Ihre Anwendung zu viele Anfragen pro Minute gesendet hat.Wenn Sie die Nutzungslimits für die Abfragen pro Minute regelmäßig überschreiten, sollten Sie die Nutzung reduzieren. durch Optimierung von Anwendungen für eine stärkere Nutzung der Google Maps Platform-Produkte oder eine Erhöhung Ihres Kontingents beantragen. Weitere Informationen finden Sie im Optimierungsleitfaden.
- Meine Website ist stark frequentiert. Kann ich Google Maps Platform-Produkte verwenden?
-
Ja. Wir empfehlen Ihnen aber, sich mit den Nutzungslimits der Google Maps Platform-Produkte vertraut zu machen, auf die Ihre Anwendung angewiesen ist.
- Funktionieren meine Karten auch weiter, wenn meine Website schnell beliebter wird?
-
Wenn Sie ein Rechnungskonto haben, Ihr kostenloses Guthaben in Höhe von 200 $ pro Monat aufgebraucht haben und keine gültige Zahlungsmethode für Ihr Rechnungskonto eingerichtet ist (z. B. Kreditkarte oder Banküberweisung), funktioniert die API erst wieder, wenn Sie eine gültige Zahlungsmethode hinzufügen.
- Wie wird die Nutzung ermittelt und abgerechnet?
-
Die Nutzung wird am Ende jedes Tages ermittelt und anhand der Preisübersicht berechnet. Am Ende jedes Monats wird die Gesamtnutzung über die Zahlungsmethode abgerechnet, die Ihrem Rechnungskonto zugewiesen ist. Weitere Informationen finden Sie unter Google Maps Platform – Abrechnung.
- Was kostet die Nutzung der Google Maps Platform?
-
Die Kosten für die einzelnen APIs finden Sie in der Preisübersicht. Wenn für die Anfragen oder Kartenaufrufe Ihrer Anwendung maximal 200 $ pro Monat anfallen, wird Ihnen nichts berechnet. Kosten für die Nutzung, die über das monatliche Guthaben von 200 $ hinausgehen, werden über Ihre Zahlungsmethode abgerechnet. Weitere Informationen finden Sie unter Google Maps Platform – Abrechnung.
- Sind die Preise auch in anderen Währungen verfügbar?
-
In der Console sind unter Umständen weitere Währungen verfügbar. Wenn Sie eine andere Währung auswählen, werden die Preise anhand der in der Preisübersicht genannten $-Angaben umgerechnet.
- Ich habe die Abrechnung eingerichtet. Wie kann ich meine Rechnung einsehen?
-
Am Monatsanfang rechnet Google die Nutzungskosten für den Vormonat über die von Ihnen angegebene Zahlungsmethode ab. Weitere Informationen zu Ihrer Rechnung finden Sie unter Google Maps Platform – Abrechnung.
Weitere Informationen:
- Wie kann ich hohe Rechnungen vermeiden, wenn meine Nutzung unerwartet ansteigt?
-
In der Google Maps Platform gibt es Möglichkeiten zum Festlegen täglicher Anfragelimits und Abrechnungsgrenzen. Sie können die maximale tägliche Nutzung deckeln und sich so vor einem unerwarteten Anstieg schützen. Sie können auch Budgetbenachrichtigungen einrichten, damit Sie per E-Mail informiert werden, wenn die Abrechnungssumme einen von Ihnen festgelegten Maximalbetrag erreicht.
Tägliche Abrechnungssumme deckeln
Wenn Sie hohe Kosten vermeiden möchten, können Sie die maximale tägliche Nutzung beschränken und so einen unerwarteten Anstieg verhindern. Sie können dieses Nutzungslimit in der Cloud Console ändern. Gehen Sie dazu so vor:
- Öffnen Sie das Dashboard APIs und Dienste.
- 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.
- Klicken Sie neben dem Kontingent Anfragen pro Tag auf das Symbol „Bearbeiten“.
Alternativ können Sie mehrere Kontingente für mehrere APIs auf der Seite „Kontingente“ unter „IAM & Verwaltung“ bearbeiten.
Budgetbenachrichtigungen einrichten und verwalten:
Sie können Budgetbenachrichtigungen festlegen, damit Abrechnungsadministratoren per E-Mail benachrichtigt werden, wenn die Abrechnungssumme einen von Ihnen festgelegten Maximalbetrag erreicht. Die E-Mails werden gesendet, sobald die geschätzten Kosten 50, 90 und 100 % des Maximalbetrags überschreiten.
- Ich wurde benachrichtigt, dass mein Projekt mit einem Google Maps Platform-Übergangskonto verknüpft ist, habe aber keinen Zugriff auf dieses Konto. Was soll ich tun?
-
Das Google Maps Platform-Übergangskonto wurde erstellt, um bestimmten Kunden die Umstellung auf unser neues „Pay as you go“-Preismodell zu erleichtern. Google kann dieses Konto verwenden, um Kunden ein einmaliges Guthaben zur Verfügung zu stellen, mit dem sie die Google Maps Platform weiter nutzen können, bis das Limit von 200 $ der kostenlosen Stufe erreicht ist. Wenn dieses Limit überschritten wird, wird das Rechnungskonto deaktiviert und Sie können nicht mehr auf den Dienst zugreifen. Um Dienstunterbrechungen zu vermeiden und damit Sie die kostenlose Stufe mit einem monatlichen Guthaben von 200 $ weiterhin nutzen können, sollten Sie dringend ein eigenes Rechnungskonto einrichten. So ändern Sie das Rechnungskonto Ihres Projekts:
- Erstellen Sie ein neues Rechnungskonto. Wenn Sie schon eins haben, können Sie diesen Schritt überspringen.
- Verknüpfen Sie das Rechnungskonto mit Ihrem Projekt.
- Warum ist mein Kontingentlimit auf eine Anfrage pro Tag festgelegt? Wie kann ich es erhöhen?
-
Wenn Sie noch kein Rechnungskonto erstellt und Ihrem Projekt zugewiesen haben, sind Ihre Maps Platform APIs auf eine Anfrage pro Tag beschränkt. Sie müssen ein Rechnungskonto erstellen und verknüpfen, um ein höheres Kontingent zu erhalten. Entsprechende Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Sobald Sie ein Rechnungskonto erstellt und verknüpft haben, wird das Tageslimit entfernt. Sie können in der Cloud Console ein Limit festlegen, um unerwartete Ausgaben zu vermeiden.
- Ich wurde über einen Verstoß bei der Abrechnung informiert. Was kann ich tun?
-
Google hat festgestellt, dass für Ihr Konto mehrere Rechnungskonten verwendet werden. Das ist ein Verstoß gegen die Nutzungsbedingungen von Google gemäß Abschnitt 3.2.4 der Nutzungsbedingungen für die Google Maps Platform. Gemäß diesen Bedingungen ist es verboten, mehrere Rechnungskonten zu erstellen. Weitere Informationen finden Sie unter Rechnungskonten – FAQs zu Verstößen.
Google Maps Platform verwenden
- Welche Schlüssel oder welche Anmeldedaten soll ich für die einzelnen Google Maps Platform-Produkte verwenden?
-
Bei jeder Verwendung der Google Maps Platform-Produkte müssen Sie einen API-Schlüssel angeben, um Ihre Anfrage zu validieren. Die Google Maps Platform ist für Android-, iOS- und Web-Apps sowie über HTTP-Webdienste verfügbar.
API-Schlüssel:
- Ein API-Schlüssel ist eine eindeutige ID, die Sie in der Cloud Console generieren.
- Beispiel für einen API-Ladevorgang mit einem Schlüssel:
&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo
Digitale Signatur:
- Digitale Signaturen werden mit einem von Google bereitgestellten URL-Signatur-Secret generiert. Sie werden mit der Maps Static API und der Street View Static API verwendet.
Einschränkungen:
- Einschränkungen für API-Schlüssel sind optional, aus Sicherheitsgründen empfehlen wir aber dringend, alle API-Schlüssel einzuschränken. Weitere Informationen finden Sie unter Best Practices für die API-Sicherheit.
- Sie können eine Anwendungseinschränkung für einen API-Schlüssel festlegen.
Der Schlüssel funktioniert dann nur auf Plattformen, die den jeweiligen Einschränkungstyp unterstützen.
Es gibt vier Arten von Anwendungseinschränkungen. APIs, die denselben Einschränkungstyp erzwingen, können denselben eingeschränkten Schlüssel verwenden.
- IP-Adressen (einzelne Server) – zur Verwendung mit den Webdienst-APIs
- HTTP-Referrer (Websites) – zur Verwendung mit den Web-APIs
- Einschränkung für Android-Apps (nach Paketname und Fingerabdruck) – zur Verwendung mit dem Maps SDK for Android
- Einschränkung für iOS-Apps (nach iOS-Paket-Identifikator) – zur Verwendung mit dem Maps SDK for iOS
- Sie können auch eine API-Einschränkung für den API-Schlüssel festlegen. Weitere Informationen finden Sie unter API-Schlüssel erstellen.
In der folgenden Tabelle sehen Sie, welche Schlüssel bzw. welche Anmeldedaten für die einzelnen APIs und SDKs der Google Maps Platform verwendet werden müssen und welche Anwendungseinschränkungen jeweils gelten.
API/SDK Anmeldedaten und Anwendungseinschränkung Maps SDK for Android API-Schlüssel mit Android-Einschränkung1 Places SDK for Android API-Schlüssel mit Android-Einschränkung1 Maps SDK for iOS API-Schlüssel mit iOS-Einschränkung1 Places SDK for iOS API-Schlüssel mit iOS-Einschränkung1 Maps JavaScript API API-Schlüssel mit Einschränkung für HTTP-Referrer1 Map Tiles API API-Schlüssel mit Einschränkung für IP-Adressen1 Maps Datasets API OAuth-Token Aerial View API API-Schlüssel mit Einschränkung für IP-Adressen1 Maps Static API API-Schlüssel mit Einschränkung für HTTP-Referrer1 + digitale Signatur2 Street View Static API API-Schlüssel mit Einschränkung für HTTP-Referrer1 + digitale Signatur2 Maps Embed API API-Schlüssel mit Einschränkung für HTTP-Referrer1 Address Validation API API-Schlüssel mit Einschränkung für IP-Adressen1 Directions API API-Schlüssel mit Einschränkung für IP-Adressen1 Distance Matrix API API-Schlüssel mit Einschränkung für IP-Adressen1 Elevation API API-Schlüssel mit Einschränkung für IP-Adressen1 Geocoding API API-Schlüssel mit Einschränkung für IP-Adressen1 Geolocation API API-Schlüssel mit Einschränkung für IP-Adressen1 Places API API-Schlüssel mit Einschränkung für IP-Adressen1 Roads API API-Schlüssel mit Einschränkung für IP-Adressen1 Routes API API-Schlüssel mit Einschränkung für IP-Adressen1 Time Zone API API-Schlüssel mit Einschränkung für IP-Adressen1 Air Quality API API-Schlüssel mit Einschränkung für IP-Adressen1 Pollen API API-Schlüssel mit Einschränkung für IP-Adressen1 Solar API API-Schlüssel mit Einschränkung für IP-Adressen1 1 Einschränkungen für API-Schlüssel sind optional, aus Sicherheitsgründen empfehlen wir aber dringend, alle API-Schlüssel einzuschränken.2 Je nach Nutzung ist unter Umständen eine digitale Signatur für die Maps Static API und die Street View Static API erforderlich. Unabhängig von der Nutzung empfehlen wir dringend, für die Authentifizierung Ihrer Anfragen sowohl einen API-Schlüssel als auch eine digitale Signatur zu verwenden. - Wie ändere ich den Einschränkungstyp für meinen Schlüssel von „HTTP-Referrer“ zu „IP-Adressen“?
-
Wichtig: Wenn Sie eine der Web Service APIs mit einem API-Schlüssel mit Einschränkungen vom Typ „HTTP-Referrer“ verwenden, schlagen Ihre Anfragen fehl und Sie sehen folgende Fehlermeldung: „API keys cannot have referer restrictions when used with this API.“ (API-Schlüssel mit Einschränkungen vom Typ „HTTP-Referrer“ können nicht mit dieser API verwendet werden.) Sie sollten auf einen API-Schlüssel mit dem Einschränkungstyp „IP-Adressen“ umstellen.
Bevor Sie den Einschränkungstyp des API-Schlüssels von „HTTP-Referrer“ zu „IP-Adressen“ ändern, müssen Sie prüfen, ob alle APIs, die den API-Schlüssel verwenden, den Einschränkungstyp „IP-Adressen“ unterstützen. APIs mit demselben Einschränkungstyp können denselben eingeschränkten Schlüssel verwenden. Wenn Sie mehrere Einschränkungen erzwingen müssen, fügen Sie einen separaten Schlüssel mit der erforderlichen Einschränkung hinzu. Weitere Informationen
So ändern Sie den Einschränkungstyp eines API-Schlüssels von „HTTP-Referrer“ zu „IP-Adressen“:
- Rufen Sie in der Cloud Console die Seite „Anmeldedaten“ auf.
- Wählen Sie das Projekt mit dem API-Schlüssel aus, den Sie bearbeiten möchten.
- Auf der Seite Anmeldedaten finden Sie eine Liste mit API-Schlüsseln. Wählen Sie dort den Namen des entsprechenden Schlüssels aus.
- Wählen Sie im Abschnitt Schlüsseleinschränkung die Option „IP-Adressen (Webserver, Cronjobs usw.)“ aus und geben Sie die entsprechenden Server-IP-Adressen ein. Klicken Sie dann auf „Speichern“.
- Wie erhalte ich einen neuen API-Schlüssel?
- Entsprechende Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
- Wo kann ich die Änderungen für die einzelnen Versionen der Google Maps Platform einsehen?
-
Informationen zu Versionsänderungen für viele der Google Maps APIs sind unter den folgenden Links verfügbar:
- Maps JavaScript API
- Routes API
- Directions API
- Distance Matrix API
- Maps SDK for Android
- Places SDK for Android
- Maps SDK for iOS
- Places SDK for iOS
- Address Validation API
- Aerial View API
- Air Quality API
- Pollen API
- Solar API
- Map Tiles API
- Maps Datasets API
Sie können auch das Tool „Issue Tracker“ verwenden, um nachzusehen, in welcher Version der Google Maps Platform ein bestimmter Fehler aufgetreten ist und behoben wurde:
https://issuetracker.google.com/bookmark-groups/76561
- Wie kann ich die API asynchron in eine Webseite laden, nachdem die Webseite geladen wurde?
-
Geben Sie einfach beim Laden der API den Callback-Parameter an. Weitere Informationen und Beispielcode finden Sie in der Maps JavaScript API-Dokumentation.
- Wie kann ich Google Maps Platform-Produkte in einer anderen Sprache als Englisch anzeigen?
-
Standardmäßig wird immer versucht, die Produkte basierend auf dem Standort oder den Browsereinstellungen des Nutzers in der passenden Sprache zu laden. In einigen APIs können Sie beim Senden einer Anfrage die Sprache explizit festlegen. Entsprechende Informationen finden Sie in der Dokumentation der einzelnen APIs:
- Maps JavaScript API
- Geocoding API
- Routes API
- Directions API
- Distance Matrix API
- Places API
- Maps Static API
Die unterstützten Sprachen werden regelmäßig von Google aktualisiert. Diese Liste ist unter Umständen unvollständig und kann sich ändern.
Sprachcode Sprache Sprachcode Sprache af Afrikaans ja Japanisch sq Albanisch kn Kannada am Amharisch kk Kasachisch ar Arabisch km Khmer hy Armenisch ko Koreanisch az Aserbaidschanisch ky Kirgisisch eu Baskisch lo Lao be Belarussisch lv Lettisch bn Bengalisch lt Litauisch bs Bosnisch mk Mazedonisch bg Bulgarisch ms Malaiisch my Burmesisch ml Malayalam ca Katalanisch mr Marathi zh Chinesisch mn Mongolisch zh-CN Chinesisch (vereinfacht) ne Nepalesisch zh-HK Chinesisch (Hongkong) no Norwegisch zh-TW Chinesisch (traditionell) pl Polnisch hr Kroatisch pt Portugiesisch cs Tschechisch pt-BR Portugiesisch (Brasilien) da Dänisch pt-PT Portugiesisch (Portugal) nl Niederländisch pa Punjabi en Englisch ro Rumänisch en-AU Englisch (Australien) ru Russisch en-GB Englisch (Vereinigtes Königreich) sr Serbisch et Estnisch si Singhalesisch fa Farsi sk Slowakisch fi Finnisch sl Slowenisch fil Philippinisch es Spanisch fr Französisch es-419 Spanisch (Lateinamerika) fr-CA Französisch (Kanada) sw Swahili gl Galizisch sv Schwedisch ka Georgisch ta Tamil de Deutsch te Telugu el Griechisch th Thai gu Gujarati tr Türkisch iw Hebräisch uk Ukrainisch hi Hindi ur Urdu hu Ungarisch uz Usbekisch is Isländisch vi Vietnamesisch id Indonesisch zu Zulu it Italienisch In diesem Anwendungsbeispiel können Sie sich ansehen, wie die Karte in jeder der oben aufgeführten Sprachen dargestellt wird.
- Ist der Zugriff auf die Google Maps Platform über SSL (HTTPS) möglich?
-
Auf die Maps JavaScript API, die Maps Static API und die Web Service APIs kann über eine sichere HTTPS-Verbindung zugegriffen werden. Entsprechende Informationen finden Sie in der Dokumentation der jeweiligen API.
Hinweis: Die Maps Static API unterstützt über HTTPS keine URLs, für die ein benutzerdefiniertes Symbol verwendet wird. Stattdessen wird das Standardsymbol angezeigt.
- Wie kann ich für die Google Maps Platform Fehler melden oder neue Funktionen vorschlagen?
-
Falls Sie einen potenziellen Fehler finden, sollten Sie das zuerst im entsprechenden Forum ansprechen. Andere Entwickler können den Fehler dann prüfen und eventuelle Probleme mit Ihrem Code ausschließen.
Falls Sie eine Funktion vorschlagen möchten, sollten Sie das ebenfalls im jeweiligen Forum ansprechen. So können Sie sicher sein, dass noch keine entsprechende Lösung verfügbar ist.
Wenn es sich tatsächlich um einen neuen Fehler handelt bzw. noch keine Funktion existiert, die Ihre Anforderungen erfüllt, können Sie den Issue Tracker der Google Maps Platform verwenden, um den Fehler zu melden oder die Funktionsanfrage zu stellen.
Sehen Sie aber bitte zuerst nach, ob der Fehler oder die Funktionsanfrage nicht schon hinzugefügt wurde. Ist das der Fall, können Sie den Eintrag markieren, um Ihr Interesse zu bekunden und bei neuen Entwicklungen benachrichtigt zu werden.
-
Sowohl das Maps SDK for Android als auch das Maps SDK for iOS verwenden Cookies, die der Datenschutzerklärung von Google unterliegen, um beispielsweise Dienstmissbrauch zu verhindern und die täglichen bzw. in den letzten sieben Tagen aktiven Nutzer zu berechnen. Diese Cookies sind keinem angemeldeten Google-Konto zugeordnet und werden nicht zusammen mit den anderen Informationen protokolliert, die bei den API-Aufrufen erfasst werden.
- Ich finde keine Antwort auf meine Frage. An wen kann ich mich wenden?
-
Das Developer Relations-Team von Google ist ständig auf Stack Overflow aktiv, einer gemeinschaftlich redigierten Frage- und Antwort-Website für Programmierer. Hier können Sie technische Fragen zur Entwicklung und Verwaltung von Google Maps-Anwendungen stellen. Weitere Informationen zum Stellen von Fragen auf Stack Overflow finden Sie auf der Supportseite.
Berücksichtigen Sie bei Anfragen folgende Punkte, um die bestmögliche Hilfe zu erhalten:
- Suchen Sie in den aktuellen Diskussionen. Es besteht die Möglichkeit, dass bereits jemand ein ähnliches Problem festgestellt und eine Lösung gefunden hat.
- Geben Sie nach Möglichkeit einen Link zu Ihrer Website an. Posten Sie nur dann Code-Snippets, wenn der Code online nicht problemlos angesehen werden kann.
- Machen Sie alle erforderlichen Angaben, etwa zur Browserversion, zu Fehlern und zu allen anderen Dingen, die bei der Fehlerbehebung hilfreich sein könnten.
Fehler und Fehlerbehebung
- Was bedeutet dieser Fehler?
-
Wenn beim Laden oder Ausführen der Google Maps APIs ein Fehler auftritt, finden Sie unter den folgenden Links Erläuterungen zu den Fehlercodes:
- Meine Karten werden dunkler als sonst angezeigt. Woran liegt das?
-
Unter bestimmten Umständen werden dunkle Karten oder „negative“ Street View-Bilder ausgegeben, die mit dem Wasserzeichen „for development purposes only“ versehen sind. Das weist in der Regel auf Probleme mit einem API-Schlüssel oder der Abrechnung hin. Für die Verwendung von Google Maps Platform-Produkten ist ein Rechnungskonto erforderlich. Außerdem müssen alle Anfragen einen gültigen API-Schlüssel enthalten. Der folgende Ablauf hilft bei der Fehlerbehebung:
-
Wie behebe ich die Fehler
OVER_DAILY_LIMIT
undOVER_QUERY_LIMIT
? -
Diese Fehlercodes können aus einem der folgenden Gründe zurückgegeben werden:
- In der Anfrage fehlt ein API-Schlüssel.
- Der angegebene API-Schlüssel ist ungültig.
- Das Projekt ist nicht mit einem Rechnungskonto verknüpft.
- Das von Ihnen festgelegte Nutzungslimit wurde überschritten.
- Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
- Sie haben für eine bestimmte API die Kontingentlimits überschritten.
Für die Verwendung von Google Maps Platform-Produkten ist ein Rechnungskonto erforderlich. Außerdem müssen alle Anfragen einen gültigen API-Schlüssel enthalten. So beheben Sie das Problem:
- Richten Sie ein Abrechnungskonto ein.
- Fordern Sie einen neuen API-Schlüssel an.
- Passen Sie das Nutzungslimit an, um bei Bedarf Ihr Tageslimit zu erhöhen.
-
Wie behebe ich die Fehler
kGMSPlacesRateLimitExceeded
und9005 PLACES_API_RATE_LIMIT_EXCEEDED
? -
Falls
kGMSPlacesRateLimitExceeded
oder9005 PLACES_API_RATE_LIMIT_EXCEEDED
zurückgegeben wird, verwenden Sie unter Umständen eine verworfene Version des Places SDK for Android oder Places SDK for iOS. Weitere Informationen und die neuen SDKs finden Sie unter https://goo.gle/places-sdk-deprecation. - Wie behebe ich den Fehler „This IP, site or mobile application is not authorized to use this API key.“?
-
Dieser Fehler kann in verschiedenen Situationen ausgegeben werden:
- Sie haben für Ihren API-Schlüssel Einschränkungen vom Typ „IP-Adressen“ (Server) aktiviert und eine nicht autorisierte IP-Adresse versucht, eine Anfrage zu senden.
- Sie haben für Ihren API-Schlüssel Einschränkungen vom Typ „HTTP-Referrer“ (Website) aktiviert und ein nicht autorisierter Referrer versucht, eine Anfrage zu senden.
- Sie haben einen Paketnamen und Fingerabdruck festgelegt, um die Nutzung Ihrer Android-Apps einzuschränken, und eine nicht autorisierte Android-App versucht, eine Anfrage zu senden.
- Sie haben Bundle-IDs festgelegt, um Anfragen von iOS-Apps einzuschränken, und eine unbekannte iOS-App versucht, eine Anfrage zu senden.
- In der Vergangenheit konnte es zu diesem Fehler kommen, wenn eine der Web Service APIs mit einem API-Schlüssel mit Einschränkungen vom Typ „HTTP-Referrer“ verwendet wurde. Anfragen an diese APIs sollten mit einem API-Schlüssel mit Einschränkungen vom Typ IP-Adressen identifiziert werden. Ändern Sie den Einschränkungstyp des Schlüssels von „HTTP-Referrer“ zu „IP-Adressen“. Weitere Informationen finden Sie unter Best Practices für API-Schlüssel.
Anmeldedaten des API-Schlüssels ansehen und bearbeiten
So rufen Sie Ihre API-Schlüssel auf und verwalten die entsprechenden Einschränkungen:
- Rufen Sie in der Cloud Console die Seite „Anmeldedaten“ auf.
- Wählen Sie das Projekt mit dem API-Schlüssel aus, den Sie prüfen möchten.
- Klicken Sie in der Liste der API-Schlüssel auf den Schlüsselnamen, um die Details für die Anmeldedaten einschließlich eventuell festgelegter Einschränkungen für den Schlüssel zu sehen.
- Für den ausgewählten API-Schlüssel werden die vollständigen Anmeldedaten und alle Einschränkungen angezeigt, die dafür festgelegt wurden. Sie können die Einschränkungen nun nach Bedarf ändern, löschen oder aktualisieren.
- Wie behebe ich den Fehler „API keys with referer restrictions cannot be used with this API.“?
-
Sie verwenden eine der Web Service APIs mit einem API-Schlüssel mit einer Einschränkung vom Typ „HTTP-Referrer“. Aus Sicherheitsgründen muss für Web Service APIs ein API-Schlüssel mit einer Einschränkung auf den Typ IP-Adressen verwendet werden. Ändern Sie den Einschränkungstyp des Schlüssels von „HTTP-Referrer“ zu „IP-Adressen“. Alternativ können Sie auch einen neuen API-Schlüssel erstellen, wenn der Schlüssel bereits mit der Maps JavaScript API verwendet wird.
Google Maps Platform-Dienste
- Ich möchte Adressen in Längen- und Breitengradangaben umwandeln. Ist das mit der Google Maps Platform möglich?
-
Ja, das nennt man „Geocoding“. Die Maps JavaScript API enthält folgende Klasse zum Ausführen eines Geocoding-Diensts: google.maps.Geocoder.
Alternativ stellt Google auch die Geocoding API zur Verfügung, über deren REST-Schnittstelle Antworten im JSON- und XML-Format möglich sind.
- Für welche Länder ist Geocoding verfügbar?
-
Die Liste der Länder, die derzeit von den Geocodern der Google Maps Platform unterstützt werden, finden Sie unter Details zur Google Maps Platform-Abdeckung.
Die Genauigkeit der geocodierten Standorte variiert je nach Land. Daher sollten Sie die Verwendung des zurückgegebenen Felds location_type in Betracht ziehen. Damit lässt sich ermitteln, ob das gefundene Ergebnis für die Zwecke Ihrer Anwendung geeignet ist. Die Verfügbarkeit der Geocoding-Daten hängt von unseren Verträgen mit Datenanbietern ab und unterliegt aus diesem Grund Änderungen.
- Warum geben die Geocoder der Google Maps Platform andere Positionen an als Google Maps?
-
Je nach Land nutzen der API-Geocoder und der Google Maps-Geocoder gelegentlich verschiedene Datasets. Der API-Geocoder wird gelegentlich mit neuen Daten aktualisiert, die Ergebnisse werden sich also mit der Zeit ändern bzw. verbessern.
- Wie muss ich meine Geocodierungsabfragen formatieren, um die Anzahl erfolgreicher Anfragen zu maximieren?
-
Der Geocoder bildet Adressen in geografischen Koordinaten ab. Wir empfehlen daher, die Geocoder-Anfragen unter Berücksichtigung der folgenden Richtlinien zu formatieren, damit Ihre Abfragen möglichst erfolgreich sind:
- Geben Sie Adressen in dem Format an, das vom Postdienst des entsprechenden Landes verwendet wird.
-
Geben Sie keine zusätzlichen Adresselemente wie Firmennamen, Wohnungsnummern, Etagen- oder Büronummern an, die nicht im Format des Postdiensts des jeweiligen Landes vorkommen.
Das könnte zu Antworten mit
ZERO_RESULTS
führen. -
Formatieren Sie die Plus Codes wie hier gezeigt (Pluszeichen werden in der URL als
%2B
dargestellt, Leerzeichen als%20
):- Global Code besteht aus einem vierstelligen Code für das Gebiet und einem mindestens sechsstelligen lokalen Code (849VCWC8+R9 wäre beispielsweise
849VCWC8%2BR9
). - Compound Code ist ein mindestens sechsstelliger lokaler Code mit einem expliziten Ort (CWC8+R9 Mountain View, CA, USA wäre dann
CWC8%2BR9%20Mountain%20View%20CA%20USA
).
- Global Code besteht aus einem vierstelligen Code für das Gebiet und einem mindestens sechsstelligen lokalen Code (849VCWC8+R9 wäre beispielsweise
- Verwenden Sie nach Möglichkeit die Hausnummer eines Gebäudes und nicht den Gebäudenamen.
- Verwenden Sie möglichst Hausnummern anstelle von Straßenkreuzungen.
- Machen Sie keine Angaben zu nahe gelegenen Orientierungspunkten.
- Wie formatiere ich Adressen für US-Highways mit Nummernschema für das Geocoding?
-
Für den Geocoder von Google Maps Platform müssen nummerierte Highways in den USA so als Adressen angegeben werden:
-
County Roads:
"Co Road NNN"
, wobei NNN für die Straßennummer steht, z. B."Co Road 82"
-
State Highways:
"State NNN"
, wobei State für den vollständigen Namen des Bundesstaats und NNN für die Nummer des Highways steht, z. B."California 82"
-
U.S. Highways:
"U.S. NNN"
, wobei NNN für die Nummer des Highways steht, z. B."U.S. 101"
-
U.S. Interstates:
"Interstate NNN"
, wobei NNN für die Nummer der Interstate steht, z. B."Interstate 280"
-
County Roads:
- Wann verwende ich eine API-Geocoder-Klasse und wann den HTTP-Geocoding-Dienst?
-
Hier finden Sie die Vor- und Nachteile der verschiedenen Geocoding-Strategien.
- Wie kann ich mit der Google Maps Platform Wegbeschreibungen bereitstellen?
-
Mit dem Compute Routes-Dienst der Routes API und der Directions API können Sie Wegbeschreibungen zur Verfügung stellen. Dabei sind auch mehrere Zwischenstopps möglich. Routingoptionen bieten Ihnen die Möglichkeit, Wegbeschreibungen für ein Verkehrsmittel (Auto), eine oder mehrere Routen und Einschränkungen (keine Mautstraßen) auszugeben. Die Dienste sind in den folgenden Formen verfügbar:
- Schnittstelle für HTTP-Anfragen und ‑Antworten: wird in mobilen Apps und anderen Anwendungen verwendet und ist mit dem Maps SDK for Android und anderen Google Maps-Webdiensten kompatibel.
- JavaScript API: für clientseitige Anwendungen; ermöglicht die Bereitstellung von Wegbeschreibungen über die Klasse google.maps.DirectionsService. Mit der Klasse DirectionsRenderer kann das Steuerfeld für Overlays und Wegbeschreibung automatisch erstellt werden. Weitere Beispiele finden Sie in der Dokumentation.
- Schnittstellen von Java-, Python-, go- und Node.js-Clients für serverseitige Anwendungen bieten dieselben Funktionen. Weitere Informationen zu Clientbibliotheken finden Sie unter Directions API-Clientbibliotheken.
- Für welche Länder sind Wegbeschreibungen verfügbar?
-
Eine Liste der Länder, für die derzeit Wegbeschreibungen in den Google Maps Platform-Produkten unterstützt werden, finden Sie in den Details zur Google Maps Platform-Abdeckung. Die Verfügbarkeit der Daten für Wegbeschreibungen hängt von unseren Verträgen mit Datenanbietern ab und unterliegt aus diesem Grund Änderungen.
- Für welche Länder sind Routen für öffentliche Verkehrsmittel verfügbar?
-
Die Directions API und die Distance Matrix API unterstützen alle Google Transit-Partner, außer denen in Japan.
- Welche Funktionen von KML und GeoRSS werden in der Maps JavaScript API unterstützt?
-
Mit der Klasse KmlLayer in der Maps JavaScript API können Entwickler KML-/KMZ- und GeoRSS-Dateien als Overlay auf der Karte darstellen. Die entsprechende Dokumentation und Beispiele finden Sie hier.
- Welche Beschränkungen gelten für die Größe und Komplexität von KML-Dateien, die mithilfe der Klasse „KmlLayer“ der Maps JavaScript API angezeigt werden können?
-
Informationen zu den Beschränkungen für Größe und Komplexität von KML-Dateien, die mithilfe der Klasse
KmlLayer
angezeigt werden können, finden Sie hier. - Wie kann ich KML-Dateien, die auf Websites im Intranet gehostet werden, auf einer Karte rendern?
-
Die Klasse
KmlLayer
, über die KML-Overlays in der Maps JavaScript API generiert werden, verwendet einen von Google gehosteten Dienst, um KML-Dateien zum Rendern abzurufen und zu parsen. Daher können keine KML-Dateien dargestellt werden, die nicht unter einer öffentlich zugänglichen URL gehostet werden oder bei denen der Zugriff nur mit Authentifizierung möglich ist.Wenn Ihre Anwendungen KML-Dateien nutzen müssen, die im Intranet gehostet werden, sollten Sie JavaScript-Bibliotheken von Drittanbietern verwenden, um die KML-Dateien clientseitig zu rendern. Wenn die KML-Datei vom Browser analysiert wird, ist die Leistung unter Umständen geringer als bei der Verwendung der Klasse
KmlLayer
. - Wie viele Markierungen oder Pfadeckpunkte werden maximal von der Maps Static API unterstützt?
-
In der Maps Static API ist die Anzahl der unterstützten Markierungen und Pfadeckpunkte nicht begrenzt. Wenn Sie benutzerdefinierte Symbole verwenden, können pro Anfrage bis zu fünf eindeutige Symbole angegeben werden, sie lassen sich auf der Karte aber mehrfach einsetzen.
Maps Static API-URLs dürfen bis zu 8.192 Zeichen enthalten. Das schränkt die Anzahl der Markierungen und Pfadeckpunkte ein, die angegeben werden können. Die hängen nämlich von der Anzahl der Nachkommastellen ab, die für die einzelnen Längengrad- und Breitengradpaare verwendet werden. Weitere Informationen dazu, wie sich die Nachkommastellen auf die Genauigkeit der Darstellung auf der Weltkarte auswirken, finden Sie im Wikipedia-Artikel zu Dezimalgraden.
- Warum kann ich in bestimmten Ländern nicht auf Google Maps Platform-Produkte zugreifen?
-
Die Nutzung der Google Maps APIs in den Prohibited Territories ist untersagt. Weitere Informationen finden Sie in den Nutzungsbedingungen.
- Wie melde ich ein Problem auf der Google-Basiskarte?
-
In Google Maps können Sie Feedback zu falschen und fehlenden Karteninformationen geben:
- Falsche Adressen oder Markierungspositionen
- Falsche Straßennamen
- Falsche Angaben zu Ein- und Zweibahnstraßen
- Falsch eingezeichnete Straßen
- Gesperrte Straßen
- Nicht vorhandene Straßen
Wenn Sie einen Ort oder einen Brancheneintrag korrigieren möchten, können Sie eine Änderung vorschlagen.
Falls Inhalte gemäß geltendem Recht aus Google Maps entfernt werden müssen, reichen Sie ein rechtliches Ersuchen ein.
Bei kritischen oder dringenden Anliegen sollten Sie eine Supportanfrage erstellen und genau angeben, was korrigiert werden muss.
Einige clientseitige Funktionen melden die erfolgreiche Ausführung oder das Fehlschlagen von Diensten und werden für die Berechnung des SLO (Service Level Objective) verwendet.
Bei Aufrufen, die SLO-Daten protokollieren, werden diese über maps.googleapis.com/maps_api_js_slo/log
an Google gesendet.
Diese Informationen beinhalten Erfolgsstatus, Latenz und Version/Kanal der verwendeten Maps JavaScript API.
Die Aufrufe können in Batches zusammengefasst werden, um die Leistung zu verbessern.
Eventuell müssen Sie in Ihrer Content Security Policy maps.googleapis.com
zulassen, damit diese Aufrufe nicht auf Browserebene blockiert werden.
Beispiel: Content-Security-Policy: default-src 'self' maps.googleapis.com;
mit HTTP-Headern oder <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;">
mit HTML-Meta-Tags.
Maps JavaScript API
- Wie lange funktioniert die Maps JavaScript API nach dem Laden?
-
Sie müssen die Seite, auf der die Maps JavaScript API geladen wird, mindestens alle fünf Tage aktualisieren.
Google Maps SDK for iOS
-
Wie behebe ich den Fehler
kGMSPlacesRateLimitExceeded
? - Falls dieser Fehler zurückgegeben wird, verwenden Sie möglicherweise eine verworfene Version des Places SDK for iOS. Version 2.7.0 des Places SDK for iOS wurde deaktiviert und ist nicht mehr verfügbar. Bitte aktualisieren Sie Ihre App so schnell wie möglich auf die neueste Version. Weitere Informationen finden Sie in der Migrationsanleitung.
- Beim Debugging mit einem iOS 8.x-Gerät kommt es zu Abstürzen. Was soll ich tun?
-
Wenn beim Debugging mit iOS 8.x-Geräten Fehler auftreten, folgen Sie diesen Schritten, um die Erfassung von GPU-Frames in Ihrem Xcode-Schema zu deaktivieren:
- Wählen Sie in Xcode Product > Scheme > Manage Schemes aus.
- Wählen Sie ein Schema aus und klicken Sie auf Edit….
- Setzen Sie die Option GPU Frame Capture auf Disabled. Diese Option ist unter Umständen nicht für alle Geräte verfügbar.
- Welche Auswirkungen haben abgerundete und breitere Displays auf das Google Maps SDK for iOS?
-
Ab dem iPhone X haben iPhones ein Bildschirmformat mit abgerundeten Ecken und einer Aussparung für die Sensoren am oberen sowie einer Startbildschirmtaste am unteren Bildschirmrand. Mit dem iOS 11.0 SDK hat Apple die Safe Area API eingeführt. Damit können Entwickler Elemente so positionieren, dass sie nicht aufgrund des neuen Bildschirmformats abgeschnitten werden.
Das Google Maps SDK for iOS bietet viele visuelle Komponenten und Steuerelemente, z. B. eine Auswahl für Indoor-Karten und einen Link zum Melden von Problemen. In Version 2.4 konnte es passieren, dass diese durch das neue Bildschirmformat abgeschnitten wurden. Im Querformat wurde die Auswahl für Indoor-Karten unter Umständen durch die Aussparung am oberen Bildschirmrand oder die Startbildschirmtaste verdeckt.
In Version 2.5 des Google Maps SDK for iOS werden diese Layoutprobleme automatisch behoben. Wenn Ihre App auf einem iPhone X oder einem Nachfolgermodell verwendet wird, wird der Innenrand Karte für GMSMapView und GMSPanoramaView vergrößert, damit die visuellen Elemente nicht abgeschnitten werden.
Standardmäßig wird auch immer der Innenrand berücksichtigt, den Sie festgelegt haben. Im Google Maps SDK for iOS wird davon ausgegangen, dass der Innenrand innerhalb des sicheren Bereichs angewendet wird. Wenn Sie beim Entwickeln Ihrer Schnittstelle alle Elemente von vornherein im sicheren Bereich positionieren, müssen Sie also nichts weiter tun.
Für Schnittstellen, die die Standardanpassung nicht unterstützen, haben wir eine neue Eigenschaft namens paddingAdjustmentBehavior für „GMSMapView“ eingeführt. Sie können nun zwischen drei Einstellungen zur Anpassung des Innenrands wählen: „Immer“ (Standardeinstellung), „Automatisch“ und „Nie“.
Wenn Sie „Immer“ festlegen, werden die Werte für den sicheren Bereich immer zum Innenrand hinzugefügt. Sie können beim Entwickeln Ihrer Schnittstelle dann davon ausgehen, dass alle Elemente innerhalb der Grenzen des sicheren Bereichs positioniert werden. „Immer“ ist der Standardwert.
Wenn Sie „Automatisch“ festlegen, wird immer der größere Innenrand oder die Grenzen des sicheren Bereichs ausgewählt. Sie können dann den Innenrand vom Bildschirmrand hinzufügen und gleichzeitig dafür sorgen, dass alle Elemente im sicheren Bereich positioniert werden.
Wenn Sie „Nie“ angeben, werden die Werte für den sicheren Bereich nie zum Innenrand hinzugefügt. Das war das Verhalten vor Version 2.5. Es bietet sich an, wenn der sichere Bereich bereits bei den Abständen berücksichtigt wurde oder die anderen Einstellungen nicht gut mit Ihrer Benutzeroberfläche funktionieren. Sie müssen dafür sorgen, dass das Google-Logo und die Urheberrechtshinweise immer sichtbar sind (siehe Nutzungsbedingungen für die Google Maps Platform).
Für „GMSPanoramaView“ gibt es keine optionale Eigenschaft für Abstände. Sie müssen also keinen Innenrand anpassen. „GMSPanoramaView“ nimmt automatisch erforderliche Anpassungen vor, damit alle visuellen Elemente im sicheren Bereich positioniert werden.
Google Maps SDK for Android
-
Wie behebe ich den Fehler
9005 PLACES_API_RATE_LIMIT_EXCEEDED
? - Wenn dieser Fehler zurückgegeben wird, verwenden Sie möglicherweise eine eingestellte Version des Places SDK for Android. Die Google Play-Dienste-Version des Places SDK for Android wurde deaktiviert und ist nicht mehr verfügbar. Bitte aktualisieren Sie Ihre App so schnell wie möglich auf die neueste Version. Weitere Informationen finden Sie in der Migrationsanleitung.
- In meiner App werden nur leere graue Kacheln anstelle einer Karte angezeigt. Wie kann ich dieses Problem beheben?
-
Wenn statt einer Karte nur leere Kacheln zu sehen sind, liegt das oft an Problemen mit der Authentifizierung. So können Sie diese Probleme mithilfe von ADB Logcat beheben:
- Vergewissern Sie sich, dass ADB installiert ist. Falls nicht, folgen Sie dieser Anleitung.
- Installieren Sie die App, bei der das Problem auf einem Gerät oder einem Android-Emulator auftritt. Wenn Sie Android Emulator verwenden, muss in dessen Einstellungen der Play Store berücksichtigt sein.
- Führen Sie im Android Studio-Terminal
adb logcat -e "Google Maps Android API"
aus. Dann werden nur Zeilen mit dem Logeintrag „Google Maps Android API“ gedruckt. Optional kann das Log auch in eine Textdatei ausgegeben werden. Hierzu müssen Sie „>logcat.txt“ anhängen. - Reproduzieren Sie das Problem auf Ihrem Gerät und prüfen Sie, ob häufig anzutreffende Fehler wie etwa diese vorliegen:
- Im Manifest wird auf einen falschen/unbeabsichtigten API-Schlüssel verwiesen.
- Die Abrechnung für das Projekt wurde nicht aktiviert.
- Das SDK ist in Projekt-APIs nicht aktiviert.
- Die Einschränkungen für den API-Schlüssel enthalten den falschen SHA1-Fingerabdruck.
- Die Abhängigkeiten des Google Play-Dienstes sind nicht in der Datei
build.gradle
enthalten.
URL-Signatur
- Kann ich URLs mit JavaScript signieren?
-
Wir raten dringend davon ab, URLs mit JavaScript zu signieren. Ihr URL-Signatur-Secret wird dadurch nämlich für Endnutzer offengelegt. Signaturen sollten nur über serverseitige Komponenten generiert werden.
- Warum wird für meine Maps API-Webdienstanfragen der Fehler „HTTP 403 Forbidden“ zurückgegeben?
-
HTTP 403-Antworten weisen auf ein Berechtigungsproblem hin. Wahrscheinlich konnte die Signatur für die Anfrage nicht verifiziert werden. Mögliche Gründe:
- Es wurde zwar eine Signatur angegeben, aber es war nicht die richtige für diese Anfrage.
- In der Anfrage ist ein API-Schlüssel für die Google Maps Platform-Premiumoption angegeben, jedoch keine Signatur. Für den aufgerufenen Dienst müssen alle Anfragen, die mit einem API-Schlüssel authentifiziert werden, eine gültige Signatur enthalten.
- Es wurde zwar eine Signatur angegeben, aber nicht der zugehörige API-Schlüssel der Google Maps Platform-Premiumoption.