Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform obejmuje zestaw wstępnie zdefiniowanych raportów wizualnych, dzięki którym możesz z łatwością poznać podstawowe informacje o wykorzystaniu interfejsu API, limitach oraz o płatnościach w Google Cloud Console. Możesz szybko określić liczbę wywołań interfejsu API oraz to, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, a także sprawdzać wykorzystanie płatności w czasie.

Typy raportów:

  • Raporty o wykorzystaniu: zawierają liczbę żądań, które Twój projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z Twoim projektem.
  • Raporty dotyczące limitów: przedstawiają wykorzystanie limitu na wykresach, które można grupować w żądaniach na minutę. Bieżące limity wykorzystania limitów dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
  • Raporty rozliczeniowe: przedstawiają koszty w czasie w postaci skumulowanego wykresu liniowego. Wyświetl wykorzystanie limitu w bieżącym miesiącu, w tym wszelkie przyznane środki za wykorzystanie, a także łączny prognozowany koszt w całym bieżącym miesiącu.
  • Raporty zaangażowania: dostarczają informacji o tym, jak użytkownicy korzystają z Twoich aplikacji z mapami.

Pełną listę stanów odpowiedzi i kodów odpowiedzi, które określają, czy żądanie pojawia się w raportach Wykorzystanie, Limit lub Płatności, znajdziesz poniżej w sekcji Stan odpowiedzi i raporty.

Raporty dotyczące wykorzystania, limitów i płatności Google Maps Platform możesz wyświetlać w Cloud Console.

Raporty o wykorzystaniu

Wykorzystanie jest określane na podstawie liczby żądań, które Twój projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z Twoim projektem. Żądania obejmują żądania zakończone powodzeniem, żądania skutkujące błędami serwera oraz te, które powodują błędy klienta. Dane uwierzytelniające obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów Premium i przeniesionych projektów z abonamentem Premium).

Dane o korzystaniu są wyświetlane w tabelach (Żądania, Błędy i Czas oczekiwania) oraz na wykresach (Ruch, Błędy i Czas oczekiwania). Na potrzeby śledzenia:

  • Wskaźniki wykorzystania wszystkich interfejsów API można filtrować według przedziału czasu i interfejsu API. Możesz też przeglądać ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
  • Wskaźniki wykorzystania określonego interfejsu API można filtrować według przedziału czasu oraz wersji, danych logowania i metod interfejsu API. Możesz też zobaczyć ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.

Strona panelu interfejsów API i usług

Na stronie Panel interfejsów API i usług znajdziesz przegląd wskaźników wykorzystania wszystkich interfejsów API włączonych w projekcie (interfejsach API Google Maps Platform oraz innych interfejsów API i usług).

Na stronie panelu znajdują się 3 wykresy i tabela. Możesz filtrować wykorzystanie wyświetlane na wykresach i w tabelach, wybierając przedział czasu (od 1 godziny do ostatnich 30 dni).

Wykres natężenia ruchu przedstawia wykorzystanie w zapytaniach na sekundę (QPS) na interfejs API. Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy, w przypadku każdego interfejsu API. Wykres czasu oczekiwania pokazuje medianę czasu oczekiwania dla żądań do poszczególnych interfejsów API.

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

interfejsy API monitorowania

Aby uzyskać dostęp do strony panelu interfejsów API i usług:

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

    Strona wyboru projektów

  2. Wybierz projekt. Pojawi się strona panelu interfejsów API i usług.

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

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

Strona Przegląd w Mapach Google

Strona Przegląd w Mapach Google zawiera tabelę z listą włączonych interfejsów API i żądań użycia z ostatnich 30 dni. Żądania według interfejsu API są też widoczne w postaci wykresu. Wykres rozliczeniowy pokazuje bieżący rachunek i całkowite wykorzystanie w ciągu ostatnich 3 miesięcy.

Zrzut ekranu przedstawiający wykres Przegląd przedstawiający tabelę z listą włączonych interfejsów API i żądań do API w ciągu ostatnich 30 dni.

Aby uzyskać dostęp do strony przeglądu Google Maps Platform:

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

    Otwórz stronę Google Maps Platform

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

