Raportowanie w Google Maps Platform

Raportowanie na platformie Google Maps Platform udostępnia w konsoli Google Cloud zestaw predefiniowanych raportów wizualnych zawierających podstawowe informacje o użyciu interfejsu API, limicie i rozliczeniach. Te raporty pomogą Ci określić liczbę wywołań interfejsu API, sprawdzić, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, oraz monitorować wykorzystanie rozliczeniowe w czasie.

Typy raportów:

  • Raporty wykorzystania: raportują liczbę żądań, które Twój projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z projektem.
  • Raporty dotyczące limitów: pokazują wykorzystanie limitów na wykresach, które można grupować według liczby żądań na minutę. Aktualne limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.
  • Raporty rozliczeniowe: przedstawiają koszty na przestrzeni czasu w formie skumulowanego wykresu liniowego. Wyświetl wykorzystanie limitu w bieżącym miesiącu, w tym wszelkie zastosowane środki dotyczące wykorzystania, a także prognozowany koszt całkowity za cały bieżący miesiąc.
  • Raporty dotyczące zaangażowania: zawierają statystyki dotyczące tego, jak użytkownicy korzystają z Twoich aplikacji mapowych.

Pełną listę stanów i kodów odpowiedzi, które określają, czy żądanie pojawia się w raportach Wykorzystanie, LimitRozliczenia, znajdziesz w artykule Stan odpowiedzi i raporty.

Wyświetlaj raporty dotyczące wykorzystania, limitu i płatności za Google Maps Platform w konsoli Cloud.

Raporty o wykorzystaniu

Korzystanie zależy od liczby żądań, które projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z projektem. Żądania obejmują udane żądania, żądania, które powodują błędy serwera, oraz żądania, które powodują błędy klienta. Dane logowania obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów w ramach pakietu Premium i przeniesionych projektów w ramach pakietu Premium). Szczegółowe informacje znajdziesz w omówieniu planu Premium oraz w informacjach o używaniu identyfikatora klienta.

Dane o użyciu są wyświetlane w tabelach (Żądania, Błędy i Opóźnienie) oraz na wykresach (Ruch, Błędy i Opóźnienie). Do celów śledzenia:

  • Wszystkie interfejsy API: możesz filtrować i grupować dane o wykorzystaniu wszystkich interfejsów API w ten sposób:

    • Filtruj według okresu i interfejsu API.
    • Wyświetlaj ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
  • Konkretny interfejs API: możesz filtrować i grupować dane o użyciu konkretnego interfejsu API w ten sposób:

    • Filtruj według okresu, wersji interfejsu API, danych logowania i metod.
    • Wyświetlaj ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.

Strona Panel interfejsów API i usług

Panel Interfejsy API i usługi zawiera przegląd wskaźników wykorzystania wszystkich interfejsów API włączonych w Twoim projekcie: interfejsów API Google Maps Platform oraz innych interfejsów API i usług.

  • Na stronie Pulpit znajdują się 3 wykresy i tabela. Możesz filtrować dane o wykorzystaniu wyświetlane na wykresach i w tabelach, wybierając okres od 1 godziny do ostatnich 30 dni.

  • Wykres Ruch pokazuje wykorzystanie w zapytaniach na minutę (QPM) dla każdego interfejsu API.

  • Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy w przypadku poszczególnych interfejsów API.

  • Wykres Czas oczekiwania pokazuje medianę czasu oczekiwania żądań dla poszczególnych interfejsów API.

Pod wykresami znajduje się tabela z listą włączonych interfejsów API i usług. Żądania to liczba żądań (w wybranym okresie). Błędy to liczba żądań, które spowodowały błędy. Czas oczekiwania (średni czas oczekiwania i centyl) to czas oczekiwania na te żądania.

Przykłady interfejsów API monitorowania

Aby otworzyć stronę Panel interfejsów API i usług:

  1. Otwórz stronę selektora projektów w konsoli Cloud:

    Strona selektora projektów

  2. Wybierz projekt. Pojawi się strona Panel Interfejsy API i usługi.

    Jeśli strona się nie wyświetla, kliknij przycisk menu menu, a następnie wybierz Interfejsy API i usługi.

Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsu API.

Strona przeglądu Map Google

