Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform obejmuje zestaw wstępnie zdefiniowanych wizualnych raportów dotyczących podstawowego wykorzystania interfejsu API, limitów i informacji rozliczeniowych w konsoli Google Cloud. Raporty te mogą służyć do określania liczby wykonanych wywołań interfejsu API oraz tego, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, a także do monitorowania wykorzystania interfejsu API 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ę. Aktualne limity 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 zastosowane środki związane z wykorzystaniem, a także łączny prognozowany koszt na cały bieżący miesiąc.
  • 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 w artykule Stan odpowiedzi i raporty.

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

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, żądaniami, które spowodowały błędy serwera, i żądaniami prowadzącymi do błędów klienta. Dane uwierzytelniające obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów Premium i przeniesionych projektów w ramach abonamentu Premium). Więcej informacji znajdziesz w artykule Omówienie abonamentu Premium oraz informacjami o korzystaniu z identyfikatora klienta.

Wskaźniki wykorzystania są wyświetlane w tabelach (Żądania, Błędy i Czas oczekiwania) oraz na wykresach (Ruch, Błędy i Czas oczekiwania). Do śledzenia:

  • Wszystkie interfejsy API: możesz filtrować i grupować dane o wykorzystaniu wszystkich interfejsów API w jeden z tych sposobów:

    • Filtruj według przedziału czasu i interfejsu API.
    • Wyświetl 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 korzystaniu z określonego interfejsu API. Aby to zrobić:

    • Filtruj według przedziału czasu, wersji interfejsu API, danych logowania i metod.
    • Wyświetlanie ruchu, błędów i czasu oczekiwania, pogrupowane według kodu odpowiedzi, metody interfejsu API, wersji i danych logowania.

Strona panelu interfejsów API i usług

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

  • Na stronie Panel znajdują się 3 wykresy i tabela. Dane o korzystaniu wyświetlane na wykresach i w tabelach możesz filtrować, wybierając przedział czasu od 1 godziny do ostatnich 30 dni.

  • Wykres Ruch pokazuje wykorzystanie w zapytaniach na sekundę (QPS) na interfejs 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 dla żądań na interfejs 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 na te żądania.

interfejsy API monitorowania

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

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

    Strona wyboru projektów

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

    Jeśli strona się nie wyświetli, kliknij 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 próśb o użycie z ostatnich 30 dni. Żądania według interfejsu API są też przedstawione w postaci wykresu. Wykres płatności przedstawia bieżący rachunek i całkowite wykorzystanie z ostatnich 3 miesięcy.

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

Aby uzyskać dostęp do strony Przegląd 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 wybierz Przegląd.

Strona interfejsów API Google Maps Platform

Strona interfejsów API Map Google zawiera 2 tabele. Tabela Włączone interfejsy API zawiera liczbę żądań, liczbę błędów oraz ś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 konsoli Cloud:

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie wybierz Interfejsy API.

Strona Dane w Mapach Google

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

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

Za pomocą menu API u góry oraz opcji grupowania i filtrowania w prawym panelu możesz grupować i filtrować wyświetlane wskaźniki wykorzystania, wybierając określone lub wiele interfejsów API, danych logowania, klas kodu odpowiedzi, typu platformy lub domeny. Możesz też wybrać przedział czasu (od godziny do ostatnich 30 dni) i szczegółowość wyświetlanych danych o wykorzystaniu (na sekundę lub dzień).

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

Na tych obrazach widać filtry Platformy i Domena dla pojedynczego interfejsu API, gdy na liście Pogrupowane według zaznaczone są filtry Platforma i Domena:

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

Aby uzyskać dostęp do strony ze wskaźnikami w interfejsie Google Maps Platform API:

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

    Otwórz stronę Google Maps Platform

  2. W menu po lewej stronie wybierz Dane.

Raporty danych logowania

Wskaźniki można filtrować i grupować według danych logowania użytych do wczytania interfejsu API.