Strona interfejsów API Google Maps Platform

Strona Interfejsy API Map Google zawiera 2 tabele. Tabela Włączone interfejsy API przedstawia liczbę żądań, liczbę błędów i średni czas oczekiwania dla każdego włączonego interfejsu API w ciągu ostatnich 30 dni. Tabela Dodatkowe interfejsy API zawiera listę interfejsów API, które nie zostały włączone.

interfejsy API

Aby uzyskać dostęp do strony interfejsów API Google Maps Platform:

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

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie wybierz Interfejsy API.

Strona danych Map Google

Na stronie Dane w Mapach Google znajdują się 3 wykresy: Ruch, Błędy i Mediana Opóźnienia. Dane na temat wykorzystania na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.

Pod wykresami strona Wskaźniki zawiera tabelę interfejsów API, która przedstawia żądania, błędy i czas oczekiwania dla wybranych interfejsów API.

Za pomocą menu API u góry i opcji grupowania i filtrowania w panelu po prawej stronie możesz grupować i filtrować wyświetlane wskaźniki wykorzystania, wybierając konkretne lub wiele interfejsów API, dane logowania, klasy kodu odpowiedzi, typ platformy lub domenę. Możesz też wybrać przedział czasu (od godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych danych o korzystaniu.

Strona danych z 3 wykresami: Ruch, Błędy i Mediana czasu oczekiwania.

Na poniższych obrazach widać filtry Platforma i Domena dla pojedynczego interfejsu API, gdy na liście Pogrupowane według wybrano opcję Platforma i Domena:

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 uzyskać dostęp do strony wskaźników w interfejsie API Google Maps Platform:

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

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie wybierz Dane.

Wykresy kodów odpowiedzi

Wykresy Ruch według kodu odpowiedzi i Błąd według kodu odpowiedzi dzielą wykorzystanie według klasy kodu odpowiedzi HTTP. W tabeli poniżej znajdziesz mapowanie stanu odpowiedzi interfejsu Google Maps Platform API na klasę kodu odpowiedzi HTTP:

Stan interfejsu API Map Google Klasa kodu odpowiedzi HTTP – raport o wykorzystaniu
(2xx, 3xx, 4xx, 5xx)
Uwagi
OK 2xx Odpowiedź pomyślna.

Jest to płatne żądanie, które zużywa limit.
OK 3xx Odpowiedź pomyślna.

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

Na przykład udane żądania Place Photo, które zwracają przekierowanie 302 do wskazanego obrazu.
DATA_NOT_AVAILABLE 4xx(1) Odpowiedź informująca o braku dostępnych danych dotyczących wprowadzonych lokalizacji.

Jest to płatne żądanie, które zużywa limit.
ZERO_RESULTS 4xx(1) Pomyślna odpowiedź nie zwróciła żadnych wyników.

Jest to płatne żądanie, które zużywa limit.
NOT_FOUND 4xx(1) W przypadku interfejsu Directions API oznacza to, że nie udało się przekodować co najmniej 1 lokalizacji podanej w miejscu wylotu, miejscu docelowym lub punktach pośrednich w żądaniu.

W przypadku interfejsu Places API wskazuje to, że wskazana lokalizacja (identyfikator miejsca) nie została znaleziona w bazie danych Miejsc.

Jest to płatne żądanie, które zużywa limit.
INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED itp.
4xx Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API.

Jest to płatne żądanie, które zużywa limit.
REQUEST_DENIED 4xx Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu itp. 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 okresie. Ponów prośbę później. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
INVALID_REQUEST (nieprawidłowy/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 W przypadku Geolocation API dane wejściowe są niewystarczające do utworzenia oszacowania lokalizacji.

W przypadku interfejsu Roads API wskazuje to, że nie udało się przyciągnąć danych wejściowych do dróg.

Jest to płatne żądanie, które zużywa limit.
UNKNOWN_ERROR 5xx Błąd serwera wskazujący, że nie można zrealizować żądania: błąd wewnętrzny, przeciążenie usługi, brak dostępności, przekroczenie limitu czasu itp.
1 Aby poprawić spójność raportowania kodów błędów, przenosimy interfejsy API Google Maps Platform: 1) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTSstan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, dailyLimitExceeded, rateLimitExceeded.2xxuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym będziesz mieć widoczne oba kody odpowiedzi. Kody odpowiedzi zwrócone w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź, że wzrost wartości 4xx lub 5xx w danych Google Maps Platform jest powiązany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer, który dokładnie kod odpowiedzi się zwiększa (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

Więcej informacji o kodach stanu i komunikatach o błędach znajdziesz w dokumentacji odpowiedzi konkretnego interfejsu API (np. Geocoding Responses lub Directions Responses).

Parametr rozwiązań Google Maps Platform

Google Maps Platform udostępnia wiele typów przykładowego kodu, który ułatwia szybkie wdrożenie. Możesz na przykład użyć szybkiego konstruktora w Cloud Console, skorzystać z przewodników po implementacji rozwiązań branżowych i uczyć się z laboratoriów.

Aby lepiej poznać wykorzystanie i sposoby ulepszania naszych rozwiązań, Google umieszcza parametr zapytania solution_channel w wywołaniach interfejsu API. W ten sposób zbieramy informacje o przykładowym wykorzystaniu kodu:

  • Parametr zapytania solution_channel jest domyślnie zawarty w przykładowym kodzie rozwiązania.
  • Parametr zapytania zwraca statystyki dotyczące przyjęcia rozwiązania do Google, aby poprawić jakość rozwiązania w kolejnych iteracjach.
  • Możesz zrezygnować, usuwając parametr zapytania solution_channel i jego wartość z przykładowego kodu.
  • Nie ma wymogu zachowania tego parametru. Usunięcie parametru zapytania nie wpłynie na wydajność.
  • Parametr zapytania jest używany tylko do raportowania wykorzystania kodu.
  • Parametr zapytania różni się od statystyk i raportów związanych z interfejsem API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie spowoduje wyłączenia wewnętrznego raportowania interfejsu Maps JavaScript API.

Raporty dotyczące limitów

Limity liczby żądań, które Twój projekt może wysł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 wliczają się do limitu.

Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w Cloud Console. Można je grupować w żądaniach na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.

Użyj tego kalkulatora, aby obliczyć wartość limitu na minutę dla dowolnej usługi GMP API

Strona Limity w Mapach Google

Strona Limity w Mapach Google zawiera informacje o limitach i wykorzystaniu limitów dla wybranego interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch generowany przez Twoje klucze interfejsu API i identyfikatory klientów. Ruch związany z identyfikatorem klienta jest też widoczny na wykresie wskaźników w Cloud Console.

Na stronie wyświetlane są tylko żądania zużywające limit: żądania udane (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) i żądania powodujące błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (wartość nieprawidłowego parametru), UNKNOWN_ERROR).

Żądania, które powodują błędy klienta (błędy uwierzytelniania/autoryzacji/nieprawidłowego argumentu) (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (nieprawidłowy parametr, błąd analizy żądania)) – nie zużywają limitu i nie są wyświetlane.

Jednostka limitu to żądanie dotyczące większości interfejsów API Google Maps Platform (Map Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API i Elevation API). Istnieją jednak pewne wyjątki:

  • W przypadku interfejsu Distance Matrix API jednostka limitu to element, który jest parą miejsca wylotu i miejsca docelowego.
  • W przypadku interfejsu Maps JavaScript API jednostka limitu to wczytanie mapy.
  • W przypadku pakietu Maps SDK na Androida i Maps SDK na iOS jednostka przydziału to żądanie Street View lub wczytanie panoramy (wczytania mapy są dostępne bezpłatnie i nie wliczają się do limitu miejsca).

Zrzut ekranu strony Limity Map w konsoli Google Cloud. Za pomocą selektora pokazuje on limity według interfejsu API, a następnie pokazuje obciążenia map w odniesieniu do limitów ustawionych dla danego interfejsu API.

Aby uzyskać dostęp do strony Limity w Google Maps Platform:

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

    Otwórz stronę Google Maps Platform

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

Liczba jednostek przydziału

Tabela poniżej przedstawia jednostkę limitu dla interfejsów API Google Maps Platform.

Interfejs API Google Maps Platform Jednostka limitu
Mapy
Maps SDK na Androida 1 panorama
Maps SDK na iOS 1 panorama
Interfejs 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 źródło-miejsce docelowe)
Directions API 1 prośba
Distance Matrix API 1 element (para źródło-miejsce docelowe)
Roads API 1 prośba
Miejsca
Places 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 (historia) 1 strona
Interfejs API Pollen 1 prośba
Solar API 1 prośba

