Ü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:
- Öffnen Sie in der Cloud Console die Seite für die Projektauswahl:
- 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ächeund 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.
So greifen Sie auf die Übersichtsseite für die Google Maps Platform zu:
- Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:
- 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.
So greifen Sie auf die Google Maps Platform-Seite „APIs“ zu:
- Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:
- 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.
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:
- Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:
- 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:
|
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:
- Öffnen Sie in der Cloud Console die Seite „Google Maps Platform“:
- Wählen Sie im Menü auf der linken Seite Kontingente aus.
- 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:
- Öffnen Sie in der Cloud Console die Seite für die Projektauswahl:
- Wählen Sie ein Projekt aus.
- Klicken Sie auf die Menüschaltfläche
und wählen Sie Abrechnung aus.
- 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.
- 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
![Screenshot des Abrechnungsberichts mit Diagramm und Tabelle (Standardansicht)](https://cloud.google.com/billing/docs/images/billing-reports1.png?authuser=5&hl=de)
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.
![Nach SKU gruppierter Abrechnungsbericht](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-table-by-sku.png?authuser=5&hl=de)
![Screenshot der Filter für Abrechnungsberichte](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-filters-sku.png?authuser=5&hl=de)
So ändern Sie die Berichtsdatenansicht so, dass Positionen nach SKU angezeigt werden:
- Maximieren Sie im Steuerfeld rechts neben dem Diagramm den Filter Gruppieren nach.
- 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).
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.
![Nach Label filtern](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-filter-channel.png?authuser=5&hl=de)
So filtern Sie Ihren Abrechnungsbericht nach SKU und Kanal:
- Wählen Sie unter Gruppieren nach „SKU“ als Filter aus.
- Wählen Sie das Caret Labels aus.
- Klicken Sie auf das Drop-down-Menü Schlüssel und wählen Sie goog-maps-channel aus.
- 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
.
#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
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.
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 |
4xx1 | 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 |
4xx1 | Ja | Nein | Nein |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded |
200, 403, 429 |
4xx1 | Ja | Nein | Nein |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | 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
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.