Format danych logowania Znaczenie
Nazwa klucza
Na przykład „Mobile App Key”
Do wczytania interfejsu API użyto klucza interfejsu API za pomocą ?key=...: nazwy kluczy znajdziesz w konsoli Maps Platform w sekcji Klucze i dane logowania.
Numer projektu
Na przykład „project_number:123456”, gdzie 123456 to numer Twojego projektu.
Te dane logowania mogą się wyświetlać na 2 sposoby:
  1. W przypadku interfejsów API, które akceptują identyfikatory klienta Maps Platform: do wczytania interfejsu API użyto identyfikatora klienta Maps Platform. np. &client=gme-_mycompany_.

    Te interfejsy API akceptują identyfikatory klienta: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, Distance Matrix API, Geocoding API, Time Zone API. Więcej informacji znajdziesz w artykule o zarządzaniu identyfikatorem klienta w abonamencie Premium.

  2. Interfejsy API, które akceptują protokół OAuth: interfejs API został załadowany przy użyciu protokołu OAuth bez klucza API.

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. Ta tabela przedstawia mapowanie między stanem odpowiedzi interfejsu Google Maps Platform API a 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 żądanie podlegające rozliczeniu i będzie zajmować limit.
OK 3xx Odpowiedź pomyślna.

Jest to żądanie podlegające rozliczeniu i będzie zajmować limit.

Na przykład udane żądania zdjęcia miejsca zwracają przekierowanie 302 do wskazanego obrazu.
DATA_NOT_AVAILABLE 4xx(1) Odpowiedź wskazująca, że brakuje dostępnych danych dla podanych lokalizacji.

Jest to żądanie podlegające rozliczeniu i będzie zajmować limit.
ZERO_RESULTS 4xx(1) Pomyślna odpowiedź nie zwróciła żadnych wyników.

Jest to żądanie podlegające rozliczeniu i będzie zajmować limit.
NOT_FOUND 4xx(1) W przypadku interfejsu Directions API ten komunikat oznacza, że co najmniej jednej z lokalizacji określonych w punkcie początkowym, docelowym lub punkcie pośrednim żądania nie udało się przetworzyć geokodu.

W przypadku interfejsu Places API ten komunikat oznacza, że wskazanej lokalizacji (identyfikator miejsca) nie udało się znaleźć w bazie danych Miejsc.

Jest to żądanie podlegające rozliczeniu i będzie zajmować limit.
FAILED_REQUEST (nieprawidłowa wartość parametru),
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 podlegające rozliczeniu i będzie zajmować limit.
REQUEST_DENIED 4xx Błąd klienta spowodowany m.in. m.in. błędem uwierzytelniania i błędem dostępu. 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. Spróbuj ponownie później. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
FAILED_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) 4xx Błąd klienta spowodowany przez nieprawidłowe żądanie. Więcej informacji znajdziesz w odpowiedzi interfejsu API.
NOT_FOUND (404) (Nie znaleziono) 4xx W przypadku interfejsu Geolocation API ten komunikat oznacza, że dane wejściowe nie są wystarczające do utworzenia oszacowania lokalizacji.

W przypadku interfejsu Roads API ten komunikat oznacza, że nie udało się w rozsądny sposób przypisać danych wejściowych do dróg.