Na stronie Przegląd w Google Maps Platform znajduje się tabela z listą włączonych interfejsów API i zapytań o użycie z ostatnich 30 dni. Żądania według interfejsu API są też przedstawione w formie wykresu. Wykres płatności pokazuje bieżącą fakturę i całkowite wykorzystanie w ciągu ostatnich 3 miesięcy.

Wykres Przegląd zawierający tabelę z listą włączonych interfejsów API i żądaniami do interfejsu API z ostatnich 30 dni.

Aby otworzyć stronę Przegląd Google Maps Platform:

  1. Otwórz stronę Google Maps Platform w konsoli Cloud:

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie kliknij Przegląd.

Strona interfejsów API i usług Google Maps Platform

Strona Interfejsy API i usługi Map Google zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępne w Twoim projekcie. Na każdym kafelku możesz włączyć lub wyłączyć usługę, klikając Włącz lub Wyłącz. Możesz też uzyskać dostęp do informacji o danych logowania, danych i przewodników użytkownika włączonych interfejsów API. Możesz też użyć filtrów strony, aby wyświetlić włączone lub wyłączone usługi oraz inne kategorie usług.

interfejsy API

Aby otworzyć stronę interfejsów API i usług Google Maps Platform:

  1. Otwórz stronę Google Maps Platform w konsoli Cloud:

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie kliknij Interfejsy API i usługi.

Strona Wskaźniki w Mapach Google

Strona Wskaźniki w Mapach Google zawiera 3 wykresy: Ruch, Błędy i Mediana opóźnienia. Dane o użyciu na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.

Pod wykresami na stronie Dane znajduje się tabela interfejsów API, która wyświetla żądania, błędy i czas oczekiwania dla wybranych interfejsów API.

Korzystając z menu API u góry oraz opcji grupowania i filtrowania w panelu po prawej stronie, możesz grupować i filtrować wyświetlane dane o wykorzystaniu, wybierając konkretne interfejsy API, dane logowania, klasy kodów odpowiedzi, typ platformy i domenę. Możesz też wybrać okres (od 1 godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych danych o wykorzystaniu.

Strona z danymi wyświetlająca 3 wykresy: Ruch, Błędy i Mediana czasu oczekiwania.

Na ilustracjach poniżej widać filtry PlatformaDomena dla konkretnego interfejsu API, gdy w menu Grupuj według wybrano PlatformaDomena:

Filtr Platforma pojawia się tylko wtedy, gdy wybrany jest pojedynczy interfejs API. Filtr Platforma pojawia się tylko wtedy, gdy wybrany jest pojedynczy interfejs API.

Aby otworzyć stronę Wskaźniki interfejsu API Google Maps Platform:

  1. Otwórz stronę Google Maps Platform w konsoli Cloud:

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie wybierz Dane.

Raportowanie danych logowania

Dane możesz filtrować i grupować według danych logowania użytych do wczytania interfejsu API.

Format danych logowania Znaczenie
Nazwa klucza
Na przykład „Klucz aplikacji mobilnej”
Do wczytania interfejsu API użyto klucza interfejsu API: nazwy kluczy znajdziesz w Konsoli Platformy Map Google w sekcji Klucze i dane logowania.?key=...
Numer projektu
Na przykład „project_number:123456”, gdzie 123456 to numer projektu.
Jeśli widzisz ten certyfikat, masz 2 możliwości:
  1. W przypadku interfejsów API, które akceptują identyfikatory klientów Google Maps Platform: do wczytania interfejsu API użyto identyfikatora klienta Google Maps Platform. na przykład za pomocą &client=gme-_mycompany_.

    Te interfejsy API akceptują identyfikatory klientów: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (starsza wersja), Distance Matrix API (starsza wersja), Geocoding API, Time Zone API. Więcej informacji znajdziesz w artykule Zarządzanie identyfikatorami klientów w ramach abonamentu Premium.

  2. W przypadku interfejsów API, które akceptują OAuth: interfejs API został wczytany za pomocą protokołu OAuth bez klucza interfejsu API.

Wykresy kodów odpowiedzi

Wykresy Ruch według kodu odpowiedziBłędy według kodu odpowiedzi dzielą wykorzystanie według klasy kodu odpowiedzi HTTP. Ta tabela pokazuje mapowanie między stanem odpowiedzi interfejsu API Google Maps Platform a klasą kodu odpowiedzi HTTP:

Stan interfejsu API Map Google Klasa kodu odpowiedzi HTTP – raport o użyciu
(2xx, 3xx, 4xx, 5xx)
Uwagi
OK 2xx Odpowiedź informująca o powodzeniu.

Jest to żądanie płatne, które wykorzystuje limit.
OK 3xx Odpowiedź informująca o powodzeniu.

Jest to żądanie płatne, które wykorzystuje limit.

Na przykład w przypadku udanych żądań Place Photo zwracany jest przekierowanie 302 do obrazu, do którego się odwołuje.
DATA_NOT_AVAILABLE 4xx(1) Odpowiedź wskazująca, że dla podanych lokalizacji nie ma dostępnych danych.

Jest to żądanie płatne, które wykorzystuje limit.
ZERO_RESULTS 4xx(1) Odpowiedź nie zawiera żadnych wyników.

Jest to żądanie płatne, które wykorzystuje limit.
NOT_FOUND 4xx(1)

W przypadku interfejsu Directions API (starszego) ten komunikat oznacza, że nie można było przeprowadzić geokodowania co najmniej jednej z lokalizacji określonych w punkcie początkowym, docelowym lub pośrednich żądania.

W przypadku Places API ten komunikat oznacza, że w bazie danych Miejsc nie znaleziono lokalizacji (place_id), do której się odnosi.

Jest to żądanie płatne, które wykorzystuje limit.

INVALID_REQUEST (invalid parameter value),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED i inne.
4xx Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API.

Jest to żądanie płatne, które wykorzystuje limit.
REQUEST_DENIED 4xx Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu lub innymi błędami. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded
4xx Błąd klienta spowodowany zbyt dużą liczbą żądań w dozwolonym przedziale czasu. Spróbuj ponownie wysłać żądanie później. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) 4xx Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
NOT_FOUND (404) (Nie znaleziono) 4xx Dla