Raporty rozliczeniowe

Wyświetlanie raportu rozliczeniowego

Raporty rozliczeniowe za korzystanie z usług Google Maps Platform są dostępne w Google Cloud Console (zobacz Rozliczenia).

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

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

    Strona wyboru projektów

  2. Wybierz projekt.
  3. Kliknij kolejno przycisk menu menu i Płatności.
  4. Jeśli masz kilka kont rozliczeniowych, wybierz Otwórz połączone konto rozliczeniowe, aby otworzyć stronę Przegląd połączonego konta.
  5. W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty rozliczeniowe dotyczące połączonego konta rozliczeniowego.

Jak czytać wykres w raporcie rozliczeniowym

Raporty rozliczeniowe przedstawiają koszt na przestrzeni czasu w postaci skumulowanego wykresu liniowego. Domyślny widok to wyświetlanie dziennych kosztów wykorzystania w bieżącym miesiącu, pogrupowanych według projektów (w przypadku wszystkich usług), w tym wszelkich zastosowanych środków do wykorzystania za wykorzystanie, a także łączny prognozowany koszt na cały bieżący miesiąc. Każdy wiersz na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi (od największej do najmniejszej wartości według kosztu). Dowiedz się więcej o interpretowaniu wykresu raportu rozliczeniowego

