Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform udostępnia zestaw wstępnie zdefiniowanych elementów wizualnych raportów dotyczących podstawowego wykorzystania interfejsu API, limitów oraz informacji rozliczeniowych Konsola Google Cloud. Użyj tych raportów, aby określić liczbę interfejsów API liczby wykonanych wywołań, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, korzystanie z płatności w miarę upływu czasu.

Typy raportów:

  • Raporty o wykorzystaniu: raportuje liczbę żądań wysłanych przez projekt do: interfejsów API Google Maps Platform za pomocą danych logowania powiązanych z Twoim projektem.
  • Raporty dotyczące limitów: przedstawiają wykorzystanie limitu w formie 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 z zastosowanymi środkami związanymi z wykorzystaniem, a także łączną kwotą prognozowany koszt 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 odpowiedzi i kodów odpowiedzi definiujących czy żądanie jest widoczne w sekcjach Użycie, Limit, lub Płatności, zobacz Stan odpowiedzi i raporty –

Raporty o wykorzystaniu, limitach i rozliczeniach Google Maps Platform możesz wyświetlać za pomocą Konsola Cloud.

Raporty o wykorzystaniu

Wykorzystanie zależy od liczby żądań wysyłanych przez Twój projekt do Interfejsy API Google Maps Platform używające danych logowania powiązanych z w projektach AI. Żądania obejmują żądania zakończone pomyślnie i pozostawiające serwer oraz żądania, które powodują błędy klienta. Dane uwierzytelniające obejmują Klucze API i identyfikatory klienta (na potrzeby projektów w abonamencie Premium i przeniesionych projektów premium). Szczegółowe informacje znajdziesz w artykułach Omówienie abonamentu Premium oraz Dowiedz się więcej 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 opóźnienia). Do celów śledzenia:

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

    • Filtruj według przedziału czasu i interfejsu API.
    • Możesz wyświetlać ruch, błędy i czas oczekiwania według kodu odpowiedzi, interfejsu API danych logowania.

  • Konkretny interfejs API: możesz filtrować i grupować dane dotyczące wykorzystania dla określonego interfejsu API. w następujący sposób:

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

Interfejsy API Strona panelu usług

Interfejsy API Usługi Panel zawiera przegląd wskaźników wykorzystania wszystkich interfejsów API tych interfejsów API: Google Maps Platform API oraz Interfejsy API i usługi.

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

  • Wykres Ruch pokazuje wykorzystanie w zapytaniach na minutę (QPM) na interfejs API.

  • Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy za interfejs 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 interfejsów API Strona Panelu usług:

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

    Strona selektora projektów

  2. Wybierz projekt. Interfejsy API Pojawi się strona panelu usług.

    Jeśli strona się nie pojawi, kliknij przycisk menu menu a następnie wybierz Interfejsy API Usługi.

Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsów API.

Strona Przegląd w Mapach Google

Mapy Google Strona Przegląd zawiera tabelę z interfejsami API włączonymi i żądaniami wykorzystania 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 oraz całkowite wykorzystanie w ciągu ostatnich 3 miesięcy.

Zrzut ekranu pokazujący wykres Ogółem z tabelą z listą włączonych interfejsów API i Żądania do interfejsu API z 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.

Interfejsy API i Strona Usługi

Mapy Google Interfejsy API strona usługi zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępnych dla Twojego projektu. W każdym kafelku możesz włączyć lub wyłączyć te elementy usługi, wybierając Włącz lub Wyłącz, i możesz uzyskać dostęp do danych logowania informacje, dane i przewodniki użytkownika dotyczące 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 uzyskać dostęp do interfejsów API Google Maps Platform i Strona Usługi:

  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 i Usługi.

Strona danych Map Google

Mapy Google Strona Wskaźniki powoduje wyświetlenie 3 wykresów: 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 na stronie Wskaźniki znajduje się tabela interfejsów API żądań, błędów i czasu oczekiwania w wybranych interfejsach API.

