Berichterstellung für die Google Maps Platform

Über die Funktion zur Berichterstellung in der Google Maps Platform stehen Ihnen mehrere vordefinierte Berichte mit visuell dargestellten Werten zur Verfügung. Damit bekommen Sie in der Cloud Console einen Überblick über Ihre API-Nutzung, Ihre API-Kontingente und Ihre API-Abrechnungsinformationen. Durch die Berichte erhalten Sie Aufschluss über die Anzahl Ihrer API-Aufrufe, darüber, wie weit Sie Ihre API-Nutzungskontingente bereits ausgeschöpft haben, und über die Entwicklung Ihrer Abrechnungsdaten im Zeitverlauf.

Folgende Berichtstypen sind verfügbar:

• Nutzungsberichte: Hiermit wird erfasst, wie viele Anfragen von Ihrem Projekt an die Google Maps Platform-APIs gesendet werden. Die Zuordnung erfolgt dabei anhand der Anmeldedaten, die mit Ihrem Projekt verknüpft sind.
• Kontingentberichte: Die Kontingentnutzung wird in Diagrammen dargestellt, die in Anfragen pro Minute gruppiert werden können. Die aktuellen Kontingentlimits für ausgewählte APIs werden in Tabellen unterhalb der Diagramme zur Kontingentnutzung angezeigt.
• Abrechnungsberichte: Die Kosten im Zeitverlauf werden als gestapeltes Liniendiagramm dargestellt. Die Kontingentnutzung des aktuellen Monats wird zusammen mit nutzungsspezifischen Gutschriften (sofern vorhanden) und den prognostizierten Gesamtkosten für den kompletten aktuellen Monat angezeigt.
• Berichte zur Interaktion: Die Berichte enthalten Informationen dazu, wie Nutzer mit Ihren Karten-Apps interagieren.

Unter Antwortstatus und ‑berichte finden Sie eine komplette Liste der Antwortstatus und Antwortcodes, nach denen sich richtet, ob eine Anfrage im Nutzungsbericht, Kontingentbericht und/oder Abrechnungsbericht berücksichtigt wird.

Die Berichte zur Nutzung, zum Kontingent und zur Abrechnung der Google Maps Platform rufen Sie in der Cloud Console ab.

Nutzungsberichte

Die Nutzung basiert auf der Anzahl der Anfragen, die von Ihrem Projekt an die Google Maps Platform-APIs gesendet werden. Die Zuordnung erfolgt dabei anhand der Anmeldedaten, die mit Ihrem Projekt verknüpft sind. Als Anfragen zählen sowohl erfolgreiche Anfragen als auch Anfragen mit Server- oder Clientfehlern. Die Anmeldedaten umfassen API-Schlüssel und Client-IDs (für reguläre und migrierte Premiumoptions-Projekte). Details finden Sie unter Premiumoption – Übersicht und im Abschnitt Client-ID.

Die Nutzungsmesswerte werden in Tabellen („Anfragen“, „Fehler“ und „Latenz“) und in Diagrammen („Traffic“, „Fehler“ und „Latenz“) angezeigt. Nutzungsmesswerte für Tracking-Zwecke:

• Alle APIs: Zum Filtern und Gruppieren von Nutzungsmesswerten für alle APIs gibt es folgende Möglichkeiten:

  • Nach Zeitraum und API filtern
  • Traffic, Fehler und Latenz nach Antwortcode, API und Anmeldedaten gruppiert darstellen

• Bestimmte API: Zum Filtern und Gruppieren von Nutzungsmesswerten für eine bestimmte API gibt es folgende Möglichkeiten:

  • Nach Zeitraum, API-Versionen, Anmeldedaten und Methoden filtern
  • Traffic, Fehler und Latenz nach Antwortcode, API-Methode und ‑Version sowie Anmeldedaten gruppiert darstellen

Dashboard-Seite „APIs & Dienste“

Auf der Dashboard-Seite „APIs und Dienste“ finden Sie eine Übersicht über die Nutzungsmesswerte aller für Ihr Projekt aktivierten APIs – der Google Maps Platform-APIs sowie anderer Google-APIs und ‑Dienste.

• Die Dashboard-Seite enthält drei Diagramme und eine Tabelle. Sie können die Nutzungsmesswerte in diesen Diagrammen und Tabellen filtern, indem Sie einen Zeitraum zwischen einer Stunde und den letzten 30 Tagen auswählen.

• Im Diagramm Traffic wird die Nutzung in Abfragen pro Sekunde (Queries per Second, QPS) pro API angezeigt.

• Das Diagramm Fehler gibt Aufschluss über den Prozentsatz der Anfragen pro API, die zu Fehlern geführt haben.

• Im Diagramm Latenz ist die Medianlatenz der Anfragen pro API zu sehen.

