Premium Plan Usage Reports

Hinweis: Du kannst dich nicht mehr für den Google Maps Platform Premium Plan registrieren. Auch für Neukunden ist er nicht mehr verfügbar.

Diese Seite richtet sich nur an Kunden mit der neuen Version von Google Maps Platform Premium Plan, die seit Januar 2016 verfügbar ist.

Hast du den Premium Plan oder eine ältere Lizenz?
So findest du heraus, welche Lizenz du hast:
> Klicke im Google Cloud-Supportportal links auf Maps: Usage Report (Maps: Nutzungsbericht).
> Hat die ID oben im Bericht das folgende Format?
gme-[company] & proj-[number] ([type])
Falls ja, hast du die Premiumoption.
Wenn nicht, hast du eine ältere Lizenz (Maps APIs for Work oder Maps API for Business).

Überblick

Als Premium Plan-Kunde kannst du mithilfe des Tools Google Maps Usage Reports für deine Anwendung die Nutzung von Google Maps Platform und den dazugehörigen Verbrauch von Maps APIs Credits verfolgen. Mithilfe des Tools kannst du detaillierte tägliche und monatliche Berichte zu allen in deinem Google Maps Platform Premium Plan enthaltenen APIs abrufen. Es sind Berichtsdaten für API-Anforderungen verfügbar, die entweder eine Client-ID oder eine Projekt-ID enthalten.

Hinweis: Das Usage Reports-Tool stellt dieselben Informationen zur Verfügung, die Google verwendet, um die Nutzung deiner Anwendung zu Abrechnungszwecken zu ermitteln.

Berichtstypen

Bericht über erfolgreiche Anforderungen (Successful Requests)

Dieser Bericht enthält die Gesamtzahl der Anforderungen deiner Anwendung für jede API pro Tag oder Monat. Verwende diesen Bericht für den Vergleich von Nutzungsdaten in verschiedenen Zeiträumen, um Trends und Spitzennutzungszeiten zu ermitteln. Darüber hinaus können im Bericht „Successful Requests“ folgende Daten angezeigt werden:

Anforderungsfehler: Für jede API enthält der tägliche Bericht auch die Anzahl der erfolgreichen oder nicht erfolgreichen Anforderungen (Fehler). Für Web Service APIs, auf die deine Anwendung mithilfe einer Client-ID zugreift, enthält der Bericht auch Fehlercodes, die nützlich für die Fehlerbehebung sind.

Kanaldaten: Wenn du den Parameter „channel“ in deine Anforderungen einfügst, kannst du einen Bericht vom Typ „Successful Requests“ erstellen, der eine Aufschlüsselung der API-Anforderungen deiner Anwendung nach verschiedenen Anwendungen enthält, die dieselbe Client-ID verwenden (z. B. externer Zugriff im Vergleich zum internen Zugriff). Mithilfe von Kanälen kannst du Berichte mit detaillierteren Daten zur Nutzung deiner Anwendung generieren.

Maps APIs Credits-Bericht

Dieser Bericht enthält den gesamten Credits-Verbrauch deiner Anwendung pro Tag oder Monat kombiniert für alle APIs. Mit diesem Bericht kannst du ermitteln, wie viele Credits du erwerben musst. Informationen zur Nutzung von Credits für deine Anwendung findest du unter Nutzungsraten und -beschränkungen.

Berichtsmerkmale

Leicht verständliche Diagramme: Tägliche Berichte enthalten Diagramme, die dir dabei helfen, Nutzungstrends über Zeiträume hinweg zu visualisieren. Detaillierte Berichtsdaten werden angezeigt, wenn du den Mauszeiger auf das Diagramm bewegst.
Bisherige Daten: Du kannst Berichte für jeden gewünschten Zeitraum im vergangenen Jahr aufrufen.
Herunterladbare Daten: Lade mithilfe eines Tabellenkalkulationsprogramms oder Business Intelligence-Tools die gesamten monatlichen Anforderungen und Credits in eine CSV-Datei herunter, um die Daten weiter zu analysieren oder gemeinsam mit anderen zu nutzen.
Datenaufschlüsselung: Greife direkt von den monatlichen Berichten aus auf tägliche Berichte zu, indem du auf die monatlichen Gesamtwerte oder die Spaltenüberschriften im Bericht klickst. Beispiel:

Usage Reports aufrufen

So greifst du auf Google Maps Usage Reports zu:

Melde dich im Google Cloud-Supportportal an.
Klicke links auf Maps: Usage Report.

Berichte erstellen

Der Standardbericht ist der monatliche Bericht „Successful Requests“ für die vergangenen 12 Monate. Verwende zum Erstellen verschiedener Berichte die Berichtsfilter:

Filter	Beschreibung
Client ID	Nur verfügbar, wenn du mehrere Client-IDs hast. Wähle die Client-ID aus, für die du Berichte aufrufen möchtest.
Channel ID	Verfügbar nur für Berichte vom Typ „Successful Requests“. Wähle einen Kanal aus, für den du Nutzungsdaten anzeigen möchtest. Oder wähle Show all aus, um die Nutzungsdaten für alle Kanäle zu sehen.
From/To	Wähle einen Zeitraum für den Bericht aus (maximal 1 Jahr). Klicke auf „Update“, um einen neuen Bericht zu generieren.
Type of report	Wähle den Bericht Successful Requests oder Maps APIs Credits aus.
Select time granularity	Wähle den Bericht Monthly oder Daily aus. Monatliche Berichte enthalten auch Links zu täglichen Berichten. Tägliche Berichte umfassen erfolgreiche und nicht erfolgreiche Anforderungen sowie Fehlercodes.
API type	Verfügbar nur für tägliche Berichte. Wähle die API aus, für die du einen Bericht aufrufen möchtest.

Häufig gestellte Fragen

Bericht über erfolgreiche Anforderungen (Successful Requests)

Wie lange dauert es, bis die Nutzungsdaten in den Berichten angezeigt werden?

Berichtsdaten stehen nicht in Echtzeit zur Verfügung. Nutzungsdaten für Anforderungen, die mit einer Client-ID durchgeführt werden, werden auf täglicher Basis verarbeitet. Weil die Berichtsdaten auf Pacific Standard Time (PST) basieren, kann es einige Tage dauern, bis die Daten aktualisiert werden. Daten für Anforderungen, die mithilfe eines API-Schlüssels durchgeführt werden, müssen weiterverarbeitet werden. Daher kann es bis zu 3 Tage dauern, bis diese Daten in den Berichten erscheinen.

Was sind Maps JavaScript API-Kartenaufrufe? Inwiefern unterscheiden sie sich von Seitenaufrufen?

Beim Google Maps Platform Premium Plan wird die Nutzung der Maps JavaScript API durch Kartenaufrufe bestimmt. Das heißt, es wird ermittelt, wann Karten tatsächlich auf einer Seite angezeigt werden. Kartenaufrufe unterscheiden sich von Seitenaufrufen, die eingesetzt wurden, um die Maps JavaScript API-Nutzung bei Verwendung der früheren Maps API for Business- oder Maps APIs for Work-Lizenzen zu berechnen. Weitere Informationen findest du unter Nutzungsraten und -beschränkungen.

Warum stimmt die Anzahl der Kartenaufrufe nicht mit den Zugriffsstatistiken auf unseren Webservern überein?

Nachfolgend findest du einige Gründe, warum die Anzahl der Kartenaufrufe auf einer Seite von der Anzahl der Treffer für diese URL in den Protokollen deines Webservers abweicht:

Die Kartennutzung auf einer Seite kann variieren: Jedes Mal, wenn das google.maps.Map-Objekt auf einer Seite erstellt wird, wird ein Kartenaufruf generiert. Wenn du Berichte zu Kartenaufrufen mit den Zugriffsstatistiken deines Webservers vergleichst, solltest du die Nutzung der Karten auf jeder deiner Webseiten sorgfältig analysieren, um beispielsweise nach folgenden Ursachen für Abweichungen zu suchen:
- Eine Seite enthält mehrere Karten, sodass mehrere Map-Objekte erstellt werden.
- Auf einer Seite wird zwar keine Karte angezeigt, das Map-Objekt wird aber trotzdem erstellt. Das kann beispielsweise geschehen, wenn das Map-Objekt an ein verborgenes HTML-Objekt vom Typ div angehängt wird.
- Eine Seite verlangt eine Nutzeraktion (beispielsweise das Klicken auf eine Schaltfläche), um eine Karte anzuzeigen. Wenn ein Nutzer diese Aktion nicht ausgeführt hat, wurde kein Map-Objekt erstellt.
- Eine Seite enthält keine Karten, daher wurde kein Map-Objekt erstellt.

Unterschiedliche Zeitzonen: Berichte werden aus Protokollen abgeleitet, für die die Zeitzone Pacific Time festgelegt ist. Du kannst deine Serverprotokolle basierend auf der Zeitzone „Pacific Time“ analysieren, um Abweichungen zu reduzieren, die durch die Protokollierung in deiner lokalen Zeitzone verursacht werden.
HTML wird im Cache gespeichert: Kartenaufrufe werden nicht im Cache gespeichert. Wenn ein Nutzer deine Seite aktualisiert, wird dadurch ein weiterer Kartenaufruf generiert, um ein Sitzungstoken abzurufen. In diesem Fall lädt der Browser den HTML-Code jedoch möglicherweise aus dem Cache, sodass die Anzahl der Kartenaufrufe höher ist als die Anzahl der Treffer in den Serverprotokollen.

Warum ist die Anzahl der Anforderungen für die Distance Matrix API höher als erwartet?

