Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform udostępnia zestaw wstępnie zdefiniowanych raportów wizualnych w konsoli Google Cloud, które przedstawiają podstawowe informacje o wykorzystaniu interfejsu API, limitach i informacjach rozliczeniowych. Korzystaj z tych raportów, aby określać liczbę wykonanych wywołań interfejsu API i osiągać limity wykorzystania interfejsu API oraz monitorować wykorzystanie płatności w czasie.

Typy raportów:

  • Raporty wykorzystania: raportuje liczbę żądań wysyłanych przez Twój projekt do interfejsów Google Maps Platform API z użyciem danych logowania powiązanych z Twoim projektem.
  • Raporty dotyczące limitów: przedstawiają wykorzystanie limitu w postaci wykresów, które można grupować według żądań na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
  • Raporty rozliczeniowe: raporty o kosztach na przestrzeni czasu w postaci skumulowanego wykresu liniowego. Wyświetl wykorzystanie limitu w bieżącym miesiącu, włącznie ze wszystkimi zastosowanymi środkami związanymi z wykorzystaniem, a także łączny koszt prognozowany na cały bieżący miesiąc.
  • Raporty zaangażowania: zawierają statystyki biznesowe dotyczące tego, jak użytkownicy korzystają z Twoich aplikacji z mapami.

Pełną listę stanów i kodów odpowiedzi określających, czy żądanie ma pojawiać się w raportach Wykorzystanie, Limit i Płatności, znajdziesz w artykule Stan i raporty odpowiedzi.

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

Raporty o wykorzystaniu

Wykorzystanie zależy od liczby żądań, które Twój projekt wysyła do interfejsów Google Maps Platform API za pomocą danych logowania powiązanych z Twoim projektem. Żądania obejmują żądania udane i błędy serwera oraz żądania powodujące błędy klienta. Dane logowania obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów w abonamencie Premium i przeniesionych projektów Premium). Szczegółowe informacje znajdziesz w omówieniu abonamentu Premium i w informacjach 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 celów śledzenia:

  • Wszystkie interfejsy API: wskaźniki wykorzystania wszystkich interfejsów API możesz filtrować i grupować w następujący sposób:

    • Filtruj według przedziału czasu i interfejsu API.
    • Wyświetlaj ruch, błędy i czas oczekiwania według kodu odpowiedzi, interfejsu API i danych logowania.

  • Konkretny interfejs API – możesz filtrować i grupować wskaźniki wykorzystania przez konkretny interfejs API na te sposoby:

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

Strona panelu interfejsów API i usług

W panelu interfejsów API i usług znajdziesz przegląd danych dotyczących wykorzystania wszystkich interfejsów API włączonych w Twoim projekcie: interfejsów Google Maps Platform API oraz innych interfejsów API i usług.

  • Na stronie Panel znajdują się 3 wykresy i tabela. Wykorzystanie 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) przez interfejs API.

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

  • Wykres Czas oczekiwania pokazuje medianę czasu oczekiwania żądań na interfejs 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 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 konsoli Cloud:

    Strona selektora projektów

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

    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 interfejsów API.

Strona Przegląd w Mapach Google

Strona Przegląd Map Google zawiera tabelę z listą interfejsów API włączonych i żądań użytkowania z ostatnich 30 dni. Żądania według interfejsu API są również wyświetlane w postaci wykresu. Wykres płatności pokazuje bieżący rachunek i całkowite wykorzystanie z ostatnich 3 miesięcy.

Zrzut ekranu z wykresem Przegląd przedstawiający tabelę z listą włączonych interfejsów API i żądań do interfejsu 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 konsoli Cloud:

    Otwórz stronę Google Maps Platform

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

Strona interfejsów API Google Maps Platform

Na stronie Interfejsy API Map Google znajdują się 2 tabele. Tabela Włączone interfejsy API podaje 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 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 Interfejsy API.

Strona danych Map Google