Unter den Diagrammen werden die aktivierten APIs und Dienste in einer Tabelle aufgeführt. „Anfragen“ steht für die Anzahl der Anfragen im ausgewählten Zeitraum. „Fehler“ bezieht sich auf die Anzahl der Anfragen, die zu Fehlern geführt haben. Unter „Latenz“ (mittlere Latenz und Perzentil) wird die Latenz dieser Anfragen angezeigt.

So greifen Sie auf die Dashboard-Seite „APIs & Dienste“ zu:

1. Öffnen Sie in der Cloud Console die Seite für die Projektauswahl:

   Seite für die Projektauswahl

2. Wählen Sie Ihr Projekt aus. Die Dashboard-Seite „APIs & Dienste“ wird angezeigt.
   
   Wenn die Seite nicht angezeigt wird, klicken Sie auf die Menüschaltfläche  und wählen Sie APIs & Dienste aus.

Weitere Informationen finden Sie unter API-Nutzung beobachten.

Übersichtsseite für Google Maps

Auf der Seite Übersicht finden Sie eine Tabelle mit den aktivierten APIs und Nutzungsanfragen der letzten 30 Tage. Anfragen nach API werden auch in grafischer Form dargestellt. In einem Abrechnungsdiagramm sehen Sie Ihre aktuelle Rechnung und die Gesamtnutzung der letzten drei Monate.

Hinweis: Wenn Sie den Namen einer aktivierten API auswählen, werden Sie zur Google Maps Platform-Seite Messwerte für diese API weitergeleitet.

So greifen Sie auf die Übersichtsseite für die Google Maps Platform zu:

1. Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:

   Zur Seite „Google Maps Platform“

2. Wählen Sie im Menü auf der linken Seite Übersicht aus.

Google Maps Platform – Seite „APIs“

Auf der Seite APIs finden Sie zwei Tabellen. Die Tabelle Aktivierte APIs gibt für jede aktivierte API Aufschluss über die Anzahl der Anfragen und Fehler sowie über die durchschnittliche Latenz in den letzten 30 Tagen. In der Tabelle Zusätzliche APIs sind APIs aufgeführt, die nicht aktiviert sind.

Hinweis: Wenn Sie den Namen einer aktivierten API auswählen, werden Sie zur Google Maps Platform-Seite Messwerte für diese API weitergeleitet.

So greifen Sie auf die Google Maps Platform-Seite „APIs“ zu:

1. Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:

   Zur Seite „Google Maps Platform“

2. Wählen Sie im Menü auf der linken Seite APIs aus.

Google Maps Platform – Seite „Messwerte“

Auf der Seite Messwerte sehen Sie drei Diagramme: „Traffic“, „Fehler“ und „Medianlatenz“. Die Nutzungsdaten in den Diagrammen können nach Antwortcodeklasse, API, API-Methode, Anmeldedaten, Plattform und Domain gruppiert werden.

Unterhalb der Diagramme auf der Seite Messwerte wird eine API-Tabelle mit Anfragen, Fehlern und Latenz der von Ihnen ausgewählten APIs angezeigt.

Über das Drop-down-Menü „APIs“ oben und die Optionen im rechten Bereich lassen sich die angezeigten Nutzungsmesswerte gruppieren und filtern. Dazu können Sie einzelne oder auch mehrere APIs, Anmeldedaten, Antwortcodeklassen, Plattformtypen und/oder Domains auswählen. Sie haben auch die Möglichkeit, einen Zeitraum (eine Stunde bis die letzten 30 Tage) und den Detaillierungsgrad (pro Sekunde oder pro Tag) für die angezeigten Nutzungsmesswerte festzulegen.

Hinweis: Die Optionen Plattform und Domain in der Drop-down-Liste Gruppiert nach und die Filter Plattform und Domain sind nur verfügbar, wenn eine einzelne API aus der entsprechenden Drop-down-Liste ausgewählt wurde.

Auf den folgenden Bildern sind die Filter Plattform und Domain für eine einzelne API zu sehen, nachdem in der Drop-down-Liste Gruppiert nach Plattform und Domain ausgewählt wurden:

So rufen Sie die Google Maps Platform-Seite „API-Messwerte“ auf:

1. Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:

   Zur Seite „Google Maps Platform“

2. Wählen Sie im Menü auf der linken Seite Messwerte aus.

Berichte zu Anmeldedaten

Sie können Messwerte nach den Anmeldedaten filtern und gruppieren, die zum Laden der API verwendet wurden.