Der Distance Matrix API-Bericht enthält die Anzahl der Elemente (Quelle-Ziel-Paare) anstelle der Anforderungen. Weitere Informationen zu Elementen findest du im Entwicklerhandbuch.

Anforderungsfehler

Wie kann ich die Anforderungsfehler meiner Anwendung anzeigen?

Erstelle einen täglichen Bericht über erfolgreiche Anforderungen und wähle dann in der Liste API type eine API aus. Du siehst nun ein Diagramm und eine Tabelle, in dem bzw. der die von der Anwendung durchgeführte Anzahl der erfolgreichen und nicht erfolgreichen Anforderungen angezeigt wird. Für Web Service APIs, auf die deine Anwendung über eine Client-ID zugreift, werden außerdem die von den Anforderungen zurückgegebenen Statuscodes angezeigt.

Was bedeuten die Statuscodes?

Das Usage Reports-Tool zeigt Statuscodes für die Web Service APIs an, auf die deine Anwendung über eine Client-ID zugreift. Im Entwicklerhandbuch findest du Beschreibungen der Codes für jede API:

Für die Geolocation API, Places API und Roads API ist immer ein API-Schlüssel erforderlich. Prüfe in der Developers Console die Statuscodes für diese und andere APIs, auf die deine Anwendung über einen Schlüssel zugreift.

Werden Maps APIs Credits von fehlerhaften Anforderungen verbraucht?

Nein, Anforderungen, die einen Fehlercode erhalten, verbrauchen keine Credits. Anforderungen, die die Codes OK oder ZERO_RESULTS erhalten, verbrauchen jedoch Credits.

Kanaldaten

Was sind Kanäle?

Du kannst den Parameter channel bei deinen API-Anfragen verwenden, um die Nutzung verschiedener Anwendungen unter Verwendung derselben Client-ID oder desselben API-Schlüssels nachzuverfolgen. Durch Angabe unterschiedlicher channel-Werte für verschiedene Aspekte einer Anwendung kannst du ganz genau feststellen, wie deine Anwendung genutzt wird.

Beispiel: Deine externe Website greift möglicherweise über den auf customer festgelegten Parameter channel auf eine API zu, während die interne Marketingabteilung gegebenenfalls einen auf mkting eingestellten Parameter channel verwendet. In deinen Berichten wird die Nutzung der API nach diesen Kanalwerten aufgeschlüsselt.

Welche APIs unterstützen Kanäle?

Kanalberichte sind für Anwendungen verfügbar, die die Maps JavaScript API, Maps Static API, Street View Static API und Google Maps Platform-Webdienste verwenden. Kanäle sind nicht verfügbar für die Geolocation API, die Places API, die Roads API und die Maps Mobile SDKs.

Wie viele Kanäle kann ich verwenden?

Du kannst bis zu 2.000 unterschiedliche Kanäle pro Client-ID oder API-Schlüssel verwenden.

Wie richte ich Kanäle für die Anforderungen meiner Anwendung ein?

Der Wert des Parameters channel in deinen Anfragen muss die folgenden Anforderungen erfüllen:

Er muss ein alphanumerischer ASCII-String sein.
Er kann einen Unterstriche (_) und Bindestriche (-) enthalten.
Groß-/Kleinschreibung wird nicht berücksichtigt: Werte des Parameters channel in Großbuchstaben oder einer Kombination aus Groß- und Kleinbuchstaben werden in das entsprechende Äquivalent in Kleinbuchstaben zusammengeführt. So wird beispielsweise die Nutzung auf dem Kanal CUSTOMER mit der Nutzung auf dem Kanal customer kombiniert.
Es muss sich um eine statische und instanzweise zugewiesene Anwendung handeln (sie kann nicht dynamisch generiert werden). Du kannst beispielsweise Kanalwerte nicht zum Erfassen einzelner Nutzer verwenden.

Füge den Parameter „channel“ so deinen Anforderungen hinzu:

Clientseitige APIs

Hänge den Parameter „channel“ an den Wert „src“ des Skript-Tags an:

<script src="https://maps.googleapis.com/maps/api/js?v=3
&client=gme-yourclientid
&channel=your_channel"></script>

Maps Static API und Street View Static API

Füge in die Anforderungs-URL den folgenden Parameter „channel“ ein:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Webdienste

Füge in die Anforderungs-URL den folgenden Parameter „channel“ ein:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Maps APIs Credits-Bericht

Was sind Maps APIs Credits?: Die API-Anforderungen deiner Anwendung verbrauchen Maps APIs Credits aus einem Pool von Credits, die du mit dem Google Maps Platform Premium Plan erwirbst. Weitere Informationen zu Credits und dazu, wie diese von deiner Anwendung verbraucht werden, findest du unter Nutzungsraten und -beschränkungen.
Wie lange dauert es, bis die Credits in den Berichten angezeigt werden?