Na stronie Dane Map Google są wyświetlane 3 wykresy: Ruch, Błędy i Mediana czasu oczekiwania. 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, w której znajdują się żądania, błędy i czas oczekiwania dotyczące 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 wskaźniki wykorzystania. Aby to zrobić, wybierz konkretne lub wiele interfejsów API, danych logowania, klas kodu odpowiedzi, typu platformy lub domeny. Możesz też wybrać przedział czasu (od 1 godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych wskaźników wykorzystania.

Strona wskaźników z 3 wykresami: Ruch, Błędy i Mediana czasu oczekiwania.

Poniższe obrazy przedstawiają filtry platformy i domeny dla pojedynczego interfejsu API podczas grupowania według Platformy i Domena po wybraniu na liście Pogrupowane według:

Filtr platformy pojawia się tylko wtedy, gdy wybrany jest jeden interfejs API. Filtr platformy pojawia się tylko wtedy, gdy wybrany jest jeden interfejs API.

Aby uzyskać dostęp do strony Dane interfejsu 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.

Raportowanie danych logowania

Wskaźniki 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 za pomocą ?key=...: nazwy kluczy znajdziesz w sekcji Klucze i dane logowania w konsoli Maps Platform.
Numer projektu
Na przykład „project_number:123456”, gdzie 123456 to numer projektu.		 Dane logowania możesz zobaczyć 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. Możesz na przykład użyć właściwości &client=gme-_mycompany_.

    Te interfejsy API akceptują identyfikatory klientów: 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 identyfikatorami klientów w abonamencie Premium.

  2. Interfejsy API, które akceptują protokół OAuth: interfejs API został wczytany z użyciem protokołu OAuth bez klucza interfejsu API.

Wykresy kodu odpowiedzi

Wykresy Ruch według kodu odpowiedzi i Błąd według kodu odpowiedzi dzielą wykorzystanie według klasy kodu odpowiedzi HTTP. W tej tabeli pokazano 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)		 Notatki
OK 2xx Odpowiedź udzielona.

Jest to żądanie podlegające rozliczeniu i zużywa limit.
OK 3xx, Odpowiedź udzielona.

Jest to żądanie podlegające rozliczeniu i zużywa limit.

Na przykład udane żądania Miejsce Zdjęcie zwracają przekierowanie 302 do wskazanego obrazu.
DATA_NOT_AVAILABLE 4xx(1) Odpowiedź z informacją, że nie ma dostępnych danych dla lokalizacji wejściowych.

Jest to żądanie podlegające rozliczeniu i zużywa limit.
ZERO_RESULTS 4xx(1) Odpowiedź pomyślna nie zwróciła żadnych wyników.

Jest to żądanie podlegające rozliczeniu i zużywa limit.
NOT_FOUND 4xx(1) W przypadku interfejsu Directions API ten komunikat oznacza, że nie udało się przetworzyć danych geograficznych co najmniej jednej lokalizacji podanej w żądaniu, miejscu docelowym lub punkcie pośrednim.

W przypadku interfejsu Places API ten komunikat oznacza, że wskazanej lokalizacji (place_id) nie znaleziono w bazie danych Miejsc.

Jest to żądanie podlegające rozliczeniu i zużywa limit.
INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED i inne. 		4xx Błąd spowodowany nieprawidłową wartością parametru. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API.

Jest to żądanie podlegające rozliczeniu i zużywa limit.
REQUEST_DENIED 4xx Błąd klienta spowodowany między innymi przez błąd uwierzytelniania czy błąd dostępu. Aby dowiedzieć się więcej, sprawdź odpowiedź 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 przesłać żądanie później. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API.
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) 4xx Błąd klienta spowodowany nieprawidłowym żądaniem. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API.
NOT_FOUND (404) (Nie znaleziono) 4xx W przypadku interfejsu Geolocation API ten komunikat oznacza, że dane wejściowe nie były wystarczające do wygenerowania szacowanej lokalizacji.

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