Format der Anmeldedaten	Bedeutung
Schlüsselname Zum Beispiel: „App-Schlüssel“	Ein API-Schlüssel wurde verwendet, um die API mit ?key=... zu laden: Die Schlüsselnamen finden Sie in der Google Maps Platform Console unter Schlüssel und Anmeldedaten.
Projektnummer Zum Beispiel: „project_number:123456“ (hier ist „123456“ die Projektnummer)	Wenn Sie diese Anmeldedaten sehen, gibt es zwei Möglichkeiten: APIs, die Maps Platform-Client-IDs unterstützen: Die API wurde mit einer Maps Platform-Client-ID geladen, z. B. mit &client=gme-_mycompany_. Folgende APIs unterstützen Client-IDs: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, Distance Matrix API, Geocoding API, Time Zone API. Weitere Informationen finden Sie auf der Seite Authentifizierung für die Premiumoption unter „Client-ID-Verwaltung“. APIs, die OAuth unterstützen: Die API wurde mit OAuth ohne API-Schlüssel geladen.

Hinweis: Es gibt keine Maps Platform-APIs, die sowohl Maps Platform-Client-IDs als auch OAuth unterstützen. Die verwendete API gibt also Aufschluss darüber, ob die API mit einer Client-ID oder OAuth geladen wurde.

Antwortcode-Diagramme

In den Diagrammen Traffic nach Antwortcode und Fehler nach Antwortcode wird die Nutzung nach HTTP-Antwortcodeklasse aufgeteilt. Die folgende Tabelle zeigt die Zuordnung zwischen dem Antwortstatus und der HTTP-Antwortcodeklasse der Google Maps Platform-API:

Google Maps API-Status	HTTP-Antwortcodeklasse – Nutzungsbericht (2xx, 3xx, 4xx, 5xx)	Anmerkungen
OK	2xx	Erfolgreiche Antwort. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
OK	3xx	Erfolgreiche Antwort. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet. Beispiel: Bei erfolgreichen Place Photo-Anfragen wird eine „302 Weiterleitung“ an das referenzierte Bild zurückgegeben.
DATA_NOT_AVAILABLE	4xx^(1)	Erfolgreiche Antwort, die besagt, dass für die eingegebenen Orte keine Daten zur Verfügung stehen. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
ZERO_RESULTS	4xx^(1)	Die Antwort war erfolgreich, aber es wurde kein Ergebnis zurückgegeben. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
NOT_FOUND	4xx^(1)	Bei der Directions API bedeutet das, dass mindestens einer der Orte, die in der Anfrage als Ausgangsort, Zielort oder Wegpunkt angegeben wurden, nicht geocodiert werden konnte. Bei der Places API bedeutet das, dass der referenzierte Ort (place_id) in der Places-Datenbank nicht gefunden wurde. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
INVALID_REQUEST (ungültiger Parameterwert), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED usw.	4xx	Fehler aufgrund eines ungültigen Parameterwerts. Weitere Informationen finden Sie in der API-Antwort. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
REQUEST_DENIED	4xx	Clientfehler, der durch Authentifizierungsfehler, Zugriffsfehler usw. verursacht wird. Weitere Informationen finden Sie in der API-Antwort.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	Clientfehler, der durch zu viele Anfragen im zulässigen Zeitraum verursacht wird. Wiederholen Sie die Anfrage später. Weitere Informationen finden Sie in der API-Antwort.
INVALID_REQUEST (ungültiger oder fehlender Parameter, Fehler beim Parsen oder Validieren der Anfrage)	4xx	Clientfehler aufgrund einer ungültigen Anfrage. Weitere Informationen finden Sie in der API-Antwort.
NOT_FOUND (404)	4xx	Bei der Geolocation API bedeutet das, dass die eingegebenen Daten nicht für eine Standortschätzung gereicht haben. Bei der Roads API bedeutet das, dass die Eingaben nicht sinnvoll an Straßen ausgerichtet werden konnten. Diese Anfrage ist kostenpflichtig und wird auf das Kontingent angerechnet.
UNKNOWN_ERROR	5xx	Serverfehler, der angibt, dass die Anfrage nicht fortgesetzt werden kann (z. B. interner Fehler, Dienst überlastet, Dienst nicht verfügbar oder Zeitüberschreitung).
^1 Damit einheitlichere Fehlercodes zurückgegeben werden können, werden die Google Maps Platform APIs umgestellt: 1) von HTTP-Antwortcodeklasse 2xx auf 4xx für folgende Maps API-Status: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – Status, 2) von HTTP-Antwortcodeklasse 2xx auf 4xx für folgende Maps API-Status: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) von HTTP-Antwortcodeklasse 2xx auf 5xx für folgenden Maps API-Status: UNKNOWN_ERROR. In der Übergangsphase sehen Sie beide Antwortcodes. Die Antwortcodes, die in Google Maps API-Antworten zurückgegeben werden, ändern sich nicht. Sie können prüfen, ob eine Zunahme von 4xx- und/oder 5xx-Meldungen auf der Seite „Messwerte“ in der Google Maps Platform auf diese Migration zurückzuführen ist. Dazu sehen Sie im Metrics Explorer nach, für welchen spezifischen Antwortcode mehr Meldungen ausgegeben werden. Weitere Informationen zur Verwendung von Cloud Monitoring für die Google Maps Platform

