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, anhand derer Sie Ihre API-Nutzung, Ihre API-Kontingente und Ihre API-Zahlungsinformationen in der Google Cloud Console ganz einfach im Blick behalten können. Sie können schnell die Anzahl der API-Aufrufe ermitteln, sehen, wie weit Sie die API-Nutzungskontingente bereits ausgeschöpft haben, und die Verwendung der Abrechnung im Zeitverlauf beobachten.

Folgende Berichtstypen sind verfügbar:

  • Nutzungsberichte: Hiermit lässt sich erfassen, 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 Anzahl der Aufrufe, der Interaktionen und die Interaktionsrate für Nutzer von Locator Plus werden dargestellt.

Eine vollständige Liste der Antwortstatus und Antwortcodes finden Sie nachfolgend unter Antwortstatus und -berichte. Diese legen fest, ob eine Anfrage im Nutzungsbericht, Kontingentbericht und/oder Abrechnungsbericht aufgeführt wird.

Über die Cloud Console rufen Sie Berichte zur Nutzung, zum Kontingent und zur Abrechnung der Google Maps Platform 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 herkömmliche und migrierte Premiumoptions-Projekte).

Die Nutzungsmesswerte werden in Tabellen („Anfragen“, „Fehler“ und „Latenz“) und in Grafiken („Traffic“, „Fehler“ und „Latenz“) angezeigt. Zu Tracking-Zwecken gilt Folgendes:

  • Nutzungsmesswerte für alle APIs können nach Zeitraum und API gefiltert werden. Außerdem haben Sie die Möglichkeit, Traffic, Fehler und Latenz nach Antwortcode, API und Anmeldedaten gruppiert darstellen zu lassen.
  • Nutzungsmesswerte für eine bestimmte API können nach Zeitraum und den Versionen, Anmeldedaten und Methoden der API gefiltert werden. Außerdem haben Sie die Möglichkeit, Traffic, Fehler und Latenz nach Antwortcode, API-Methode sowie -Version und Anmeldedaten gruppiert darstellen zu lassen.

Dashboard-Seite „APIs & Dienste“

Auf der Dashboard-Seite „APIs und Dienste“ finden Sie eine Übersicht der Nutzungsmesswerte für alle APIs, die für Ihr Projekt aktiviert sind – die Google Maps Platform-APIs sowie andere APIs und Dienste von Google.

Die Dashboard-Seite enthält drei Diagramme und eine Tabelle. Sie können die in diesen Diagrammen und Tabellen angezeigten Nutzungsmesswerte 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.

APIs beobachten

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 Menü 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.

Screenshot einer Diagrammübersicht mit einer Tabelle, in der die aktivierten APIs und API-Anfragen der letzten 30 Tage aufgelistet sind

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.

APIs

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.

Auf der Seite „Messwerte“ sehen Sie drei Diagramme: „Traffic“, „Fehler“ und „Medianlatenz“.

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:

Der Filter „Plattform“ wird nur angezeigt, wenn eine einzelne API ausgewählt ist. Der Filter „Plattform“ wird nur angezeigt, wenn eine einzelne API ausgewählt ist.

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.

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 etc.
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 jeweiligen Zeitraum verursacht wird. Wiederhole die Anfrage später. Weitere Informationen finden Sie in der API-Antwort.
INVALID_REQUEST (ungültiger oder fehlender Parameter, Fehler beim Parsen / bei der Validierung 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 heißt 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 zu 4xx für folgende Maps API-Status: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – Status, 2) von HTTP-Antwortcodeklasse 2xx zu 4xx für folgende Maps API-Status: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) von HTTP-Antwortcodeklasse 2xx zu 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

Auf 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 Codelabs nutzen.

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 Anwendung von Lösungen an Google zurück, um die Qualität bei künftigen Iterationen zu verbessern.
  • 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 jedoch 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 bzw. ein Panoramaaufruf (Kartenaufrufe sind kostenlos und werden nicht auf das Kontingent angerechnet).

Screenshot der Seite „Kontingente“ für Maps in der Google Cloud Console. Er zeigt die Kontingente nach API. Über die Auswahl können Sie Informationen zu verschiedenen APIs aufrufen. Sie sehen die Zahl der Kartenaufrufe bezogen auf die festgelegten Kontingente für die betreffende API.

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
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

Abrechnungsberichte

Abrechnungsbericht ansehen

Ihre Abrechnungsberichte für die Nutzung der Google Maps Platform-Produkte sind in der Google Cloud Console verfügbar (unter 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 Menü 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 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)
Abbildung 1: Diagramm und Tabelle im Abrechnungsbericht (Standardansicht)

Tipp: Nutzung und Kosten pro 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 pro SKU ansehen.

Nach SKU gruppierter Abrechnungsbericht
Abbildung 2: Abrechnungstabelle mit Nutzungs- und Kostenpositionen nach SKU
Screenshot der Filter für Abrechnungsberichte
Abbildung 3: Filter für Abrechnungsberichte
So ändern Sie die Berichtsdatenansicht, um die Positionen nach SKU zu sehen:
  1. Maximieren Sie im Steuerfeld rechts neben dem Diagramm den Filter Gruppieren nach.
  2. Wählen Sie SKU aus.

Andere Filter, mit denen Sie die Ergebnisse in Abrechnungsberichten nach dem Ursprungsort der API-Anfragen einschränken können, sind Zeitraum, Projekte, Produkte, SKUs und Standorte.

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 gedeckelt. Sie werden lediglich benachrichtigt, wenn sich die Ausgaben dem festgelegten Limit annähern.
  • Sie können die tägliche API-Nutzung deckeln, um die Kosten für die Nutzung kostenpflichtiger APIs zu steuern. 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). Unter Umständen umfasst Ihre Implementierung mehrere kostenpflichtige APIs. In diesem Fall müssen Sie die Gleichung entsprechend anpassen. Denken Sie daran, das Google Maps Platform-Guthaben in Höhe von 200 $ in Ihrer Rechnung zu berücksichtigen, das Ihnen jeden Monat zur Verfügung steht.

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
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-Datenexport 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
  

Cloud Billing:

Google Maps Platform:

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 4xx1 Ja Ja Ja
NOT_FOUND (Street View Static, Geolocation und Roads APIs),
ZERO_RESULTS (Street View Static API)
404 4xx 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 zu 4xx für folgende Maps API-Status: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – Status, 2) von HTTP-Antwortcodeklasse 2xx zu 4xx für folgende Maps API-Status: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) von HTTP-Antwortcodeklasse 2xx zu 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

Als Nutzer von Locator Plus können Sie mithilfe eines Dashboards Daten analysieren und Statistiken erstellen. So erhalten Sie Aufschluss darüber, wie potenzielle Käufer 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.

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.