Directions API (Legacy): ten komunikat oznacza, że nie można było określić współrzędnych geograficznych co najmniej jednej z lokalizacji podanych w żądaniu w polach pochodzenia, miejsca docelowego lub punktów pośrednich.

W przypadku interfejsu Geolocation API ten komunikat oznacza, że dane wejściowe nie były wystarczające do oszacowania lokalizacji.

W przypadku interfejsu Roads API ten komunikat oznacza, że danych wejściowych nie można było w rozsądny sposób dopasować do dróg.

Jest to żądanie płatne, które wykorzystuje limit.

UNKNOWN_ERROR 5xx Błąd serwera wskazujący, że nie można zrealizować żądania: błąd wewnętrzny, przeciążenie usługi, niedostępność, przekroczenie limitu czasu itp.

1 Aby zwiększyć spójność raportowania kodów błędów, interfejsy API Platformy Map Google są migrowane: 1) z klasy kodów odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – status, 2) z klasy kodów odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) z klasy kodów odpowiedzi HTTP 2xx do 5xx w przypadku stanu interfejsu API Map: UNKNOWN_ERROR. W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Sprawdź, czy wzrost wartości 4xx lub 5xxwskaźnikach Google Maps Platform jest związany z tą migracją. W tym celu sprawdź, który kod odpowiedzi dokładnie wzrasta w Eksploratorze wskaźników (więcej informacji o korzystaniu z Google Cloud Monitoring w Google Maps Platform).

Więcej informacji o kodach stanu i komunikatach o błędach znajdziesz w dokumentacji odpowiedzi interfejsu API, który Cię interesuje (np. odpowiedzi interfejsu Geocoding lub odpowiedzi interfejsu Directions).

Parametr rozwiązań Google Maps Platform

Google Maps Platform udostępnia wiele rodzajów przykładowego kodu, który pomoże Ci szybko rozpocząć pracę. Możesz na przykład użyć szybkiego kreatora w konsoli Cloud, skorzystać z przewodników wdrażania rozwiązań branżowych i uczyć się z codelabs.