Weitere Informationen zu Statuscodes und Fehlermeldungen finden Sie in der Antwortdokumentation für die jeweilige API (z. B. Geocoding-Antworten oder Directions-Antworten).

Google Maps Platform – Lösungsparameter

In der Google Maps Platform stehen zahlreiche Arten von Beispielcode für einen schnellen Einstieg zur Verfügung. Sie können beispielsweise Quick Builder in der Cloud Console verwenden, den Implementierungsanleitungen für Branchenlösungen folgen und sich in Codelabs informieren.

Wir möchten wissen, wie unsere Lösungen genutzt werden und wie wir sie weiter verbessern können. Deshalb nehmen wir den solution_channel-Abfrageparameter in API-Aufrufe auf, um so Informationen zur Verwendung von Beispielcode zu erhalten.

• Der solution_channel-Abfrageparameter ist standardmäßig im Beispielcode der Lösung enthalten.
• Dieser Parameter gibt Analysen zur Übernahme einzelner Lösungen an Google zurück, sodass wir bei künftigen Iterationen die Qualität verbessern können.
• Sie können die Funktion deaktivieren, indem Sie den solution_channel-Abfrageparameter und zugehörigen Wert aus dem Beispielcode löschen.
• Dieser Parameter muss nicht beibehalten werden. Wenn Sie ihn entfernen, wirkt sich das nicht auf die Leistung aus.
• Mit diesem Parameter werden lediglich Daten zur Nutzung des Beispielcodes erfasst.
• Der Abfrageparameter ist unabhängig von API-spezifischen Analysen und Berichten. Das heißt: Wenn Sie ihn aus dem Beispielcode der Lösung entfernen, werden interne Maps JavaScript API-Berichte dadurch nicht deaktiviert.

Kontingentberichte

Durch Kontingente werden Limits für die Anzahl der Anfragen festgelegt, die von Ihrem Projekt an die Google Maps Platform-APIs gesendet werden können. Anfragen können auf drei Arten begrenzt werden: pro Tag, pro Minute sowie pro Nutzer und Minute. Nur erfolgreiche Anfragen und solche, die zu Serverfehlern führen, werden auf das Kontingent angerechnet, nicht jedoch Anfragen, bei denen die Authentifizierung fehlschlägt.

Die Kontingentnutzung wird in der Cloud Console auf der Seite Kontingente in Diagrammen angezeigt und kann in Anfragen pro Minute gruppiert werden. Die aktuellen Kontingentlimits für ausgewählte APIs werden in Tabellen unterhalb der Diagramme zur Kontingentnutzung angegeben.

Mit diesem Rechner können Sie den Kontingentwert pro Minute für jedes GMP API-Produkt ermitteln.

Google Maps Platform – Seite „Kontingente“

Auf der Seite Kontingente sehen Sie Informationen zu Kontingentlimits und ‑verbrauch für die jeweilige API.

Im Diagramm zur Kontingentnutzung in der Google Cloud Console wird der gesamte Traffic für Ihre API-Schlüssel und Client-IDs dargestellt. Der Client-ID-Traffic ist auch im Messwertdiagramm in der Cloud Console verfügbar.

Auf der Seite werden nur Anfragen aufgeführt, die auf das Kontingent angerechnet werden: erfolgreiche Anfragen (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) und Anfragen, die zu Serverfehlern führen (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE [ungültiger Parameterwert], UNKNOWN_ERROR).

Anfragen, die Clientfehler verursachen, etwa bei der Authentifizierung, der Autorisierung oder durch ungültige Argumente (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST [ungültiger Parameter, Fehler beim Parsen der Anfrage]), werden nicht auf das Kontingent angerechnet und daher nicht aufgeführt.

Für die meisten Google Maps Platform-APIs (Maps Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API und Elevation API) ist die Kontingenteinheit jeweils eine Anfrage, es gibt aber einige Ausnahmen:

• Für die Distance Matrix API ist die Kontingenteinheit ein Element, das aus einem Start-Ziel-Paar besteht.
• Für die Maps JavaScript API ist die Kontingenteinheit ein Kartenaufruf.
• Für das Maps SDK for Android und das Maps SDK for iOS ist die Kontingenteinheit eine Street View-Anfrage oder ein Panoramaaufruf. Kartenaufrufe sind kostenlos und werden nicht auf das Kontingent angerechnet.

So rufen Sie die Google Maps Platform-Seite „Kontingente“ auf:

1. Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:

   Zur Seite „Google Maps Platform“

2. Wählen Sie im Menü auf der linken Seite Kontingente aus.
3. Wählen Sie aus der Drop-down-Liste „API“ eine API aus.