Korzystając z 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 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ści (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, gdy grupowanie według platformy i domeny jest wybrane 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 API.

Format danych logowania Znaczenie
Nazwa klucza
Na przykład „Klucz aplikacji mobilnej”		 Do wczytania interfejsu API użyto klucza za pomocą ?key=...: nazwy kluczy możesz znaleźć w Maps Platform Konsola w sekcji Klucze Dane logowania.
Numer projektu
Na przykład „project_number:123456”, gdzie 123456 to numer projektu.		 Dane logowania mogą się wyświetlać na 2 sposoby:
  1. W przypadku interfejsów API, które akceptują identyfikatory klienta Maps Platform: A Do wczytania interfejsu API użyto identyfikatora klienta Maps Platform. Przykład: za pomocą funkcji &client=gme-_mycompany_.

    Te interfejsy API akceptują identyfikatory klientów: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, odległość Matrix API, Geocoding API, interfejs Time Zone API. Więcej informacji: Zarządzanie identyfikatorami klientów w ramach abonamentu Premium.

  2. Interfejsy API, które akceptują OAuth: interfejs API został załadowany. za pomocą protokołu OAuth bez klucza interfejsu API.

Wykresy kodu odpowiedzi

Wykresy Ruch według kodu odpowiedzi i Błąd według kodu odpowiedzi są podzielone dla klasy kodu odpowiedzi HTTP. Ta tabela przedstawia mapowanie stan odpowiedzi interfejsu Google Maps Platform API i klasę kodu odpowiedzi HTTP:

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

To żądanie płatne i zużywa limit.
OK 3xx, Odpowiedź udzielona.

To żądanie płatne i zużywa limit.

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

To żądanie płatne i zużywa limit.
ZERO_RESULTS 4xx(1) Odpowiedź pomyślna nie zwróciła żadnych wyników.

To żądanie płatne i zużywa limit.
NOT_FOUND 4xx(1) W przypadku atrybutu Directions API, ten komunikat oznacza, że co najmniej jedna z lokalizacji podanych w Nie udało się przetworzyć danych geograficznych punktu początkowego, miejsca docelowego lub punktów pośrednich żądania.

W przypadku atrybutu Places API ten komunikat oznacza, że podana lokalizacja (place_id) nie została znalezione w bazie danych Miejsc.

To żądanie płatne 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. Sprawdź interfejs API .

To żądanie płatne 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,
Przekroczono limit liczby żądań,
DailyLimitExceeded (Przekroczono limit dzienny),
userRateLimitExceeded		 4xx Błąd klienta spowodowany zbyt dużą liczbą żądań w dozwolonym okresie. Spróbuj jeszcze raz może przesłać żądanie w późniejszym terminie. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API.
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, żądanie błąd analizy lub weryfikacji) 4xx Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedzi interfejsu API .
NOT_FOUND (404) (Nie znaleziono) 4xx W przypadku atrybutu Geolocation API, ten komunikat oznacza, że dane wejściowe nie były wystarczające do wygenerowania od szacowanej lokalizacji.

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

To żądanie płatne i zużywa limit.
UNKNOWN_ERROR 5xx Błąd serwera wskazujący, że nie można kontynuować żądania: wewnętrzny błąd, przeciążona usługa, niedostępna, przekroczenie limitu czasu itp.
1. Aby poprawić spójność raportowania kodów błędów, Google Maps Platform Przenosimy interfejsy API: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla Stany interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla Stany interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded rateLimitExceeded, userRateLimitExceeded 3) z klasy kodu odpowiedzi HTTP 2xx na 5xx dla Stan interfejsu API Map Google: UNKNOWN_ERROR. Podczas przenoszenia możesz zobaczyć oba kody odpowiedzi okresu przejściowego. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź wzrost wskaźnika 4xx lub 5xx w Dane Google Maps Platform jest związany z tą migracją, sprawdzając, który dokładny kod odpowiedzi zwiększa się za pomocą narzędzia Metrics Explorer, (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 odpowiedzi dokumentację interfejsu API, który Cię interesuje (na przykład Geocoding Responses lub odpowiedzi na wskazówki).

Parametr rozwiązań Google Maps Platform

Google Maps Platform udostępnia wiele rodzajów przykładowego kodu, który ułatwia rozpoczęcie pracy i szybkie działanie. Na przykład możesz użyć Szybki konstruktor w Cloud Console postępuj zgodnie z rozwiązaniami branżowymi przewodnikach po implementacji, i wyciągać wnioski ćwiczenia z programowania.

Aby zrozumieć wykorzystanie rozwiązań i sposoby ich ulepszania, Google uwzględnia solution_channel parametr zapytania w wywołaniach interfejsu API w celu zbierania informacji o użyciu przykładowego kodu:

  • Parametr zapytania solution_channel jest domyślnie uwzględniony. w przykładowym kodzie rozwiązania.
  • Parametr zapytania zwraca statystyki dotyczące wdrożenia rozwiązania do Google. aby poprawić jakość rozwiązania w kolejnych iteracjach.
  • Możesz z tego zrezygnować, usuwając zapytanie solution_channel i jego wartość z przykładowego kodu.
  • Nie ma wymogu zachowania parametru. Usuwam zapytanie nie wpływa na wydajność.
  • Parametr zapytania jest używany tylko do przykładowego raportowania wykorzystania kodu.
  • Parametr zapytania jest niezależny od analityki związanej z interfejsem API i raportowania danych. Oznacza to 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 dotyczące liczby żądań, które projekt może wysłać do interfejsów API Google Maps Platform. Żądania mogą zostać ograniczone na 3 sposoby: na dzień, minutę i na użytkownika na minutę. Tylko udane żądania oraz Żądania, które powodują błędy serwera, są wliczane do limitu. Prośby, które nieudane uwierzytelnianie nie jest wliczane do limitu.

Wykorzystanie limitu jest wyświetlane w formie wykresów na stronie Limity w konsoli Cloud. i można je grupować według żądań na minutę. Obecne limity dla wybrane interfejsy API są wyświetlane w tabelach poniżej wykorzystania limitu wykresy.

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

Strona limitów w Mapach Google

Mapy Google Strona Limity pokazuje limity i wykorzystanie limitów dla wybranego przez Ciebie interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch klucze interfejsu API i identyfikatory klientów. Ruch generowany przez ID klienta jest też dostępny w Wykres wskaźników w konsoli Cloud.

Na stronie wyświetlają się tylko żądania, które zużywają limit: żądania udane (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) i żądania, które powodują błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru), UNKNOWN_ERROR).