Aby poznać sposób korzystania z naszych rozwiązań i możliwości ich ulepszenia, Google umieszcza w wywołaniach interfejsu API parametr zapytania solution_channel, aby zbierać informacje o korzystaniu z przykładowego kodu:

  • Parametr zapytania solution_channel jest domyślnie uwzględniany w przykładowym kodzie rozwiązania.
  • Parametr zapytania zwraca do Google statystyki dotyczące wdrożenia rozwiązania, aby w przyszłości poprawić jego jakość.
  • Możesz zrezygnować z tej funkcji, usuwając z przykładowego kodu parametr zapytania solution_channel i jego wartość.
  • Nie ma wymogu zachowania parametru. Usunięcie parametru zapytania nie wpływa na wydajność.
  • Parametr zapytania jest używany tylko do raportowania wykorzystania przykładowego kodu.
  • Parametr zapytania jest niezależny od analiz i raportów dotyczących konkretnego interfejsu API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie wyłącza wewnętrznego raportowania interfejsu Maps JavaScript API.

Raporty dotyczące limitów

Limity określają liczbę żądań, które projekt może wysyłać do interfejsów API Google Maps Platform. Żądania można ograniczać na 3 sposoby: dziennie, na minutę i na użytkownika na minutę. Do limitu wliczają się tylko udane żądania i żądania, które powodują błędy serwera. Żądania, które nie przejdą uwierzytelniania, nie są wliczane do limitu.

Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w Cloud Console i może być pogrupowane według liczby żądań na minutę. Aktualne limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.

Aby uzyskać wartość limitu na minutę dla dowolnej usługi GMP API, skorzystaj z tego kalkulatora.

Strona Limity Map Google

Na stronie Limity w Mapach Google znajdziesz limity i wykorzystanie limitów dla wybranego interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch w przypadku kluczy interfejsu API i identyfikatorów klientów. Ruch związany z identyfikatorem klienta jest też dostępny na wykresie Metryki w konsoli Cloud.

Na stronie wyświetlane są tylko żądania, które wykorzystują limit: żądania zakończone powodzeniem (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) i żądania, które powodują błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru) i UNKNOWN_ERROR).

Żądania, które powodują błędy klienta – błędy uwierzytelniania, autoryzacji i nieprawidłowych argumentów (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (nieprawidłowy parametr, błąd analizowania żądania)) – nie wykorzystują limitu i nie są wyświetlane.

Jednostką limitu jest żądanie w przypadku większości interfejsów API platformy Map Google (Maps Static API, Street View Static API, Geocoding API, Directions API (starsza wersja), Places API, Time Zone API, Geolocation API i Elevation API), ale są pewne wyjątki:

  • W przypadku interfejsu Distance Matrix API (starszego) jednostką limitu jest element, czyli para miejsc docelowych.
  • W przypadku interfejsu Maps JavaScript API jednostką limitu jest wczytanie mapy.
  • W przypadku pakietów Maps SDK na Androida i Maps SDK na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Wczytywanie map jest bezpłatne i nie zużywa limitu.

Strona Limity Map w konsoli Google Cloud, która wyświetla limity według interfejsu API za pomocą selektora, a następnie wyświetla wczytania mapy w stosunku do ustawionych limitów dla danego interfejsu API.

Aby otworzyć stronę limitów Google Maps Platform:

  1. Otwórz stronę Google Maps Platform w konsoli Cloud:

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie kliknij Limity.
  3. Wybierz interfejs API z listy.

Jednostki przydziału

Ta tabela zawiera jednostkę limitu dla interfejsów API Google Maps Platform.

Interfejs Google Maps Platform API Jednostka limitu
Mapy
Maps SDK na Androida 1 panorama
Maps SDK na iOS 1 panorama
Map Tiles API 1 prośba
Maps Aerial View API 1 prośba
Maps Static API 1 prośba
Maps JavaScript API 1 wczytanie mapy
Street View Static API 1 prośba
Maps Embed API 1 wczytanie mapy
Trasy
Routes API (Compute Routes) 1 prośba
Routes API (Compute Route Matrix) 1 element (para miejsc docelowych)
Directions API (starsza wersja) 1 prośba
Distance Matrix API (starsza wersja) 1 element (para miejsc docelowych)
Roads API 1 prośba
Route Optimization API 1 prośba
Pakiet SDK do nawigacji na Androida 1 miejsce docelowe
Pakiet SDK do nawigacji na iOS 1 miejsce docelowe
Miejsca
Places API 1 prośba
Places Aggregate API 1 prośba
Address Validation API 1 prośba
Geocoding API 1 prośba
Geolocation API 1 prośba
Time Zone API 1 prośba
Środowisko
Air Quality API (CurrentConditions i HeatmapTile) 1 prośba
Air Quality API (History) 1 strona
Pollen API 1 prośba
Solar API 1 prośba
Weather API 1 prośba