Kontingenteinheiten

In der folgenden Tabelle sehen Sie die Kontingenteinheiten für die Google Maps Platform-APIs.

Google Maps Platform-API	Kontingenteinheit
Maps
Maps SDK for Android	1 Panorama
Maps SDK for iOS	1 Panorama
Map Tiles API	1 Anfrage
Maps Aerial View API	1 Anfrage
Maps Static API	1 Anfrage
Maps JavaScript API	1 Kartenaufruf
Street View Static API	1 Anfrage
Maps Embed API	1 Kartenaufruf
Routes
Routes API (Compute Routes)	1 Anfrage
Routes API (Compute Route Matrix)	1 Element (Start-Ziel-Paar)
Directions API	1 Anfrage
Distance Matrix API	1 Element (Start-Ziel-Paar)
Roads API	1 Anfrage
Places
Places API	1 Anfrage
Address Validation API	1 Anfrage
Geocoding API	1 Anfrage
Geolocation API	1 Anfrage
Time Zone API	1 Anfrage
Environment
Air Quality API („CurrentConditions“ und „HeatmapTile“)	1 Anfrage
Air Quality API (Verlauf)	1 Seite
Pollen API	1 Anfrage
Solar API	1 Anfrage

Abrechnungsberichte

Abrechnungsbericht ansehen

Ihre Abrechnungsberichte für die Nutzung der Google Maps Platform-Produkte sind in der Google Cloud Console verfügbar. Weitere Informationen finden Sie unter Google Maps Platform – Abrechnung.

So greifen Sie auf die Abrechnungsberichte zu:

1. Öffnen Sie in der Cloud Console die Seite für die Projektauswahl:

   Seite für die Projektauswahl

2. Wählen Sie ein Projekt aus.
3. Klicken Sie auf die Menüschaltfläche  und wählen Sie Abrechnung aus.
4. Wenn Sie mehrere Rechnungskonten haben, wählen Sie Zum verknüpften Rechnungskonto aus und öffnen Sie die Seite Übersicht für das verknüpfte Rechnungskonto.
5. Wählen Sie im Menü auf der linken Seite Berichte aus und öffnen Sie die Seite Berichte des verknüpften Rechnungskontos.

Diagramm im Abrechnungsbericht auswerten

Kosten im Zeitverlauf werden in Abrechnungsberichten als gestapeltes Liniendiagramm dargestellt. In der Standardansicht werden die täglichen nutzungsspezifischen Kosten für alle Produkte im aktuellen Monat nach Projekt gruppiert angezeigt. Diese Angabe umfasst auch nutzungsspezifische Gutschriften (sofern vorhanden) und die prognostizierten Gesamtkosten für den gesamten aktuellen Monat. Die Linien im Diagramm und die Zeilen in der Übersichtstabelle entsprechen jeweils einem Projekt und sind nach Kosten in absteigender Reihenfolge aufgeführt. Weitere Informationen zum Auswerten des Abrechnungsbericht-Diagramms

Abbildung 1: Diagramm und Tabelle im Abrechnungsbericht (Standardansicht)

Tipp: Nutzung und Kosten nach SKU auswerten

Um weitere Details zum Preismodell „Pay as you go“ und dessen Auswirkungen auf Ihre Implementierung zu erhalten, können Sie sich die Nutzung und Kosten nach SKU ansehen.

Abbildung 2: Abrechnungstabelle mit Nutzungs- und Kostenpositionen nach SKU

Abbildung 3: Filter für Abrechnungsberichte

So ändern Sie die Berichtsdatenansicht so, dass Positionen nach SKU angezeigt werden:

1. Maximieren Sie im Steuerfeld rechts neben dem Diagramm den Filter Gruppieren nach.
2. Wählen Sie SKU aus.

Weitere Filter für Abrechnungsberichte sind Zeitraum, Projekte, Produkte, SKUs und Standorte. Mit letzterem Filter grenzen Sie die Ergebnisse nach dem Ursprungsort der API-Anfrage ein.

Um neben dem Produkt auch die Quelle der Nutzung zu kategorisieren, können Sie Abrechnungsberichte nach einem der aufgeführten Werte gruppieren. Die drei Schlüssel, die sich auf Google Maps Platform-APIs beziehen, sind goog-maps-api-key-suffix (die letzten vier Zeichen eines API-Schlüssels), goog-maps-platform-type (die Plattform: Android, iOS, JavaScript oder Webdienst) und goog-maps-channel (ein festgelegter numerischer Kanalwert aus einer API-Anfrage). Weitere Informationen zum Filtern und Gruppieren finden Sie hier.

Sie können nutzungsspezifische Gutschriften in der Diagrammansicht ausschließen. Entfernen Sie dazu das Häkchen bei Gutschriften bei Kosten berücksichtigen im Bereich rechts.