To żądanie podlegające rozliczeniu, które zużywa limit.
UNKNOWN_ERROR 5xx Błąd serwera wskazujący, że nie można kontynuować żą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, interfejsy API Google Maps Platform przenoszą: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan; 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w stanach interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, rateLimitExceeded, dailyLimitExceeded kod interfejsu API, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded).2xxuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Aby potwierdzić, że z migracją wiąże się wzrost wartości 4xx lub 5xx we wskaźnikach Google Maps Platform, sprawdź w narzędziu Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (dowiedz się więcej 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 odpowiedniego 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 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 uczyć się z modułów z programowania.

Aby ułatwić zrozumienie wykorzystania i ulepszenia naszych rozwiązań, Google uwzględnia w wywołaniach interfejsu API parametr zapytania solution_channel, który zbiera informacje o użyciu przykładowego kodu:

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

Raporty dotyczące limitów

Ustalone limity liczby żądań, które Twój projekt może wysyłać do interfejsów Google Maps Platform API. Żądania mogą być ograniczone na 3 sposoby: na dzień, na minutę i na użytkownika na minutę. Do limitu wliczają się tylko żądania udane i powodujące 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 konsoli Cloud. Można je grupować według żądań na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.

Aby sprawdzić wartość limitu na minutę w przypadku dowolnej usługi GMP API, użyj tego kalkulatora.

Strona limitów w Mapach Google

Na stronie Limity Map Google wyświetlane są limity oraz wykorzystanie limitów dla wybranego przez Ciebie interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch związany z kluczami interfejsu API i identyfikatorami klientów. Ruch powiązany z identyfikatorem klienta jest też dostępny na wykresie wskaźników w konsoli Cloud.

Na stronie wyświetlane są tylko żądania, które zużywają 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 – błędy uwierzytelniania, autoryzacji i nieprawidłowego argumentu (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (nieprawidłowy parametr, błąd analizy żądania)) – nie wykorzystują limitu i nie są wyświetlane.

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

  • W przypadku interfejsu DISTANCE Matrix API jednostka limitu to element będący parą miejsce/miejsce docelowe.
  • W przypadku Maps JavaScript API jednostką limitu jest obciążenie mapy.
  • W przypadku pakietu Maps SDK na Androida i Maps SDK na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Wczytania mapy są dostępne bez opłat i nie zużywają limitu.

Zrzut ekranu ze stroną Limity Map w konsoli Google Cloud. Pokazuje on limity według interfejsu API za pomocą selektora, 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 przedstawia jednostkę limitu dla interfejsów Google Maps Platform API.

Interfejs API Google Maps Platform Jednostka limitu
Maps
Maps SDK na Androida 1 panorama
Maps SDK na iOS 1 panorama
Map Tiles API 1 prośba
Interfejs API Map Google Aerial View 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
Interfejs Routes API (trasy Compute) 1 prośba
Interfejs Routes API (tablica tras Compute) 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
Route Optimization 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 konsoli Google Cloud. Więcej informacji znajdziesz w artykule Płatności.

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 i 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.
  5. W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty dotyczącą płatności na połączonym koncie rozliczeniowym.

Jak odczytywać wykres raportu rozliczeniowego

Raporty rozliczeniowe przedstawiają koszt w postaci skumulowanego wykresu liniowego z upływem czasu. Widok domyślny zawiera dzienne koszty w danym miesiącu związane z wykorzystaniem, pogrupowane według projektów (wszystkich usług) i obejmujące wszystkie zastosowane środki związane z wykorzystaniem, 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 według kosztu). Dowiedz się więcej o interpretowaniu wykresu raportu rozliczeniowego

Zrzut ekranu pokazujący raport rozliczeniowy, który zawiera wykres i tabelę w domyślnym widoku gotowych ustawień
Rys. 1. Raport rozliczeniowy zawierający wykres i tabelę z domyślnym widokiem.

Wskazówka: przeanalizuj wykorzystanie i koszt na kod SKU

Aby dokładniej poznać szczegóły modelu cenowego płatności według wykorzystania oraz jego wpływ na implementację, przeanalizuj wykorzystanie i koszt według kodu SKU.