Żądania, które powodują błędy klienta – uwierzytelnianie, autoryzacja i błędy dotyczące nieprawidłowych argumentów (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 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 interfejsie DISTANCE Matrix API jednostka limitu jest elementem czyli parę miejsc wylotu i przylotu.
  • W przypadku Maps JavaScript API jednostką limitu jest obciążenie mapy.
  • W przypadku Maps SDK na Androida i Maps SDK na iOS jednostka limitu to prośba o Street View lub Panorama strony. Wczytania mapy są dostępne bez opłat i nie zużywają limitu.

Zrzut ekranu przedstawiający Mapy Google Strona Limity w konsoli Google Cloud. Pokazuje limity według interfejsu API za pomocą selektora, a następnie wyświetla obciążenia map w stosunku do wyznaczonych limitów 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.

Jednostki przydziału

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

Interfejs API Google Maps Platform Jednostka limitu
Mapy
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: 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, 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 na temat płatności. dla połączonego konta rozliczeniowego.

Jak odczytywać wykres raportu rozliczeniowego

Raporty rozliczeniowe przedstawiają koszt w postaci skumulowanego wykresu liniowego z upływem czasu. Domyślny przedstawia dzienne koszty z bieżącego miesiąca pogrupowane według wykorzystania projektu (dla wszystkich usług), w tym wszelkie zastosowane środki oraz łączny koszt prognozowany za bieżący miesiąc. Każdy linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi, w kolejności od największej do najmniejszej według kosztu. Więcej informacji o interpretowaniu wykresu raportu rozliczeniowego.

Zrzut ekranu pokazujący raport rozliczeniowy zawierający wykres i tabelę przy użyciu domyślny widok gotowych ustawień
Rysunek 1. Raport rozliczeniowy zawierający wykres i w widoku domyślnych gotowych ustawień.

Wskazówka: przeanalizuj wykorzystanie i koszt na kod SKU

Aby lepiej zrozumieć szczegóły modelu cenowego płatności według wykorzystania jak wpływa to na implementację, należy przyjrzeć się wykorzystaniu i kosztom w podziale na kody SKU.

Raport rozliczeniowy pogrupowany według kodu SKU
Rysunek 2. Tabela rozliczeń zawierająca informacje o wykorzystaniu i kosztu elementów zamówienia według kodu SKU.
.
Zrzut ekranu przedstawiający filtry raportu rozliczeniowego
Rys. 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 raportów rozliczeniowych to Zakres czasowy, Projekty, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według gdzie żądania do interfejsu API.

Aby skategoryzować źródło użytkowania (oprócz usługi), skonfiguruj płatności grupowe według jednej z wymienionych wartości. 3 klucze, które odnoszą się do Interfejsy Google Maps Platform API to goog-maps-api-key-suffix (ostatnie cztery znaków klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) oraz goog-maps-channel (z wartością liczbową, wartość kanału z zapytania API). Więcej o filtrowaniu i grupowaniu.

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

Monitorowanie i ograniczanie wykorzystania

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

  • Skonfiguruj alert dotyczący budżetu. śledzić wzrost wydatków do określonej kwoty. Ustawianie budżetu nie ogranicza wykorzystania interfejsu API, ale ostrzega tylko, gdy wydatki zbliżą się do określoną kwotę.

  • Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Przez ustawienie limitów liczby żądań na dzień, możesz ograniczyć wydatki. Za pomocą prostego równania określamy dzienny poziom w zależności od tego, ile chcesz wydać. Na przykład: (Wydatki miesięczne /cena za każdy kod SKU)/30 = limit żądań dziennie (dla jednego interfejsu API).

Śledzenie wykorzystania na kanał

Aby śledzić wykorzystanie za pomocą kanałów liczbowych, musisz dodać parametr „channel” parametr do żądań do interfejsu API. 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ą odzwierciedlać 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 dane zostaną uwzględnione w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych do BigQuery

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

BigQuery Export umożliwia eksportowanie szczegółowych danych o rozliczeniach usługi Google Cloud (takich jak wykorzystanie prognozowanych kosztów) automatycznie w ciągu dnia do określony przez Ciebie zbiór 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 płatności Eksport rozliczeń BigQuery na swoim koncie.
  • 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 identyfikator Twojego konta rozliczeniowego. poprzedzony prefiksem „gcp_billing_exportv1” i zmianą myślników (-) na podkreślenia (_). Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmienił się w 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 Google i kodu odpowiedzi HTTP zwracanych w odpowiedziach interfejsu API Map Google i klasie kodu odpowiedzi HTTP w raporcie wykorzystania oraz wskazuje jeśli odpowiednie żądanie jest widoczne w raportach na temat wykorzystania, limitu i rozliczeń.

Raport o wykorzystaniu w danych Google Maps Platform. zapewniają szczegółowość na poziomie HTTP response code class. Jeśli potrzebujesz wyższego poziomu szczegółowość – patrz Kody stanu odpowiedzi dostępne w 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 (DANE_NIEDOSTĘPNE),
NOT_FOUND,
ZERO_RESULTS		 200,
404,		 4xx1 Tak Tak Tak
INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ip.		 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 (Przekroczono limit dzienny),
Przekroczono limit liczby żądań,
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, Google Maps Platform Przenosimy interfejsy API: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla Stany interfejsu API Map Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla Stany interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded rateLimitExceeded, userRateLimitExceeded 3) z klasy kodu odpowiedzi HTTP 2xx na 5xx dla Stan interfejsu API Map Google: UNKNOWN_ERROR. Podczas przenoszenia możesz zobaczyć oba kody odpowiedzi okresu przejściowego. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź wzrost wskaźnika 4xx lub 5xx w Dane Google Maps Platform jest związany z tą migracją, sprawdzając, który dokładny kod odpowiedzi zwiększa się za pomocą narzędzia Metrics Explorer, (dowiedz się więcej o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

Raporty dotyczące zaangażowania

Statystyki firmowe

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 poznać trendy dotyczące wyświetleń mapy tylko dla 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 Lokalizator Plus panel statystyk pomaga analizować i generować analizy na podstawie danych, dające jasny obraz tego, jak radzą sobie używając lokalizatora sklepów. Skuteczność możesz mierzyć tygodniowo przez w tym tygodniu, w tym liczbę wyświetleń i interakcji z wyszukiwarką, Informacje o miejscu i ogólny współczynnik zaangażowania. Ponadto w panelu zawiera ważne testy porównawcze w porównaniu z implementacją z innymi sprzedawcami.

Raport Analizy porównawczej umożliwia porównywanie danych ze wskaźnikami dane branżowe pochodzące od innych firm, które je udostępniają. Porównanie zapewnia cenny kontekst, pomagający wyznaczać realistyczne cele, trendy w branży i możliwość sprawdzenia, jak wypadasz w porównaniu z konkurencji.

Aby wyświetlić dane z analizy porównawczej, dane o zaangażowaniu są dołączane anonimowo w testach porównawczych Google. Aby zrezygnować zarówno z oglądania, anonimowo w raportach analizy porównawczej, zgłoszenie. Rozpatrywanie zgłoszenia zazwyczaj zajmuje do 3 dni.