Jest to żądanie podlegające rozliczeniu i będzie 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, limit czasu itp.
1 Aby zwiększyć spójność raportowania kodów błędów, interfejsy API Google Maps Platform są przenoszone: 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 do 4xx, {1. stan API/Map: {1.} z kodu HTTP/Map, {1. do kodu HTTP/Map, {1.3/} z klasy kodu odpowiedzi HTTP 2xx na 4xx.rateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Potwierdź, że wzrost liczby 4xx lub 5xx wskaźników Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (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 wybranego interfejsu API (np. w dokumencie 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 rozpoczęcie pracy. Możesz na przykład użyć Szybkiego konstruktora w Cloud Console, skorzystać z przewodników po implementacji rozwiązań branżowych i nauczyć się czegoś podczas ćwiczeń z programowania.

Aby poznać wykorzystanie i sposoby ulepszania naszych rozwiązań, Google umieszcza w wywołaniach interfejsu API parametr zapytania solution_channel w celu zbierania informacji o wykorzystaniu przykładowego kodu:

  • Parametr zapytania solution_channel jest domyślnie uwzględniany 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ływa 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 wyłącza wewnętrznych raportów 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ę. Aktualne limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania.

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

Strona Limity w Mapach Google

Na stronie Limity w Mapach Google znajdziesz informacje o limitach 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 konsoli Cloud.

Strona pokazuje 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 (nieprawidłowa wartość parametru), UNKNOWN_ERROR).

Żądania, które powodują błędy klienta – uwierzytelnianie, autoryzację i błędy 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 jest żądaniem dotyczącym 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 oraz Elevation API), ale są 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 pakietów SDK Maps na Androida i Maps SDK na iOS jednostką przydziału jest żądanie Street View lub wczytanie panoramy. Wczytania mapy są dostępne bez opłat i nie zajmują Twojego limitu.

Zrzut ekranu strony Limity Map w konsoli Google Cloud. Za pomocą selektora pokazuje 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 z limitami 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 wybierz Limity.
  3. Wybierz interfejs API z listy.

Liczba jednostek przydziału

Ta tabela zawiera 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 API Map Tiles 1 prośba
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
Pollen API 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. Więcej informacji znajdziesz w artykule Rozliczenia.

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

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

    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 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 rozliczeniowe dotyczące połączonego konta rozliczeniowego.

Jak odczytywać wykres raportu rozliczeniowego

Raporty rozliczeniowe przedstawiają koszt na przestrzeni czasu w postaci skumulowanego wykresu liniowego. W widoku domyślnym wyświetlane są dzienne koszty użytkowania w bieżącym miesiącu pogrupowane według projektów (w przypadku wszystkich usług), obejmujące wszelkie zastosowane środki związane z wykorzystaniem, a także całkowity prognozowany koszt na cały bieżący miesiąc. Każda linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi (od największej do najmniejszej wartości kosztu). Więcej informacji o interpretowaniu wykresu w raporcie rozliczeniowym

Zrzut ekranu raportu rozliczeniowego z wykresem i tabelą w domyślnym widoku gotowych ustawień
Rysunek 1. Raport rozliczeniowy zawierający wykres i tabelę w domyślnym widoku z gotowymi ustawieniami.

Wskazówka: przeanalizuj wykorzystanie i koszt SKU

Aby lepiej poznać szczegóły modelu cenowego płatności według wykorzystania i jego wpływ na implementację, zapoznaj się z wykorzystaniem i kosztem wykorzystania według kodów SKU.

Raport rozliczeniowy pogrupowany według kodu SKU
Rysunek 2. Tabela rozliczeń z elementami zamówienia dotyczącymi wykorzystania i kosztów według kodu SKU.
Zrzut ekranu pokazujący filtry w raportach rozliczeniowych
Rys. 3. Filtry raportu rozliczeniowego.
Aby zmienić widok raportu tak, by 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 Przedział czasu, Projekty, Produkty, Kody SKU i Lokalizacje. Umożliwiają one filtrowanie według skąd są przesyłane żądania do interfejsu API.

Aby oprócz usługi sklasyfikować ź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 (4 ostatnie znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) i goog-maps-channel (ustawiony numeryczny kanał z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu

Widok wykresu możesz zmienić, aby wykluczyć środki za wykorzystanie, odznaczając pole wyboru Uwzględnij środki w kosztach w prawym panelu.

Monitorowanie i ograniczanie wykorzystania

Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz wykonać te czynności:

  • Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków względem określonej kwoty. Ustawienie budżetu nie ogranicza korzystania z interfejsu API. Informuje tylko o tym, że wydatki zbliżają się do ustalonej kwoty.
  • Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami używania płatnych interfejsów API. Ustawiając limity dziennej liczby żądań, możesz ograniczyć wydatki. Za pomocą prostego równania określ limit dzienny 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).

Ś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 rozliczeniowym. W sekcji Etykiety kanały będą oznaczone jako klucz goog-maps-channel.

Filtruj według etykiet
Rysunek 4. Filtrowanie według kodów SKU i kanałów
Filtrowanie raportu rozliczeniowego według kodu SKU i kanału
  1. Użyj filtra SKU Grupuj według.
  2. Kliknij kursor Etykiety.
  3. Kliknij 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 zaimplementujesz w swoich żądaniach dane o wykorzystaniu kanałów, może minąć do 24 godzin, zanim pojawią się one w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych do 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. Umożliwi Ci to dostęp do danych rozliczeniowych w BigQuery w celu przeprowadzenia szczegółowej analizy. Zapewnia to dodatkową warstwę szczegółowości, która pozwala lepiej zrozumieć źródło korzystania z Google Maps Platform.

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

  • Włącz na swoim koncie płatności i eksport rozliczeń 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 zbioru danych (np. „SampleDataSet”).
    • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego z prefiksem „gcp_billing_exportv1”, który umożliwia zmianę myślników (-) na podkreślenia (_). 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 pokazuje 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 oraz wskazuje, czy odpowiednie żądanie pojawia się w raportach dotyczących wykorzystania, limitu i rozliczeń.

Raport o korzystaniu w danych Google Maps Platform zapewnia HTTP response code class szczegół. Aby uzyskać wyższy poziom szczegółowości, zapoznaj się z kodami stanu odpowiedzi dostępnymi 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
FAILED_REQUEST (nieprawidłowa wartość parametru),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED
itd.
200,
400
4xx Tak Tak Tak
FAILED_REQUEST (nieprawidłowy/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 Google Maps Platform są przenoszone: 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 do 4xx, {1. stan API/Map: {1.} z kodu HTTP/Map, {1. do kodu HTTP/Map, {1.3/} z klasy kodu odpowiedzi HTTP 2xx na 4xx.rateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Potwierdź, że wzrost liczby 4xx lub 5xx wskaźników Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (więcej informacji o korzystaniu z Google Cloud Monitoring w 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 ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne lokalizacje do celów reklamowych i marketingowych lub optymalizować wrażenia użytkowników.

Funkcje raportowania statystyk biznesowych obejmują:

  • wyświetlać ogólne podsumowanie statystyk biznesowych, aby szybko poznawać najważniejsze trendy w statystykach biznesowych;
  • Analizowanie konkretnych danych w konsoli w celu bardziej szczegółowej analizy danych.
  • 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. Wyświetlenia mapy są obliczane według kodu pocztowego co tydzień (od niedzieli do soboty). Nowe dane są publikowane co tydzień w pierwszą środę po zakończeniu okresu 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 korzystających z interfejsu API Map Google w języku JavaScript.

Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli za pomocą funkcji filtrowania i grupowania według, aby bardziej szczegółowo przeanalizować dane. Możesz na przykład wybrać filtrowanie według konkretnego regionu, aby zobaczyć, jak zmieniają się trendy wyświetleń map tylko w przypadku kodów pocztowych w tym regionie. Z drugiej strony możesz wybrać grupowanie według konkretnego regionu, aby zebrać dane interakcji w tym regionie.

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. Jednorazowo możesz pobrać dane z maksymalnie 90 dni, a dane powyżej 60 tys. komórek zostaną obcięte. Eksportowanie danych o wyświetleniach map do pliku CSV może potrwać kilka minut w zależności od wybranego zakresu czasu.

Eksportuję statystyki biznesowe

Dane w Statystykach firmy są anonimizowane, więc odzwierciedlają tylko ogólne trendy związane z korzystaniem z Twoich map. Niska liczba może być zaokrąglona do zera, a wpływ z wartości odstających może być zmniejszony.

Dostęp do statystyk biznesowych 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ą przyznawać dostęp innym użytkownikom.

Nie należy używać statystyk biznesowych do szacowania kosztów wykorzystania. Więcej informacji o korzystaniu znajdziesz w raportach na temat użytkowania.

Lokalizator Plus

Użytkownicy lokalizatora Plus mogą korzystać z panelu analityki, który ułatwia analizowanie danych i generowanie statystyk na ich podstawie, dzięki czemu dokładnie widać, jak skutecznie kupujący korzystają z lokalizatora sklepów. Możesz mierzyć skuteczność w ujęciu tygodniowym, 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, które pozwalają porównać skuteczność Twojej implementacji z innymi sprzedawcami.

Raport analizy porównawczej umożliwia porównywanie Twoich danych ze zbiorczymi danymi branżowymi innych firm, które udostępniły te dane. Porównanie zapewnia cenny kontekst, pomaga w określaniu istotnych celów, pozwala zorientować się w trendach w branży oraz sprawdzić, jak wypadamy na tle konkurencji.

Aby zobaczyć dane z analizy porównawczej, Twoje dane o zaangażowaniu są uwzględniane anonimowo w testach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania i uwzględniania danych o zaangażowaniu 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.