Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform umożliwia dostęp do zestawu wstępnie zdefiniowanych raportów wizualnych, które pozwalają łatwo przeglądać podstawowe informacje o wykorzystaniu interfejsu API, limitach i rozliczeniach w Google Cloud Console. Możesz szybko ustalić liczbę wywołań interfejsu API, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API i monitorować wykorzystanie płatności.

Typy raportów:

• Raporty o wykorzystaniu: podaje liczbę żądań, które Twój projekt wysyła do interfejsów API Google Maps Platform, używając danych logowania powiązanych z projektem.
• Raporty o limitach: zawierają informacje o wykorzystaniu limitu na wykresach, które można grupować w żądaniach na minutę. Aktualne limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.
• Raporty rozliczeniowe: koszty w czasie są przedstawiane jako skumulowany wykres liniowy. Wyświetl wykorzystanie bieżącego limitu w bieżącym miesiącu, w tym wszelkie zastosowane środki do wykorzystania, a także łączny prognozowany koszt za cały bieżący miesiąc.
• Raporty zaangażowania: dostarczaj firmom informacje o tym, jak użytkownicy wchodzą w interakcje z Twoimi aplikacjami do map.

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

Raporty o wykorzystaniu, limicie i rozliczeniach w Google Maps Platform możesz wyświetlać w konsoli Google Cloud.

Raporty o wykorzystaniu

Wykorzystanie jest oparte na liczbie żądań przesłanych przez Twój interfejs API do Google Maps Platform przy użyciu danych logowania powiązanych z Twoim projektem. Żądania obejmują żądania, które zakończyły się niepowodzeniem, oraz błędy, które zakończyły się błędem serwera. Dane logowania obejmują klucze interfejsu API i identyfikatory klientów (na potrzeby projektów Premium i przeniesionych do abonamentu Premium).

Wskaźniki użytkowania są wyświetlane w tabelach (Żądania, Błędy i Czas oczekiwania) oraz na wykresach (Ruch, Błędy i Czas oczekiwania). Śledzenie:

• Wskaźniki użytkowania dla wszystkich interfejsów API można filtrować według przedziału czasowego oraz interfejsu API. Można też wyświetlić dane o ruchu, błędach i czasie oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
• Wskaźniki wykorzystania konkretnego interfejsu API można filtrować według przedziału czasu oraz jego wersji, danych logowania i metod. Możesz też wyświetlać ruch, błędy i czasy oczekiwania według grup odpowiedzi, metody i wersji interfejsu API oraz danych logowania.

Strona interfejsów API i usług

Strona Panel interfejsu API i usług zawiera przegląd danych o wykorzystaniu wszystkich interfejsów API włączonych w Twoim projekcie (interfejsów Google Maps Platform API oraz innych interfejsów API i usług).

Strona Pulpit nawigacyjny zawiera 3 wykresy i tabelę. Możesz filtrować dane wyświetlane na wykresach i w tabelach, wybierając przedział czasu (od 1 godziny do ostatnich 30 dni).

Wykres Ruch przedstawia wykorzystanie zapytań na sekundę (QPS) na interfejs API. Wykres Błędy pokazuje odsetek żądań, które zakończyły się błędem na API. Wykres czasu oczekiwania pokazuje medianę czasu oczekiwania żądań na interfejs API.

Pod wykresami znajduje się tabela z włączonymi interfejsami API i usługami. Żądania to liczba żądań (w wybranym okresie). Błędy to liczba żądań, które spowodowały błędy. Opóźnienie (średnie opóźnienie i percentyl) to czas oczekiwania dla tych żądań.

Aby uzyskać dostęp do strony „Interfejsy API i usługi”:

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

   Strona wyboru projektu

2. Wybierz projekt. Pojawi się strona Interfejsy API i usługi.
   
   Jeśli strona się nie pojawi, kliknij przycisk menu , a potem Interfejsy API i usługi.

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

Strona omówienia Map Google

Strona Przegląd w Mapach Google zawiera tabelę z interfejsami API włączonymi i żądaniami użycia z ostatnich 30 dni. Żądania wysyłane przez interfejs API są też wyświetlane w formie wykresu. Wykres rozliczeniowy pokazuje Twój aktualny rachunek i całkowite wykorzystanie w ciągu ostatnich 3 miesięcy.