Nutzung erfassen und einschränken

So können Sie Ihr Budget besser planen und die Kosten kontrollieren:

• Sie können Budgetbenachrichtigungen festlegen und so im Auge behalten, wie sich Ihre Ausgaben zu einem bestimmten Betrag hin entwickeln. Durch das Festlegen eines Budgets wird die API-Nutzung nicht automatisch auf einen festen Betrag begrenzt. Sondern Sie werden lediglich benachrichtigt, wenn sich die Ausgaben dem festgelegten Limit nähern.

• Sie können die tägliche API-Nutzung auf einen bestimmten Betrag begrenzen, um die Kosten für die Nutzung kostenpflichtiger APIs im Griff zu behalten. Wenn Sie Obergrenzen für Anfragen pro Tag festlegen, können Sie Ihre Ausgaben begrenzen. Wenn Sie wissen, wie viel Sie pro Tag ausgeben möchten, können Sie mit einer einfachen Gleichung die entsprechende Obergrenze ermitteln. Beispiel: (monatliche Ausgaben ÷ Preis pro SKU-Nutzung) ÷ 30 = Obergrenze für Anfragen pro Tag (für eine API).

  Hinweis: Unter Umständen nutzt Ihre Implementierung mehrere kostenpflichtige APIs. In diesem Fall müssen Sie die Gleichung entsprechend anpassen. Vergessen Sie nicht, das Google Maps Platform-Guthaben in Höhe von 200 $, das Ihnen jeden Monat zur Verfügung steht, in Ihrer Berechnung zu berücksichtigen.

Nutzungs-Tracking pro Kanal

Wenn Sie Ihre Nutzung über numerische Kanäle verfolgen möchten, müssen Sie den Parameter „channel“ in Ihre API-Anfragen einfügen. Die zulässigen Kanalwerte sind 0 bis 999. Hier einige Beispiele:

• Geocoding Web Service API

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Maps JavaScript API

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Sie können sich die Kanalnutzung direkt im Abrechnungsbericht ansehen. Kanäle werden unter Labels als Schlüssel goog-maps-channel angezeigt.

Hinweis: Für das Maps SDK for Android, das Maps SDK for iOS, die Places API (Neu), die Address Validation API, die Aerial View API, die Air Quality API, die Map Tiles API, die Roads API, die Routes API, die Pollen API und die Solar API sind keine Kanaldaten verfügbar.

Abbildung 4: Nach SKU und Kanal filtern

So filtern Sie Ihren Abrechnungsbericht nach SKU und Kanal:

1. Wählen Sie unter Gruppieren nach „SKU“ als Filter aus.
2. Wählen Sie das Caret Labels aus.
3. Klicken Sie auf das Drop-down-Menü Schlüssel und wählen Sie goog-maps-channel aus.
4. Klicken Sie auf das Drop-down-Menü Wert und wählen Sie die zu filternden numerischen Kanäle aus.

Wenn Sie nach Labelschlüssel goog-maps-channel gruppieren, sehen Sie die Kosten nach Kanal.

Nachdem Sie Nutzungsdaten nach Kanal in Ihre Anfragen implementiert haben, kann es bis zu 24 Stunden dauern, bis die Daten in Ihrem Abrechnungsbericht aufgeführt werden.

Abrechnungsdaten mit BigQuery exportieren

Sie haben auch die Möglichkeit, Ihre Abrechnungsdaten nach BigQuery zu exportieren.

Mit BigQuery Export können Sie detaillierte Cloud Billing-Daten (z. B. Nutzungs- und Kostenschätzungen) automatisch mehrmals täglich in ein BigQuery-Dataset exportieren lassen, das Sie festlegen. So stehen Ihnen Ihre Abrechnungsdaten über BigQuery für detaillierte Analysen zur Verfügung. Dadurch erhalten Sie noch detailliertere Informationen zur Quelle Ihrer Nutzung der Google Maps Platform.

Wenn Sie BigQuery-Exporte einrichten möchten, um diese Daten abzurufen, können Sie die folgende Beispielabfrage ausprobieren. Zuvor müssen Sie aber Folgendes tun:

• Aktivieren Sie die Abrechnung und den Cloud Billing-Export nach BigQuery für Ihr Konto.
• Das Tabellenformat ist PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID. Dabei ist…
• PROJECT_ID die eigentliche Projekt-ID (z. B. „my-project-123456“).
• DATASET_NAME der Name des Datasets, das Sie erstellt haben (z. B. „SampleDataSet“).
• BILLING_ACCOUNT_ID eine Referenz Ihrer Rechnungskonto-ID mit dem Präfix „gcp_billing_exportv1“. Bindestriche (-) werden in Unterstriche (_) geändert. Die Rechnungskonto-ID 123456-7890AB-CDEF01 wird dann z. B. zu gcp_billing_export_v1_123456_789AB_CDEF01.