Raport rozliczeniowy pogrupowany według kodu SKU
Rys. 2. Tabela rozliczeniowa z elementami zamówienia dotyczącymi wykorzystania i kosztów według kodu SKU.
Zrzut ekranu przedstawiający filtry raportu rozliczeniowego
Rysunek 3. Filtry raportu rozliczeniowego
Aby zmienić widok raportu tak, aby wyświetlać 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 raportu rozliczeniowego to Przedział czasu, Projekty, Usługi, Kody SKU i Lokalizacje. Pozwalają filtrować dane według tego, skąd są dostarczane żądania do interfejsu API.

Aby przypisać źródło użytkowania do określonej usługi (oprócz usługi), pogrupuj raporty rozliczeniowe według jednej z wymienionych wartości. Trzy klucze powiązane z interfejsami API Google Maps Platform to goog-maps-api-key-suffix (cztery ostatnie znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) oraz goog-maps-channel (ustawiona liczbowa wartość kanału z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu

Możesz zmienić widok wykresu tak, aby wykluczyć środki związane z wykorzystaniem. W tym celu w panelu po prawej stronie zaznacz pole wyboru Uwzględnij środki w koszcie.

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ć, jak wydatki wzrastają do określonej kwoty. Ustawienie budżetu nie ogranicza wykorzystania interfejsu API, a jedynie powiadamia, gdy kwota wydatków zbliży się do określonej kwoty.

  • Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z interfejsów API podlegających rozliczeniu. Ustawiając limity liczby żą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ć. Przykład: (miesięczne wydatki /cena za każdy kod SKU)/30 = limit żądań dziennie (dla 1 interfejsu API).

Śledzenie wykorzystania na kanał

Aby śledzić wykorzystanie za pomocą kanałów liczbowych, musisz dodać do żądań do interfejsu API parametr „channel”. Jedyne dopuszczalne wartości kanałów to liczby od 0 do 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>

Sprawdzaj wykorzystanie kanału bezpośrednio w raporcie rozliczeniowym. Kanały będą widoczne w sekcji Etykiety jako klucz goog-maps-channel.

Filtruj według etykiet
Rysunek 4. Filtrowanie według kodu SKU i kanałów
Aby filtrować raport rozliczeniowy według kodu SKU i kanału
  1. Użyj filtra Pogrupuj według SKU.
  2. Wybierz 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, aby zobaczyć koszty wygenerowane przez każdy kanał.

Gdy wdrożysz dane o korzystaniu z kanału w swoich żądaniach, może minąć trochę czasu (do 24 godzin), zanim pojawią się one w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych do BigQuery

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

Funkcja BigQuery Export pozwala na automatyczne eksportowanie w ciągu dnia szczegółowych danych z rozliczeń usługi Google Cloud (takich jak dane o wykorzystaniu i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem uzyskać dostęp do danych rozliczeniowych w BigQuery, aby przeprowadzić szczegółową analizę. Zapewnia to dodatkowy poziom szczegółowości informacji o źródle korzystania z Google Maps Platform.

Jeśli chcesz zacząć eksportować dane do BigQuery i wysyłać do nich zapytania, 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 identyfikator Twojego projektu (np. „mój-projekt-123456”).
    • DATASET_NAME to nazwa utworzonego zbioru danych (np. „SampleDataSet”).
    • BILLING_ACCOUNT_ID to odwołanie do identyfikatora konta rozliczeniowego z prefiksem „gcp_billing_exportv1” i zmieniające łączniki (-) na podkreślenia (_). 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

Poniższa tabela przedstawia mapowanie stanu interfejsu API Map Google, kodu odpowiedzi HTTP zwracanego w odpowiedziach interfejsu API Map Google i klasy kodu odpowiedzi HTTP w raporcie wykorzystania. Wskazuje też, czy odpowiednie żądanie pojawia się w raportach o wykorzystaniu, limitach i rozliczeniach.

Raport o wykorzystaniu w danych Google Maps Platform zapewnia szczegółowość na poziomie HTTP response code class. Jeśli potrzebujesz wyższego poziomu szczegółowości, zapoznaj się z kodami stanu odpowiedzi dostępnymi w artykule Monitorowanie 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 (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, interfejsy API Google Maps Platform przenoszą: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan; 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w stanach interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, rateLimitExceeded, dailyLimitExceeded kod interfejsu API, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded).2xxuserRateLimitExceeded5xxUNKNOWN_ERROR W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Aby potwierdzić, że z migracją wiąże się wzrost wartości 4xx lub 5xx we wskaźnikach Google Maps Platform, sprawdź w narzędziu Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (dowiedz się więcej o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

Raporty z sekcji Zaangażowanie

Statystyki firmy

Google Maps Platform zapewnia wgląd w to, jak użytkownicy korzystają z Twoich map. Te statystyki obejmują kluczowe wskaźniki zaangażowania, takie jak wyświetlenia na mapie i interakcje z ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne lokalizacje związane z reklamami i marketingiem lub optymalizować wrażenia użytkowników.

Funkcje raportowania statystyk biznesowych obejmują:

  • przeglądać ogólne podsumowanie statystyk biznesowych, aby mieć szybki wgląd w kluczowe trendy w tych statystykach;
  • Analizowanie konkretnych danych w konsoli w celu uzyskania bardziej szczegółowych informacji na temat danych.
  • eksportowanie danych do pliku CSV, aby móc analizować dane ze statystyk biznesowych w ulubionym narzędziu do analizy biznesowej;

Dostępne dane o zaangażowaniu:

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

Użytkownicy mogą wyświetlać statystyki biznesowe na stronie Wskaźniki w Cloud Console. Projekt musi mieć włączony interfejs Maps JavaScript API.

Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli dzięki funkcjom Filtruj i Pogrupuj według, które pozwalają bardziej szczegółowo analizować dane. Możesz na przykład ustawić filtrowanie według konkretnego regionu, aby sprawdzić trendy wyświetleń mapy dotyczące tylko kodów pocztowych w tym regionie. Z drugiej strony możesz pogrupować dane według konkretnego regionu, by zebrać w nim interakcje.

Użytkownicy mogą wyeksportować cały zbiór danych lub filtrowany widok do pliku CSV, aby przeprowadzić dalszą analizę w ulubionym narzędziu do analizy biznesowej. Jednocześnie możesz pobierać dane maksymalnie z 90 dni. Pobierane pliki większe niż 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 czasowego.

Eksportuję statystyki biznesowe

Dane statystyk biznesowych są anonimizowane i odzwierciedlają tylko ogólne trendy w zainteresowaniu Twoimi mapami. Małe wartości mogą zostać zaokrąglone do zera, a wkład danych z wyników odstających może zostać zredukowany.

Dostęp do statystyk biznesowych swojego projektu Cloud możesz kontrolować w Google Cloud Console 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.

Statystyki biznesowe nie powinny być używane do szacowania kosztów wykorzystania. Więcej informacji o wykorzystaniu znajdziesz w raportach o wykorzystaniu.

Lokalizator Plus

W przypadku użytkowników Lokalizatora Plus panel statystyk pomaga analizować dane i generować na ich podstawie statystyki, dając jasny obraz tego, jak kupujący wchodzą w interakcje z lokalizatorem sklepów. Możesz mierzyć skuteczność z tygodnia na tydzień, w tym liczbę wyświetleń, liczbę interakcji z informacjami o wyszukiwarce i informacjach o miejscu oraz ogólny współczynnik zaangażowania. Panel zawiera też ważne porównania Twojej implementacji z wynikami innych sprzedawców.

Raport analizy porównawczej pozwala porównać Twoje dane ze zbiorczymi danymi innych firm z branży, które udostępniają te informacje. Porównanie daje cenny kontekst, pomaga wyznaczać wymierne cele, daje wgląd w trendy branżowe i pomaga określić, jak wypadasz na tle konkurencji.

Aby wyświetlić dane z analizy porównawczej, dane o zaangażowaniu są anonimowo uwzględniane w testach porównawczych Google. Aby zrezygnować z wyświetlania i anonimowego uwzględniania danych o zaangażowaniu w raportach analizy porównawczej, wyślij zgłoszenie. Rozpatrywanie zgłoszenia zazwyczaj zajmuje do 3 dni.