Uwaga: jeśli wybierzesz nazwę włączonego interfejsu API, przekierujemy Cię na stronę Wskaźniki w Mapach Google dla tego interfejsu API.

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

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

   Otwórz stronę Google Maps Platform

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

Strona interfejsów API Google Maps Platform

Strona Interfejsy API Map Google zawiera 2 tabele. Tabela Włączone interfejsy API pokazuje liczbę żądań, liczbę błędów i średnie opóźnienie 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.

Uwaga: po wybraniu nazwy włączonego interfejsu API nastąpi przekierowanie na stronę Dane w Mapach Google dla tego interfejsu API.

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

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

   Otwórz stronę Google Maps Platform

2. W menu po lewej stronie wybierz Interfejsy API.

Strona wskaźników w Mapach Google

Na stronie Dane w Mapach Google znajdują się 3 wykresy: Ruch, Błędy i Mediana czasu oczekiwania. Dane o wykorzystaniu na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.

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

W menu API u góry oraz opcjami grupowania i filtrowania w panelu po prawej stronie możesz grupować i filtrować wyświetlane dane o wykorzystaniu, wybierając konkretne interfejsy API, dane logowania, klasy kodu odpowiedzi, typ platformy lub domenę. Możesz też wybrać przedział czasu (od godziny do ostatnich 30 dni) oraz szczegółowość (dla sekund lub dni) dla wyświetlanych wskaźników użytkowania.

Uwaga: opcje Platforma i Domena na liście Pogrupowane według, a filtry Platforma i Domena pojawiają się tylko wtedy, gdy wybierzesz z listy jeden interfejs API.

Na poniższych obrazach widać filtry Platforma i Domena dla pojedynczego interfejsu API, gdy w menu Grupowanie według wybrano opcję Platforma i Domena:

Aby uzyskać dostęp do strony wskaźników interfejsu Google Maps Platform API:

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

   Otwórz stronę Google Maps Platform

2. W menu po lewej stronie wybierz Dane.

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 tabeli poniżej znajdziesz mapowanie stanu odpowiedzi interfejsu Google Maps Platform API do klasy kodu odpowiedzi HTTP:

Stan interfejsu API Map Google	Klasa kodu odpowiedzi HTTP – raport o wykorzystaniu (2xx, 3xx, 4xx, 5xx)	Uwagi
OK	2xx	Odpowiedź się powiodła. Jest to żądanie podlegające rozliczeniu i zużywa limit.
OK	3xx	Odpowiedź się powiodła. Jest to żądanie podlegające rozliczeniu i zużywa limit. Na przykład żądania Umieść zdjęcie zwracają kod 302 do wskazanego obrazu.
NIE_DOSTĘPNE DANE	4xx^(1)	Odpowiedź informująca o braku dostępu do danych o wpisanych lokalizacjach. Jest to żądanie podlegające rozliczeniu i zużywa limit.
ZERO_RESULTS	4xx^(1)	Pomyślna odpowiedź nie zwróciła żadnych wyników. Jest to żądanie podlegające rozliczeniu i zużywa limit.
NIE ZNALEZIONO	4xx^(1)	W przypadku interfejsu Route API wskazuje to, że co najmniej jedna z lokalizacji określonych w punkcie początkowym, docelowym lub punktach pośrednich żądania nie mogła zostać zakodowana. W przypadku interfejsu Places API oznacza to, że wymienionej 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 itp.	4xx	Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API. Jest to żądanie podlegające rozliczeniu i zużywa limit.
NIEDOZWOLONA	4xx	Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu itp. Aby uzyskać więcej informacji, sprawdź odpowiedź API.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, RateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	Błąd klienta spowodowany zbyt dużą liczbą żądań w danym dozwolonym okresie. Ponów żądanie później. Więcej informacji znajdziesz w odpowiedziach interfejsu API.
INVALID_REQUEST (nieprawidłowy lub brakujący parametr; błąd żądania/analizy)	4xx	Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedziach interfejsu API.
NOT_FOUND (404) (Nie znaleziono)	4xx	W przypadku interfejsu Geolocation API oznacza to, że dane wejściowe nie były wystarczające do opracowania prognozy lokalizacji. W przypadku interfejsu Roads API oznacza to, że danych wejściowych nie udało się wciągnąć do dróg. Jest 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, przekroczony 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_RESULTS - stan, 2) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, UNKNOWN_ERROR, UNKNOWN_ERROR, {1, 15, {1, 5, {1, 5,}2xxuserRateLimitExceeded5xx W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź, że wzrost liczby wskaźników 4xx lub 5xx w Google Maps Platform Metrics jest związany z tą migracją, sprawdzając w Metrics Explorer, jaki dokładnie kod odpowiedzi się zwiększa, (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

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

Parametr rozwiązań Google Maps Platform

Google Maps Platform udostępnia wiele typów kodu przykładowego, który ułatwia szybkie rozpoczęcie pracy. Możesz na przykład skorzystać z szybkiego konstruktora w Cloud Console, postępować zgodnie z branżowymi przewodnikami po implementacji i zapoznać się z ćwiczeniami z programowania.

Aby dowiedzieć się, jak korzystać z naszych rozwiązań i jak je ulepszać, Google uwzględnia parametr zapytania solution_channel w wywołaniach interfejsu API. Dzięki temu można zebrać informacje na temat przykładowego wykorzystania kodu:

• Parametr zapytania solution_channel jest domyślnie uwzględniony w przykładowym kodzie rozwiązania.
• Parametr zapytania zwraca do Google dane analityczne dotyczące rozpowszechnienia rozwiązania, aby poprawić jego jakość w przyszłych wystąpieniach.
• Możesz zrezygnować, usuwając parametr zapytania solution_channel i jego wartość z przykładowego kodu.
• Nie ma wymogu zachowania parametru. Usunięcie parametru zapytania nie wpłynie na skuteczność.
• Parametr zapytania jest używany tylko na potrzeby raportowania wykorzystania przykładowego kodu.
• Parametr zapytania jest niezależny od statystyk i raportów związanych z interfejsem API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie spowoduje wyłączenia wewnętrznego raportowania interfejsu API JavaScript Map Google.

Raporty dotyczące limitów

Limity określają liczbę żądań, które Twój projekt może wysłać do interfejsów API Google Maps Platform. Żądania można ograniczać na 3 sposoby: na dzień, na minutę i na użytkownika na minutę. Do limitu wliczają się tylko te żądania i żądania, które spowodowały 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 limitów.

Użyj tego kalkulatora, aby poznać wartość limitu na minutę dla każdej usługi interfejsu GMP API.

Strona limitów w Mapach Google

Na stronie Limity w Mapach Google możesz sprawdzić limity oraz wykorzystanie określonego interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch dotyczący kluczy interfejsu API i identyfikatorów klientów. Ruch związany z identyfikatorem klienta jest również dostępny na wykresie Wskaźniki w Cloud Console.

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

Jednostka limitu to żądanie wysyłane do większości interfejsów API Google Maps Platform (interfejsu Static API API, Street View Static API, Geocoding API, Signals API, Places API, Time Zone API, Geolocation API i Elevation API). Istnieją jednak pewne wyjątki:

• W przypadku interfejsu Length Matrix API jednostką limitu jest element, który jest parą cel-miejsce docelowe.
• W przypadku interfejsu Maps JavaScript API jednostką limitu jest wczytanie mapy.
• W przypadku pakietu SDK Maps na Androida i pakietu SDK na iOS iOS limit jednostek to żądanie Street View/wczytanie panoramy (Ładowanie mapy jest dostępne bezpłatnie i nie powoduje wykorzystania limitu).

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

1. Otwórz stronę Google Maps Platform w konsoli Google 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

W tabeli poniżej podano jednostkę przydziału 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
Maps Static API	1 żądanie
Maps JavaScript API	1 ładowanie mapy
Street View Static API	1 żądanie
Maps Embed API	1 ładowanie mapy
Trasy
Routes API (obszary obliczeniowe)	1 żądanie
Routes API (Compute Route Matrix)	1 element (para źródło-miejsce docelowe)
Directions API	1 żądanie
Distance Matrix API	1 element (para źródło-miejsce docelowe)
Roads API	1 żądanie
Miejsca
Places API	1 żądanie
Address Validation API	1 żądanie
Geocoding API	1 żądanie
Geolocation API	1 żądanie
Time Zone API	1 żądanie

Raporty rozliczeniowe

Wyświetlanie raportu rozliczeniowego

Raporty rozliczeniowe dotyczące używania usług Google Maps Platform są dostępne w konsoli Google Cloud (patrz Rozliczenia).

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

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

   Strona wyboru projektu

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

Jak odczytywać wykres raportu rozliczeniowego

Raporty rozliczeniowe przedstawiają wykres kosztów w czasie na wykresie skumulowanym liniowym. Widok domyślny zawiera dzienne koszty wykorzystania w bieżącym miesiącu pogrupowane według projektu (dla wszystkich usług), w tym wszystkie zastosowane środki do wykorzystania, a także łączny prognozowany koszt za cały bieżący miesiąc. Każdy wiersz na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi o najwyższym lub najmniejszym koszcie. Więcej informacji o interpretowaniu wykresu z raportu rozliczeniowego

Ilustracja 1. Raport rozliczeniowy zawierający wykres i tabelę przy użyciu domyślnego widoku gotowych ustawień

Wskazówka: przeanalizuj wykorzystanie i koszt SKU

Aby lepiej zrozumieć szczegóły modelu cenowego w modelu płatności według wykorzystania i jego wpływu na implementację, przyjrzyj się wykorzystaniu i kosztowi według kodu SKU.

Ilustracja 2. Tabela rozliczeń z użyciem elementów zamówienia i kosztów według SKU

Ilustracja 3. Filtry raportu rozliczeniowego

Aby zmienić widok raportów na taki, który zawiera 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 pozwalają filtrować według miejsc, w których żądania interfejsu API są obsługiwane.

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

Możesz zmienić widok wykresu, aby wykluczyć środki z tytułu wykorzystania. Aby to zrobić, odznacz pole wyboru Uwzględnij środki w kosztach w panelu po prawej stronie.

Monitorowanie i ograniczanie wykorzystania

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

• Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków na konkretną kwotę. Ustawienie budżetu nie ogranicza wykorzystania interfejsu API, a jedynie informuje o tym, kiedy kwota wydatków będzie bliska ustalonej kwoty.
• Ogranicz dzienne wykorzystanie interfejsów API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Ustawiając limity żądań dziennie, możesz ograniczyć wydatki. Użyj prostego równania, aby określić limit dzienny w zależności od tego, ile chcesz wydać. Przykład: (miesięczne wydatki /cena za każdy kod SKU)/30 = liczba żądań dziennie, w przypadku jednego interfejsu API. Pamiętaj, że Twoja implementacja może korzystać z wielu płatnych interfejsów API, więc dostosuj równanie według potrzeb. Pamiętaj, że co miesiąc możesz otrzymać 200 USD do wykorzystania w Google Maps Platform.

Śledzenie wykorzystania na kanał

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

• Interfejs API usług kodowania danych geograficznych

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Interfejs API JavaScript Map Google

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Monitoruj wykorzystanie kanałów bezpośrednio w raporcie rozliczeniowym. W sekcji Etykiety będzie on widoczny jako klucz goog-maps-channel.

Uwaga: obecnie dane kanału nie są dostępne w przypadku opcji Drogi – Podróże SKU, Drogi – Najbliższa wersja SKU, Drogi – Limity prędkości, Kod SDK na Androida i Pakiet SDK Map na iOS.

Ilustracja 4. Filtrowanie według SKU i kanałów

Filtrowanie raportu rozliczeniowego według kodu SKU i kanału

1. Użyj filtra kodów SKU Grupuj według.
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 dane według etykiety etykiety goog-maps-channel, aby wyświetlić koszt wygenerowany przez każdy kanał.

Po wdrożeniu danych o korzystaniu z kanału może minąć trochę czasu (do 24 godzin), zanim zostaną one uwzględnione w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych za pomocą BigQuery

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

BigQuery Export umożliwia automatyczne eksportowanie szczegółowych danych rozliczeniowych Rozliczeń usługi Google Cloud (na przykład wykorzystania zasobów i szacunkowych kosztów) do określonego przez Ciebie zbioru danych BigQuery. Dzięki temu uzyskasz dostęp do danych rozliczeniowych w BigQuery na potrzeby szczegółowej analizy. W ten sposób możesz uzyskać bardziej szczegółową analizę źródeł wykorzystania Google Maps Platform.

Jeśli chcesz zacząć korzystać z eksportów BigQuery i wykonywać zapytania na danych, możesz wykonać poniższe przykładowe zapytanie. Zanim uruchomisz to zapytanie, musisz:

• Włącz na swoim koncie płatności i eksport płatności BigQuery.
• Format tabeli to PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, gdzie:
• PROJECT_ID to Twój rzeczywisty identyfikator projektu (np. „mój-projekt-123456”).
• DATASET_NAME to nazwa utworzonego zbioru danych (np. „SampleDataSet”).
• BILLING_ACCOUNT_ID to odwołanie do Twojego identyfikatora konta rozliczeniowego, z prefiksem „gcp_billing_exportv1” i zamienionym łącznikiem (-) na podkreślenia (_). Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmieni się na gcp_billing_export_v1_123456_789AB_CDEF01.

Uwaga: gdy utworzysz nowy zbiór danych, od razu pojawi się on w interfejsie, ale tabela do wysłania nie będzie jeszcze widoczna. Tabela zostanie wygenerowana automatycznie po kilku godzinach. Twoje dane pojawią się po około 24 godzinach. Zbiór danych BigQuery zawiera tylko dane o użyciu i kosztach wygenerowane od daty skonfigurowania eksportu rozliczeń, a później po jego zakończeniu. Oznacza to, że dane rozliczeniowe nie są dodawane wstecz, więc nie pojawią się dane sprzed włączenia eksportu BigQuery.

  #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
  

Przydatne materiały

Rozliczenia usługi Google Cloud:

• Tworzenie, modyfikowanie i zamykanie konta rozliczeniowego Cloud
• Modyfikowanie ustawień płatności projektu
• Wyświetlanie raportów dotyczących rozliczeń oraz trendów w zakresie kosztów
• Ustawianie budżetów i alertów
• Ograniczenie wykorzystania interfejsu API

Google Maps Platform:

• Płatności w Google Maps Platform
• Przewodnik po optymalizacji
• Najważniejsze sprawdzone metody dotyczące interfejsu API

Stan odpowiedzi i raporty

W tabeli poniżej znajdziesz mapowanie stanu interfejsu API Map Google, kodu odpowiedzi HTTP zwróconego w odpowiedziach interfejsu API Map Google i klasy kodu odpowiedzi HTTP w raporcie o wykorzystaniu, a także czy odpowiednie żądanie pojawia się w raportach Wykorzystanie, Limit i Płatności.

Uwaga: z dotychczasowych powodów kod odpowiedzi HTTP zwracany w odpowiedzi na żądania do interfejsu API Google Maps Platform może się różnić od kodu odpowiedzi HTTP w raportach o korzystaniu (Google Maps Platform Metrics). Dane w raportach o wykorzystaniu używają zestawu wartości kodu odpowiedzi, które są zgodne z tymi, które są używane w nowszych interfejsach API. Poprawi to możliwość korzystania z interfejsów API w usługach Google Maps Platform Metrics i Google Maps Platform Monitoring.

Raport o wykorzystaniu w Wskaźnikach Google Maps Platform zapewnia szczegółowość HTTP response code class. Jeśli chcesz uzyskać wyższy poziom szczegółowości, przeczytaj artykuł Kody stanu odpowiedzi dostępne w narzędziu Monitorowanie wykorzystania Google Maps Platform.

Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google		Dostępne w raporcie o korzystaniu	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	4xx^1	Tak	Tak	Tak
NOT_FOUND (Street View Static API, Geolocation i interfejsy Roads API), ZERO_RESULTS (Street View Static API)	404	4xx	Tak	Tak	Tak
INVALID_REQUEST (nieprawidłowa wartość parametru), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, itd.	200/400	4xx	Tak	Tak	Tak
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy żądania)	200/400	4xx	Tak	Nie	Nie
NIEDOZWOLONA	200/400/403	4xx^1	Tak	Nie	Nie
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitPrzekroczono, RateLimitExceeded, userRateLimitExceeded	200/403, 429	4xx^1	Tak	Nie	Nie
UNKNOWN_ERROR	200/500, 503	5xx^1	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_RESULTS - stan, 2) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, UNKNOWN_ERROR, UNKNOWN_ERROR, {1, 15, {1, 5, {1, 5,}2xxuserRateLimitExceeded5xx W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają. Potwierdź, że wzrost liczby wskaźników 4xx lub 5xx w Google Maps Platform Metrics jest związany z tą migracją, sprawdzając w Metrics Explorer, jaki dokładnie kod odpowiedzi się zwiększa, (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).

Raporty z sekcji Zaangażowanie

Ta usługa lub funkcja ma charakter eksperymentalny (przed GA). Usługi i funkcje, które nie są ogólnodostępne, mogą mieć ograniczoną obsługę, a zmiany dotyczące takich usług mogą być niezgodne z innymi ich wersjami. Oferty, które nie są ogólnodostępne, podlegają szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisie etapu uruchamiania.

Statystyki firmy

Google Maps Platform zapewnia wgląd w to, jak użytkownicy korzystają z Twoich map. Statystyki te obejmują kluczowe wskaźniki zaangażowania, takie jak wyświetlenia na mapie lub interakcje z ciekawym miejscem. Możesz je analizować, aby odkryć popularne lokalizacje na potrzeby reklam i marketingu lub zoptymalizować wrażenia użytkowników.

Funkcje raportowania biznesowego obejmują:

• wyświetlać ogólne podsumowanie statystyk firmy, aby szybko sprawdzać najważniejsze trendy biznesowe;
• Analizowanie konkretnych danych w konsoli, aby bardziej szczegółowo poznać dane
• Eksportowanie danych do pliku CSV, aby móc analizować dane ze statystyk biznesowych w ulubionym narzędziu do analizy firmy

Dostępne wskaźniki zaangażowania:

• Wyświetlenia mapy: śledź wyświetlenia mapy na podstawie ich przesuwania, powiększania i przechylania. 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 okresie obserwacji.

Użytkownicy mogą przeglądać statystyki biznesowe na stronie wskaźników w Cloud Console. Widoki mapy są obecnie dostępne do testowania tylko dla niektórych programistów interfejsu API JavaScript Map Google.

Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli za pomocą funkcji Filtruj i Grupuj według, dzięki którym uzyskasz bardziej szczegółowe dane. Możesz np. filtrować dane według konkretnego regionu, by dowiedzieć się, jakie są trendy wyświetleń map tylko dla kodów pocztowych w tym regionie. Z drugiej strony warto pogrupować dane według określonego regionu, aby gromadzić interakcje w obrębie tego regionu.

Użytkownicy mogą wyeksportować do zbioru danych cały zbiór danych lub przefiltrowany widok, aby przeanalizować go w swoim ulubionym narzędziu do analizy firmy. Możesz pobrać maksymalnie 90 dni naraz, a pobieranie ponad 60 tys. komórek jest skracane. Eksportowanie danych widoków mapy do pliku CSV może potrwać kilka minut w zależności od wybranego przedziału czasu.

Dane biznesowe są anonimizowane, więc odzwierciedlają tylko ogólne trendy dotyczące interakcji z mapami. Niskie liczby mogą być zaokrąglone do zera, a wyniki odstałe od wyników mogą być mniejsze.

Dostęp do statystyk firmy w projekcie Google Cloud możesz kontrolować w Google Cloud Console za pomocą uprawnień Map Analytics. Właściciele projektu domyślnie otrzymują te uprawnienia i w razie potrzeby mogą przyznawać je innym użytkownikom.

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

Lokalizator Plus

Panel Analytics umożliwia użytkownikom Lokalizatora Plus analizowanie i generowanie statystyk na podstawie danych, dając jasny obraz tego, jak bardzo kupujący zwracają się do lokalizatora sklepów. Możesz mierzyć skuteczność z tygodnia na tydzień, uwzględniając m.in. liczbę wyświetleń, liczbę interakcji z informacjami o wyszukiwarce i informacjach o miejscu oraz ogólny współczynnik zaangażowania. Znajdziesz w nim też ważne porównania porównawczej Twojej implementacji z innymi sprzedawcami.

• Otwórz Lokalizator Plus w Google Cloud Console.
• Przejdź do sekcji Raporty zaangażowania w konsoli Google Cloud, aby zobaczyć panel ze statystykami.

Raport Analiza porównawcza umożliwia porównywanie danych Twojej firmy ze zbiorczymi danymi o branży pochodzącymi z innych firm, które udostępniają dane swojej firmy. Porównanie przedstawia cenny kontekst i ustala realistyczne cele, daje wgląd w trendy branżowe oraz pozwala porównać skuteczność z konkurencją.

Dane o zaangażowaniu są anonimowo uwzględniane w analizach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania i uwzględniania danych o zaangażowaniu w raportach porównawczych, prześlij zgłoszenie do zespołu pomocy. Zgłoszenie zostanie automatycznie usunięte w ciągu 3 dni.