Hinweis: Wenn Sie ein neues Dataset erstellen, wird es direkt auf der Benutzeroberfläche angezeigt. Die abzufragende Tabelle ist jedoch noch nicht zu sehen. Sie wird nach einigen Stunden automatisch erstellt. Es dauert dann etwa 24 Stunden, bis Ihre Daten angezeigt werden. Ihr BigQuery-Dataset enthält nur Nutzungs- und Kostendaten ab dem Datum, an dem Sie den Abrechnungsexport eingerichtet haben. Anders ausgedrückt: Abrechnungsdaten werden nicht rückwirkend hinzugefügt. Daher sehen Sie keine Abrechnungsdaten aus der Zeit vor der Aktivierung des BigQuery-Exports.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Weitere Informationen

Cloud Billing:

• Cloud-Rechnungskonto erstellen, ändern oder schließen
• Abrechnung für ein Projekt aktivieren, deaktivieren oder ändern
• Abrechnungsberichte und Kostentrends ansehen
• Budgets und Budgetbenachrichtigungen festlegen
• API-Nutzung deckeln

Google Maps Platform:

• Google Maps Platform – Abrechnung
• Optimierungsleitfaden
• Best Practices für API-Schlüssel

Antwortstatus und ‑berichte

Die folgende Tabelle zeigt die Zuordnung zwischen dem Maps API-Status, dem in den Maps API-Antworten zurückgegebenen HTTP-Antwortcode und der HTTP-Antwortcodeklasse im Nutzungsbericht. Außerdem wird angegeben, ob die entsprechende Anfrage in den Nutzungs-, Kontingent- und Abrechnungsberichten berücksichtigt wird.

Hinweis: Der in Antworten auf Google Maps Platform-API-Anfragen zurückgegebene ältere HTTP-Antwortcode kann sich vom HTTP-Antwortcode in Nutzungsberichten unterscheiden (siehe Google Maps Platform – Seite „Messwerte“). Für die Messwerte der Nutzungsberichte wird eine Reihe von Antwortcodewerten verwendet, die mit denen in neueren APIs übereinstimmen. Dadurch wird die Beobachtbarkeit der API-Nutzung auf der Seite „Messwerte“ der Google Maps Platform und im Monitoring der Google Maps Platform verbessert.

Der Nutzungsbericht auf der Seite „Messwerte“ der Google Maps Platform hat den Detaillierungsgrad HTTP response code class. Wenn Sie einen höheren Detaillierungsgrad benötigen, sehen Sie sich die Antwortstatuscodes an, die im Monitoring in der Google Maps Platform verfügbar sind.

Antwortcodes, die in Maps API-Antworten verfügbar sind		Im Nutzungsbericht verfügbar	Berücksichtigt in
Google Maps API-Status	HTTP-Antwortcode	HTTP-Antwortcodeklasse	Nutzung	Kontingent	Abrechnung
OK	200, 204, 302	2xx, 3xx	Ja	Ja	Ja
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200, 404	4xx^1	Ja	Ja	Ja
INVALID_REQUEST (ungültiger Parameterwert), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, usw.	200, 400	4xx	Ja	Ja	Ja
INVALID_REQUEST (ungültiger oder fehlender Parameter, Fehler beim Parsen der Anfrage)	200, 400	4xx	Ja	Nein	Nein
REQUEST_DENIED	200, 400, 403	4xx^1	Ja	Nein	Nein
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	Ja	Nein	Nein
UNKNOWN_ERROR	200, 500, 503	5xx^1	Ja	Ja	Nein
^1 Damit einheitlichere Fehlercodes zurückgegeben werden können, werden die Google Maps Platform APIs umgestellt: 1) von HTTP-Antwortcodeklasse 2xx auf 4xx für folgende Maps API-Status: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – Status, 2) von HTTP-Antwortcodeklasse 2xx auf 4xx für folgende Maps API-Status: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) von HTTP-Antwortcodeklasse 2xx auf 5xx für folgenden Maps API-Status: UNKNOWN_ERROR. In der Übergangsphase sehen Sie beide Antwortcodes. Die Antwortcodes, die in Google Maps API-Antworten zurückgegeben werden, ändern sich nicht. Sie können prüfen, ob eine Zunahme von 4xx- und/oder 5xx-Meldungen auf der Seite „Messwerte“ in der Google Maps Platform auf diese Migration zurückzuführen ist. Dazu sehen Sie im Metrics Explorer nach, für welchen spezifischen Antwortcode mehr Meldungen ausgegeben werden. Weitere Informationen zur Verwendung von Cloud Monitoring für die Google Maps Platform

Berichte zur Interaktion