Raporty rozliczeniowe

Wyświetlanie raportu rozliczeniowego

Raporty rozliczeniowe dotyczące korzystania z usług Google Maps Platform są dostępne w konsoli Google Cloud. Więcej informacji znajdziesz w sekcji Rozliczenia.

Aby uzyskać dostęp do raportów rozliczeniowych:

  1. Otwórz stronę selektora projektów w konsoli Cloud:

    Strona selektora projektów

  2. Wybierz projekt.
  3. Kliknij przycisk menu menu, a potem wybierz Płatności.
  4. Jeśli masz kilka kont rozliczeniowych, kliknij Przejdź do połączonego konta, aby otworzyć stronę Przegląd połączonego konta rozliczeniowego.
  5. W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty dotyczącą rozliczeń na połączonym koncie rozliczeniowym.

Jak odczytywać wykres raportu rozliczeniowego

Raporty dotyczące rozliczeń przedstawiają koszty w czasie w formie wykresu liniowego. Widok domyślny wyświetla dzienne koszty bieżącego miesiąca według projektu (dla wszystkich usług), w tym wszelkie zastosowane środki za wykorzystanie, a także łączne prognozowane koszty za cały bieżący miesiąc. Każda linia na wykresie (i wiersz w tabeli podsumowującej) odpowiada projektowi, który jest uszeregowany od największego do najmniejszego pod względem kosztów. Więcej informacji o interpretowaniu wykresu w raporcie o płatnościach

Zrzut ekranu raportu rozliczeniowego z wykresem i tabelą w domyślnym widoku wstępnym
Ilustracja 1. Raport dotyczący płatności z wykresem i tabelą w domyślnym widoku wstępnie zdefiniowanym.

Wskazówka: analizowanie wykorzystania i kosztów według kodów SKU

Aby lepiej poznać szczegóły modelu płatności za wykorzystanie i dowiedzieć się, jaki ma on wpływ na Twoje wdrożenie, sprawdź wykorzystanie i koszty według kodu SKU.

Raport rozliczeniowy pogrupowany według kodów SKU
Ilustracja 2. Tabela rozliczeniowa z wyświetlonymi elementami zamówienia dotyczącymi wykorzystania i kosztów według kodu SKU.
Zrzut ekranu pokazujący filtry raportu rozliczeniowego
Ilustracja 3. Filtry raportu rozliczeniowego.
Aby zmienić widok raportu i wyświetlić elementy zamówienia według SKU:
  1. W panelu po prawej stronie wykresu rozwiń filtr Grupuj według.
  2. Wybierz SKU.

Dostępne są też inne filtry raportu rozliczeniowego, takie jak Zakres czasu, Projekty, Usługi, Kody SKULokalizacje, które umożliwiają filtrowanie według miejsca, z którego są obsługiwane żądania do interfejsu API.

Aby oprócz produktu skategoryzować źródło wykorzystania, pogrupuj raporty rozliczeniowe według jednej z wymienionych wartości. Trzy klucze związane z interfejsami API Google Maps Platform to goog-maps-api-key-suffix (ostatnie 4 znaki klucza API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) i goog-maps-channel (zestaw numerycznych wartości kanału z zapytania do interfejsu API). Więcej informacji o filtrowaniu i grupowaniu

Aby zmienić widok wykresu i wykluczyć środki za konkretne zastosowania, odznacz pole wyboru Uwzględnij środki w koszcie w panelu po prawej stronie.

Monitorowanie i ograniczanie zużycia