Zrzut ekranu raportu rozliczeniowego z wykresem i tabelą w domyślnym widoku gotowych ustawień
Rysunek 1. Raport płatności z wykresem i tabelą w domyślnym widoku gotowych ustawień.

Wskazówka: przeanalizuj wykorzystanie i koszt kodu SKU

Aby lepiej zrozumieć szczegóły modelu płatności według wykorzystania i jego wpływ na Twoje wdrożenie, przeanalizuj wykorzystanie i koszt według kodu SKU.

Raport rozliczeniowy pogrupowany według SKU
Rysunek 2. Tabela płatności z elementami zamówienia dotyczącymi wykorzystania i kosztu według SKU.
Zrzut ekranu pokazujący filtry w raportach rozliczeniowych
Rys. 3. Filtry raportu rozliczeniowego.
Aby zmienić widok raportu tak, aby wyświetlały się elementy zamówienia według kodu SKU:
  1. W panelu po prawej stronie wykresu rozwiń filtr Grupuj według.
  2. Wybierz SKU.

Inne dostępne filtry raportów rozliczeniowych to Zakres czasowy, Projekty, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według tego, skąd są wysyłane żądania do interfejsu API.

Aby oprócz usługi sklasyfikować źródło użycia, 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 (4 ostatnie znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) i goog-maps-channel (ustawiona wartość liczbowa kanału pochodząca z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu

Widok wykresu możesz zmienić tak, aby nie uwzględniał środków za wykorzystanie, odznaczając pole wyboru Uwzględnij środki w kosztach w panelu po prawej stronie.

Monitorowanie i ograniczanie wykorzystania

Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz:

  • Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków pod kątem określonej kwoty. Ustalenie budżetu nie ogranicza wykorzystania interfejsu API, a powiadomienie Cię tylko wtedy, gdy wydatki zbliżą się do określonej kwoty.
  • Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Ustawiając limity żądań dziennie, możesz ograniczyć wydatki. Użyj prostego równania, aby określić dzienny limit w zależności od tego, ile chcesz wydać. Na przykład: (miesięczne wydatki /cena na każdy kod SKU)/30 = liczba żądań dziennie (w przypadku 1 interfejsu API). Pamiętaj, że implementacja może używać wielu płatnych interfejsów API, więc dostosuj równanie odpowiednio do potrzeb. Pamiętaj, że każdego miesiąca masz do dyspozycji środki w Google Maps Platform w wysokości 200 USD, więc uwzględnij tę kwotę w obliczeniach.

Śledzenie wykorzystania na kanał

Aby śledzić wykorzystanie za pomocą kanałów numerycznych, musisz dodać parametr „channel” do żądań do interfejsu API. Jedyne dopuszczalne wartości kanałów to liczby z zakresu 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 płatności. W sekcji Etykiety kanały będą widoczne jako klucz goog-maps-channel.

Filtruj według etykiet
Rysunek 4. Filtrowanie według kodów SKU i kanałów
Aby filtrować raport rozliczeniowy według kodu SKU i kanału
  1. Użyj filtra kodów SKU Grupuj według.
  2. Wybierz daszek Etykiety.
  3. Wybierz menu Klucz i wybierz goog-maps-channel.
  4. Kliknij menu Wartość i wybierz kanały liczbowe, które chcesz filtrować.

Pogrupuj według klucza etykiety goog-maps-channel, by zobaczyć koszty wygenerowane przez każdy kanał.

Gdy umieścisz w swoich żądaniach dane o wykorzystaniu kanału, może minąć do 24 godzin, zanim pojawią się one w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych za pomocą BigQuery

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

BigQuery Export umożliwia automatyczne eksportowanie w ciągu dnia szczegółowych danych z Rozliczeń usługi Google Cloud (np. danych o wykorzystaniu i szacowanych kosztach) do wskazanego przez Ciebie zbioru danych BigQuery. Gdy to zrobisz, uzyskasz dostęp do danych rozliczeniowych z BigQuery, aby przeprowadzić szczegółową analizę. Daje to dodatkowy poziom szczegółowości informacji o źródle wykorzystania Google Maps Platform.

Jeśli chcesz zacząć korzystać z eksportów BigQuery i wykonywania na nich zapytań, możesz wypróbować poniższe przykładowe zapytanie. Przed uruchomieniem tego zapytania musisz:

  • Włącz na swoim koncie płatności i eksport płatności BigQuery.
  • Format tabeli to PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, gdzie:
    • PROJECT_ID to Twój rzeczywisty identyfikator projektu (np. „mój-projekt-123456”).
    • DATASET_NAME to nazwa utworzonego przez Ciebie zbioru danych (np. „SampleDataSet”).
    • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego z prefiksem „gcp_billing_exportv1”, który jest złożony z myślników (-) i podkreślania (_). Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmieniłby 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

Tabela poniżej przedstawia mapowanie między stanem interfejsu API Map Google, kodem odpowiedzi HTTP zwracanym w odpowiedziach interfejsu API Map Google a klasą kodu odpowiedzi HTTP w raporcie o wykorzystaniu. Wskazuje, czy odpowiednie żądanie pojawia się w raportach dotyczących wykorzystania, przydziału i płatności.

Raport o wykorzystaniu w danych Google Maps Platform dostarcza HTTP response code class szczegółowości. Jeśli potrzebujesz większej szczegółowości, zapoznaj się z sekcją Kody stanu odpowiedzi dostępne w sekcji Monitorowanie wykorzystania Google Maps Platform.

Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google Dostępne w raporcie o wykorzystaniu Zgłoszono dla
Stan interfejsu API Map Google Kod odpowiedzi HTTP Klasa kodu odpowiedzi HTTP Wykorzystanie Limit Rozliczenia
OK 200,
204,
302
2xx,
3xx
Tak Tak Tak
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200 4xx1 Tak Tak Tak
NOT_FOUND (Street View Static, Geolocation i Roads API),
ZERO_RESULTS (Street View Static API)
404 4xx Tak Tak Tak
INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED
itp.
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 poprawić spójność raportowania kodów błędów, przenosimy interfejsy API Google Maps Platform: 1) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTSstan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, dailyLimitExceeded, rateLimitExceeded.2xxuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym będziesz mieć widoczne oba kody odpowiedzi. Kody odpowiedzi zwrócone w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź, że wzrost wartości 4xx lub 5xx w danych Google Maps Platform jest powiązany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer, który dokładnie kod odpowiedzi się zwiększa (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

Raporty z sekcji Zaangażowanie

Statystyki firmy

Google Maps Platform zapewnia wgląd w interakcje użytkowników z Twoimi mapami. Obejmują one kluczowe wskaźniki zaangażowania, takie jak wyświetlenia mapy lub interakcje z miejscem. Możesz analizować te dane, aby znaleźć popularne lokalizacje na potrzeby reklamy i marketingu lub zoptymalizować wrażenia użytkowników.

Funkcje raportowania w statystykach biznesowych:

  • wyświetlać ogólne podsumowanie statystyk biznesowych, aby poznać najważniejsze trendy w statystykach biznesowych;
  • Analizowanie konkretnych danych w konsoli w celu bardziej szczegółowej analizy danych w celu ich szczegółowego zrozumienia.
  • Eksportowanie danych do pliku CSV, co umożliwia analizowanie danych ze statystyk biznesowych w ulubionym narzędziu do analizy biznesowej.

Dostępne dane o zaangażowaniu:

  • Widoki mapy: śledź wyświetlenia mapy wynikające z przesunięcia, powiększenia lub przechylenia. Liczba wyświetleń mapy jest obliczana 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.

Użytkownicy mogą wyświetlać statystyki biznesowe na stronie Wskaźniki w Cloud Console. Widoki map są obecnie dostępne w celach testowych tylko dla niektórych programistów interfejsu API Map Google JS.

Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli za pomocą funkcji filtrowania i grupowania według, które pozwalają na bardziej szczegółową analizę danych. Możesz na przykład wybrać filtrowanie według konkretnego regionu, aby poznać trendy wyświetleń map tylko dla kodów pocztowych w tym regionie. Z drugiej strony możesz pogrupować dane według konkretnego regionu, by zebrać dane o interakcjach w jego obrębie.

Użytkownicy mogą wyeksportować do pliku CSV cały zbiór danych lub filtrowany widok, aby przeprowadzić dalszą analizę w Twoim ulubionym narzędziu do analizy biznesowej. Za jednym razem możesz pobrać dane z maksymalnie 90 dni, a dane powyżej 60 tys. komórek zostaną obcięte. Eksportowanie danych widoków map do pliku CSV może potrwać kilka minut w zależności od wybranego zakresu czasu.

Eksportuję statystyki biznesowe

Dane ze statystyk biznesowych są anonimowe, więc odzwierciedlają tylko ogólne trendy w korzystaniu z Twoich map. Niskie liczby mogą być zaokrąglone do zera, a udział z wartości odstających może być zmniejszony.

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

Statystyki biznesowe nie powinny być używane do szacowania kosztów użytkowania. Więcej informacji o korzystaniu z tej funkcji znajdziesz w raportach o wykorzystaniu.

Lokalizator Plus

Użytkownicy lokalizatora Plus mogą korzystać z panelu statystyk, aby analizować dane i generować statystyki na ich podstawie, dając jasne informacje o tym, jak dobrze kupujący korzystają z lokalizatora sklepów. Możesz mierzyć skuteczność w poszczególnych tygodniach, w tym liczbę wyświetleń, liczbę interakcji z wyszukiwarką i informacjami o miejscu oraz ogólny współczynnik zaangażowania. Panel ten zapewnia również ważne dane porównawcze, dzięki którym sprawdzisz, jak Twoja implementacja wypada na tle innych sprzedawców.

Raport analizy porównawczej umożliwia porównywanie Twoich danych ze zbiorczymi danymi branżowymi innych firm, które udostępniły te informacje. Porównanie zapewnia cenny kontekst, pomagając w wyznaczaniu realistycznych celów, zwracaniu uwagi na trendy branżowe oraz sprawdzaniu wyników firmy w porównaniu z konkurencją.

Aby mieć widoczne dane porównawcze, Twoje dane o zaangażowaniu są anonimowo uwzględniane w testach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania danych o zaangażowaniu i uwzględniania ich w raportach z analizy porównawczej, prześlij zgłoszenie do zespołu pomocy. Zgłoszenia do zespołu pomocy są zazwyczaj rozpatrywane w ciągu 3 dni.