Dieses Produkt oder diese Funktion ist experimentell (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie in den Beschreibungen der Einführungsphasen.

Statistikdaten

Über die Google Maps Platform erhalten Sie Statistiken dazu, wie Nutzer mit Ihren Karten interagieren. Dazu gehören wichtige Interaktionsmesswerte wie Kartenaufrufe oder Interaktionen mit einem POI. Sie können diese Daten analysieren, um beliebte Orte zu ermitteln, die für Werbung und Marketing infrage kommen, oder um die Nutzererfahrung zu optimieren.

Berichtsfunktionen für Statistiken:

• Zusammenfassung der Statistiken, damit Sie wichtige Trends sofort erkennen
• Aufschlüsseln einzelner Messwerte in der Console, um aussagekräftige Details zu erhalten
• CSV-Export von Messwerten, damit Sie die Statistiken in Ihrem bevorzugten Analysetool auswerten können

Verfügbare Interaktionsmesswerte:

• Kartenaufrufe: Sie können sich Daten zu Aufrufen ansehen, die erfasst werden, wenn Nutzer die Karte schwenken, zoomen oder neigen. Kartenaufrufe werden jeweils pro Woche (Sonntag bis Samstag; Pacific Time) und nach Postleitzahlen berechnet. Neue Daten werden jede Woche am Mittwoch nach dem jeweiligen Beobachtungszeitraum veröffentlicht.

Nutzer können die Daten in der Cloud Console auf der Seite Messwerte sehen. Für das Projekt muss die Maps JavaScript API aktiviert sein.

Sie können Interaktionsmesswerte direkt in der Console analysieren. Die Funktionen zum Filtern und Gruppieren ermöglichen eine detaillierte Analyse. Sie haben z. B. die Möglichkeit, nach einer bestimmten Region zu filtern, um nur Daten zu Kartenaufrufen für die entsprechenden Postleitzahlen zu sehen. Oder Sie gruppieren nach einer bestimmten Region, um Interaktionen innerhalb der Region zusammenzufassen.

Nutzer können das gesamte Dataset oder eine gefilterte Ansicht zur weiteren Auswertung in ihrem bevorzugten Analysetool im CSV-Format exportieren. Es ist möglich, Daten für maximal 90 Tage auf einmal herunterzuladen. Downloads mit mehr als 60.000 Zellen werden gekürzt. Je nach ausgewähltem Zeitraum kann der CSV-Export von Kartenaufrufen einige Minuten in Anspruch nehmen.

Messwerte in Statistiken sind anonymisiert. Sie spiegeln nur allgemeine Trends in Bezug auf die Interaktionen mit Ihren Karten wider. Niedrige Zahlen können auf 0 gerundet und Ausreißer-Effekte reduziert werden.

Der Zugriff auf Statistikdaten für Ihr Cloud-Projekt in der Google Cloud Console lässt sich mithilfe der Maps Analytics-Berechtigung steuern. Project Owner erhalten die Berechtigung standardmäßig und können anderen Nutzern bei Bedarf Zugriff erteilen.

Statistikdaten sollten nicht zum Schätzen Ihrer Nutzungskosten verwendet werden. Weitere Informationen finden Sie unter Nutzungsberichte.

Locator Plus

Als Nutzer von Locator Plus können Sie mithilfe eines Dashboards Daten analysieren und Statistiken erstellen. So erhalten Sie anhand Ihrer Daten Aufschluss darüber, wie (potenzielle) Kunden mit Ihrer Standortsuche interagieren. Leistungsdaten können im Wochenvergleich betrachtet werden, darunter Anzahl der Aufrufe, Anzahl der Interaktionen mit der Suche sowie Place Details und Interaktionsrate insgesamt. Außerdem enthält das Dashboard wichtige Benchmarks dazu, wie Ihre Implementierung im Vergleich zu denen anderer Händler abschneidet.

• Rufen Sie in der Google Cloud Console Locator Plus auf.
• Gehen Sie zum Bereich Berichte zur Interaktion, um das Analyse-Dashboard zu sehen.

Mithilfe des Benchmarking-Berichts können Sie Ihre Daten mit zusammengefassten Branchendaten anderer Unternehmen vergleichen, die ihre Daten freigeben. Dadurch erhalten Sie wertvolle Kontextinformationen und können relevante Ziele festlegen, Branchentrends erkennen und Ihre Leistung mit der Ihrer Mitbewerber vergleichen.

Damit Sie Benchmarking-Daten sehen können, werden Ihre Interaktionsdaten anonym in Google-Benchmarks eingefügt. Wenn Sie Ihre Interaktionsdaten weder ansehen noch anonym in Benchmarking-Berichte einfügen lassen möchten, reichen Sie ein Support-Ticket ein. Es wird in der Regel innerhalb von 3 Tagen bearbeitet.