Aby zaplanować budżet i kontrolować koszty, możesz wykonać te czynności:

  • Ustalanie budżetu

    alert, aby śledzić, jak Twoje wydatki zbliżają się do określonej kwoty. Budżet nie ogranicza użycia interfejsu API, a jedynie powiadamia, gdy kwota wydatków zbliża się do określonej wartości.

  • Ustalanie limitu dziennego interfejsu API

    użycie, aby zarządzać kosztami korzystania z interfejsów API, za które naliczane są opłaty. Ustawiając limity dziennej liczby żądań, możesz ograniczyć wydatki. Użyj równania, aby określić dzienny limit w zależności od tego, ile chcesz wydawać. Przykład: (miesięczne wydatki / cena każdego kodu SKU) / 30 = limit żądań dziennie (w przypadku jednego interfejsu API).

Śledzenie wykorzystania według kanału

Aby śledzić wykorzystanie za pomocą kanałów numerycznych, musisz dodać do żądań do interfejsu API parametr „channel”. Dopuszczalne wartości kanału to tylko liczby z przedziału 0–999. Oto kilka przykładów:

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

Monitoruj wykorzystanie kanału bezpośrednio w raporcie rozliczeniowym. Informacje o użyciu kanału znajdziesz w sekcji Etykiety jako klucz goog-maps-channel.

Jak filtrować za pomocą etykiet
Ilustracja 4. Filtrowanie według SKU i kanałów
Filtrowanie raportu rozliczeniowego według kodu SKU i kanału
  1. Użyj filtra Grupuj według kodu SKU.
  2. Kliknij strzałkę obok opcji Etykiety.
  3. W menu Klucz wybierz goog-maps-channel.
  4. Z menu Wartość wybierz kanały numeryczne, które chcesz odfiltrować.

Grupuj według klucza etykiety goog-maps-channel, aby zobaczyć koszty generowane przez poszczególne kanały.

Po zaimplementowaniu w żądaniach danych o użyciu kanału może wystąpić krótkie opóźnienie (do 24 godzin), zanim dane zostaną odzwierciedlone w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych za pomocą BigQuery

Możesz też wyeksportować dane rozliczeniowe do BigQuery.

Użyj BigQuery Export, aby automatycznie eksportować w ciągu dnia szczegółowe dane rozliczeniowe Google Cloud (takie jak wykorzystanie zasobów i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem szczegółowo analizować te dane w BigQuery. Zapewnia to dodatkową warstwę szczegółowości w rozumieniu źródła wykorzystania Google Maps Platform.

Jeśli chcesz zacząć korzystać z eksportu do BigQuery i wykonywać zapytania dotyczące danych, możesz wypróbować przykładowe zapytanie poniżej. Przed uruchomieniem tego zapytania musisz:

  • Włącz rozliczenia i eksport rozliczeń do BigQuery na swoim koncie.
  • Format tabeli to PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, gdzie:
    • PROJECT_ID to Twój identyfikator projektu (np. „my-project-123456”).
    • DATASET_NAME to nazwa utworzonego zbioru danych (np. „SampleDataSet”).
    • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego poprzedzony ciągiem znaków „gcp_billing_exportv1”, w którym myślniki (-) zostały zastąpione podkreśleniami (_). Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmieni się na 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
  

Rozliczenia usługi Google Cloud:

Google Maps Platform:

Stan odpowiedzi i raporty

W tabeli poniżej znajdziesz mapowanie stanu interfejsu API Map, kodu odpowiedzi HTTP zwracanego w odpowiedziach interfejsu API Map i klasy kodu odpowiedzi HTTP w raporcie o użyciu. Tabela zawiera też informację, czy odpowiednie żądanie pojawia się w raportach Użycie, Limit i Płatności.

Raport użycia w danych Google Maps Platform

zapewniać szczegółowość na poziomie HTTP response code class. Jeśli potrzebujesz większej szczegółowości, zapoznaj się z artykułem Kody stanu odpowiedzi.

dostępne w monitorowaniu wykorzystania Google Maps Platform.

Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google Dostępne w raporcie o wykorzystaniu Zgłoszono do
Stan interfejsu API Map Google Kod odpowiedzi HTTP Klasa kodu odpowiedzi HTTP Wykorzystanie Limit Płatności
OK 200,
204,
302
2xx,
3xx
Tak Tak Tak
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200,
404
4xx1 Tak Tak Tak
INVALID_REQUEST (invalid parameter value),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
itd.
200,
400
4xx Tak Tak Tak
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy żądania) 200,
400
4xx Tak Nie Nie
REQUEST_DENIED 200,
400,
403
4xx1 Tak Nie Nie
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 Tak Nie Nie
UNKNOWN_ERROR 200,
500,
503
5xx1 Tak Tak Nie
1 Aby zwiększyć spójność raportowania kodów błędów, interfejsy API Platformy Map Google przechodzą: 1) z klasy kodów odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu Maps API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – status, 2) z klasy kodów odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu Maps API: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) z klasy kodów odpowiedzi HTTP 2xx na 5xx w przypadku stanu interfejsu Maps API: UNKNOWN_ERROR. W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Sprawdź, czy wzrost wartości 4xx lub 5xxwskaźnikach Google Maps Platform jest związany z tą migracją. W tym celu sprawdź, który kod odpowiedzi dokładnie wzrasta w Eksploratorze wskaźników (więcej informacji o korzystaniu z Google Cloud Monitoring w Google Maps Platform).

Raporty dotyczące zaangażowania

Statystyki firmy

Google Maps Platform dostarcza informacji o tym, jak użytkownicy korzystają z Twoich map. Te statystyki obejmują kluczowe dane dotyczące zaangażowania, takie jak wyświetlenia na mapie czy interakcje z ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne lokalizacje do reklamowania i prowadzenia działań marketingowych lub optymalizować komfort użytkowników.

Możliwości raportowania statystyk biznesowych obejmują:

  • Wyświetlanie ogólnego podsumowania statystyk biznesowych, aby szybko sprawdzić najważniejsze trendy w statystykach biznesowych.
  • Analizowanie konkretnych danych w konsoli, aby uzyskać bardziej szczegółowe informacje o danych.
  • eksportowanie danych do pliku CSV, aby analizować dane o statystykach biznesowych w ulubionym narzędziu do analizy biznesowej;

Dostępne dane o zaangażowaniu obejmują:

  • Wyświetlenia mapy: śledź wyświetlenia mapy wynikające z przesunięć, powiększeń lub przechyleń. Wyświetlenia mapy są obliczane według kodu pocztowego co tydzień (od niedzieli do soboty czasu pacyficznego). Nowe dane są udostępniane co tydzień w pierwszą środę po okresie obserwacji.

Właściciele projektów i użytkownicy z rolą Wyświetlający dane analityczne Map mogą wyświetlać statystyki dotyczące firm na stronie z danymi w konsoli Cloud. Projekt musi mieć włączony interfejs Maps JavaScript API.

Dane o zaangażowaniu możesz analizować bezpośrednio w konsoli, korzystając z funkcji filtrowania i grupowania, aby szczegółowo je zbadać. Możesz na przykład filtrować dane według konkretnego regionu, aby dowiedzieć się, jak zmienia się liczba wyświetleń mapy w przypadku kodów pocztowych w tym regionie. Z drugiej strony możesz chcieć grupować interakcje według określonego regionu, aby je w nim agregować.

Użytkownicy mogą wyeksportować cały zbiór danych lub przefiltrowany widok do pliku CSV, aby przeprowadzić dalszą analizę w ulubionym narzędziu do analizy biznesowej. Możesz pobrać dane z maksymalnie 90 dni naraz. Pobieranie zostanie przerwane, jeśli liczba komórek przekroczy 60 tys. Eksportowanie danych widoków map do pliku CSV może zająć kilka minut w zależności od wybranego zakresu czasowego.

Eksportowanie statystyk firmy

Dane statystyczne dotyczące firmy są anonimizowane, dlatego odzwierciedlają tylko ogólne trendy w zaangażowaniu w Twoje mapy. Niskie wartości mogą być zaokrąglane do zera, a wkład wartości odstających może być zmniejszany.

Dostęp do statystyk biznesowych dotyczących Twojego projektu Cloud możesz kontrolować w konsoli Google Cloud za pomocą uprawnień do Google Maps Analytics. Właściciele projektu mają to uprawnienie domyślnie i mogą w razie potrzeby przyznawać dostęp innym użytkownikom.

Statystyk biznesowych nie należy używać do szacowania kosztów korzystania. Więcej informacji o użytkowaniu znajdziesz w raportach o użytkowaniu.