Raportowanie w Google Maps Platform

Raportowanie w Google Maps Platform udostępnia w konsoli Google Cloud zestaw wstępnie zdefiniowanych raportów wizualnych z podstawowymi informacjami o użytkowaniu interfejsu API, limitach i płatnościach. Na podstawie tych raportów możesz określić liczbę wykonanych wywołań interfejsu API, sprawdzić, jak blisko jesteś przekroczenia limitów użycia interfejsu API, oraz monitorować wykorzystanie limitu rozliczeniowego w ciągu czasu.

Dostępne są następujące typy raportów:

• Raporty o korzystaniu: raporty o liczbie żądań wysyłanych przez Twój projekt do interfejsów API Google Maps Platform za pomocą danych logowania powiązanych z projektem.
• Raporty dotyczące limitu: raporty o wykorzystaniu limitu w postaci wykresów, które można grupować według żądań na minutę. Aktualne limity limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.
• Raporty rozliczeniowe: koszty w ciągłym czasie przedstawione w postaci wykresu liniowego z nałożonymi danymi. Wyświetl użycie limitu na bieżący miesiąc, w tym wszystkie zastosowane środki promocyjne związane z użyciem, a także łączny prognozowany koszt za cały bieżący miesiąc.
• scienceRaporty dotyczące zaangażowania: zawierają informacje biznesowe o tym, jak użytkownicy korzystają z Twoich aplikacji map.

Pełną listę stanów i kodów odpowiedzi, które określają, czy żądanie pojawi się w raportach Wykorzystanie, Limit lub Rozliczenia, znajdziesz w artykule Stan odpowiedzi i raporty.

Wyświetlaj raporty o korzystaniu z Google Maps Platform, limitach i płatnościach za pomocą konsoli Cloud.

Raporty o wykorzystaniu

Korzystanie jest określane na podstawie liczby żądań wysyłanych przez projekt do interfejsów API Google Maps Platform za pomocą danych logowania powiązanych z projektem. Żądania obejmują żądania zakończone powodzeniem, żądania, które spowodowały błędy serwera, oraz żądania, które spowodowały błędy po stronie klienta. Dane logowania obejmują: klucze API i identyfikatory klienta (w przypadku projektów w abonamentach Premium i przeniesionych projektów w abonamentach Premium). Więcej informacji znajdziesz w artykule Omówienie abonamentu Premium oraz w informacjach o używaniu identyfikatora klienta.

Dane o użytkowaniu 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: dane o użytkowaniu wszystkich interfejsów API możesz filtrować i grupować w taki sposób:

  • Filtruj według okresu czasu i interfejsu API.
  • Informacje o ruchu, błędach i czasie oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.

• Konkretny interfejs API: dane o użytkowaniu możesz filtrować i grupować w przypadku konkretnego interfejsu API w takie sposoby:

  • Filtruj według okresu, wersji interfejsu API, danych logowania i metod.
  • Możesz sprawdzać ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.

Interfejsy API i usługi – strona panelu

Panel Interfejsy API i usługi zawiera przegląd danych o użyciu wszystkich interfejsów API włączonych w Twoim projekcie: interfejsów API Google Maps Platform oraz innych interfejsów API i usług.

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

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

• Wykres Błędy pokazuje odsetek żądań, które zakończyły się błędem w przypadku każdego interfejsu API.

• Wykres Czas oczekiwania pokazuje medianę czasu oczekiwania na żądania w przypadku każdego interfejsu API.

Pod wykresami znajduje się tabela z wyświetlonymi włączonymi interfejsami API i usługami. Liczba żądań to liczba żądań (w wybranym okresie). Błędy to liczba żądań, które zakończyły się błędem. Czas oczekiwania (średni czas oczekiwania i centyl) to czas oczekiwania na te żądania.

Aby otworzyć stronę panelu Interfejsy API i usługi:

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

   Strona selektora projektów

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

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

Strona Przegląd w Mapach Google

Na stronie Omówienie w Mapach Google znajduje się tabela z interfejsami API włączonymi do użycia i zgłoszeniami dotyczącymi użycia w ciągu ostatnich 30 dni. Żądania według interfejsu API są też wyświetlane w postaci wykresu. Wykres płatności przedstawia Twój bieżący rachunek oraz łączne wykorzystanie z ostatnich 3 miesięcy.

Aby otworzyć stronę Przegląd 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 kliknij Przegląd.

Strona Interfejsy API i usługi Google Maps Platform

Na stronie Interfejsy API i usługi Map Google znajduje się siatka kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępne dla Twojego projektu. Na każdej karcie możesz włączyć lub wyłączyć daną usługę, wybierając Włącz lub Wyłącz. Możesz też uzyskać dostęp do informacji o danych logowania, danych i instrukcji użytkownika dotyczących 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.

Aby otworzyć stronę Interfejsy API i usługi 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 kliknij Interfejsy API i usługi.

Strona Dane Map Google

Na stronie Dane w Mapach Google wyświetlają się 3 wykresy: Ruch, Błędy i Średnia wartość opóźnienia. Dane o użytkowaniu na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.

Pod wykresami na stronie Dane znajduje się tabela interfejsów API, która zawiera żądania, błędy i czas oczekiwania dla wybranych interfejsów API.

Korzystając z menu interfejsu API u góry strony oraz opcji grupowania i filtrowania w panelu po prawej stronie, możesz grupować i filtrować wyświetlane dane o użytkowaniu, wybierając pojedyncze lub wiele interfejsów API, dane logowania, klasy kodu odpowiedzi, typ platformy lub domenę. Możesz też wybrać przedział czasu (od 1 godziny do ostatnich 30 dni) i szczegółowość (co sekundę lub dzień) wyświetlanych danych o wykorzystaniu.

Na poniższych obrazach widać filtry Platforma i Domena dla pojedynczego interfejsu API, gdy na liście Grupuj według wybrane są opcje Platforma i Domena:

Aby uzyskać dostęp do strony Wskaźniki interfejsu API Google Maps Platform:

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

   Otwórz stronę Google Maps Platform

2. W menu po lewej stronie kliknij Dane.

Raportowanie danych logowania

Dane możesz filtrować i grupować według danych logowania użytych do załadowania interfejsu API.

Wykresy kodów odpowiedzi

Wykresy Ruch według kodu odpowiedzi i Błędy według kodu odpowiedzi pokazują wykorzystanie według klasy kodu odpowiedzi HTTP. Ta tabela pokazuje mapowanie między stanem odpowiedzi interfejsu API Google Maps Platform a klasą kodu odpowiedzi HTTP:

Więcej informacji o kodach stanu i komunikatach o błędach znajdziesz w dokumentacji dotyczącej odpowiedzi interfejsu API, który Cię interesuje (np. odpowiedzi geokodowania lub odpowiedzi na pytania o trasy).

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 korzystać z szybkiego kreatora w Cloud Console, stosować się do instrukcji implementacji rozwiązań branżowych i uczyć się na podstawie laboratoriów kodu.

Aby poznać sposób korzystania z naszych rozwiązań i sposoby ich ulepszania, Google uwzględnia parametr zapytania solution_channel w wywołaniach interfejsu API, aby zbierać informacje o użyciu przykładowego kodu:

• Parametr zapytania solution_channel jest domyślnie uwzględniany w przykładowym kodzie rozwiązania.
• Parametr zapytania zwraca Google dane analityczne o wdrożeniu rozwiązania, aby poprawić jego jakość w kolejnych iteracjach.
• Możesz zrezygnować z tej funkcji, usuwając parametr zapytania solution_channel i jego wartość z przykładowego kodu.
• Nie ma wymogu zachowania tego parametru. Usunięcie parametru zapytania nie wpływa na wydajność.
• Parametr zapytania służy tylko do raportowania wykorzystania próbnego kodu.
• Parametr zapytania jest oddzielony od wszelkich analiz i raportów dotyczących interfejsu API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie powoduje wyłączenia wewnętrznego raportowania interfejsu Maps JavaScript API.

Raporty dotyczące limitów

Limity określają liczbę żądań, które projekt może wysyłać do interfejsów API Google Maps Platform. Prośby można ograniczać na 3 sposoby: Do limitu wliczają się tylko udane żądania i żądania, które powodują błędy serwera. Żądania, które nie przeszły uwierzytelniania, nie wliczają się do limitu.

Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w konsoli Cloud, a jego wartości można grupować według liczby żądań na minutę. Aktualne limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.

Aby uzyskać wartość limitu na minutę dla dowolnego interfejsu GMP API, użyj tego kalkulatora.

Strona limitów Map Google

Strona Limity w Mapach Google pokazuje limity i wykorzystanie limitów dla wybranego interfejsu API.

Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch dla kluczy API i identyfikatorów klienta. Ruch związany z identyfikatorem klienta jest też dostępny na wykresie danych w konsoli Cloud.

Na stronie wyświetlane są tylko żądania, które zużywają limit: żądania z pozytywnym wynikiem (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) oraz żądania powodujące błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru), UNKNOWN_ERROR).

Prośby, które powodują błędy po stronie klienta (uwierzytelnianie, autoryzacja i błędy nieprawidłowych argumentów – REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (nieprawidłowy parametr, błąd analizowania żądania)) nie zużywają limitu i nie są wyświetlane.

Jednostka limitu to żądanie dotyczące większości interfejsów API platformy Map Google (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 jednostką limitu jest element, który jest parą „punkt początkowy – punkt docelowy”.
• W przypadku interfejsu Maps JavaScript API jednostką limitu jest wczytanie mapy.
• W przypadku pakietów SDK na Androida i iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Ładowanie map jest bezpłatne i nie zużywa limitu.

Aby otworzyć stronę limitó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 kliknij Limity.
3. Wybierz interfejs API z listy.

Jednostki przydziału

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

Raporty rozliczeniowe

Wyświetlanie raportu rozliczeniowego

Raporty rozliczeniowe dotyczące korzystania z usług Google Maps Platform są dostępne w Google Cloud Console. Więcej informacji znajdziesz w artykule Rozliczenia i płatności.

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

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

   Strona selektora projektów

2. Wybierz projekt.
3. Kliknij kolejno przycisk menu  i Płatności.
4. Jeśli masz kilka kont rozliczeniowych, kliknij Przejdź do połączonego konta, aby otworzyć stronę Przegląd połączonego konta rozliczeniowego.
5. W menu po lewej stronie kliknij Raporty, aby otworzyć stronę Raporty dotyczącą połączonego konta rozliczeniowego.

Jak czytać wykres w raporcie dotyczącym rozliczeń

Raporty rozliczeń przedstawiają koszty w ciągle czasu w postaci wykresu liniowego z wartościami skumulowanymi. Widok domyślny zawiera dzienne koszty związane z korzystaniem w bieżącym miesiącu, pogrupowane według projektu (w przypadku wszystkich usług), z uwzględnieniem wszelkich zastosowanych środków promocyjnych, a także łączne prognozowane koszty za cały bieżący miesiąc. Każda linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi, który jest posortowany według kosztu od największego do najmniejszego. Więcej informacji o interpretowaniu wykresu w raporcie Płatności

Wskazówka: analizowanie wykorzystania i kosztów według kodu SKU

Aby dokładniej zrozumieć szczegóły modelu płatności według wykorzystania oraz wpływ tego modelu na Twoją implementację, sprawdź wykorzystanie i koszt według kodu SKU.

Aby zmienić widok raportu na taki, który wyświetla elementy zamówienia według 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, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według miejsca, z którego pochodzą żądania interfejsu API.

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

Aby wykluczyć z widoku wykresu środki związane z konkretnym sposobem korzystania, odznacz pole wyboru Uwzględnij środki w kosztach w panelu po prawej stronie.

Monitorowanie i ograniczanie zużycia

Aby zaplanować budżet i kontrolować koszty, możesz:

• Ustaw alert dotyczący budżetu, aby śledzić, jak rosną Twoje wydatki w stosunku do określonej kwoty. Ustawienie budżetu nie ogranicza możliwości korzystania z interfejsu API, tylko wysyła powiadomienie, gdy kwota wydatków zbliża się do określonej kwoty.

• Ogranicz dzienne korzystanie z interfejsu API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Możesz ograniczyć wydatki, ustawiając limit żądań na dzień. Aby określić dzienny limit wydatków, skorzystaj z prostej formuły, która zależy od kwoty, jaką chcesz wydać. Na przykład:(miesięczne wydatki /cena za każdy SKU)/30 = limit próśb dziennie (dla jednego interfejsu API).

Śledzenie wykorzystania na kanał

Aby śledzić wykorzystanie za pomocą kanałów numerycznych, musisz dodać parametr „channel” do żądań interfejsu API. Jedynymi dopuszczalnymi wartościami kanału są liczby z przedziału 0–999. Oto kilka przykładów:

• Interfejs API usługi internetowej do geokodowania

  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>

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

Aby filtrować raport rozliczeniowy według kodu SKU i kanału

1. Użyj filtra Grupuj według SKU.
2. Kliknij Etykiety.
3. Kliknij menu Klucz i wybierz goog-maps-channel.
4. Kliknij menu Wartość i wybierz kanały liczbowe, które chcesz odfiltrować.

Pogrupuj dane według klucza etykiety goog-maps-channel, aby zobaczyć koszty poniesione przez poszczególne kanały.

Po wdrożeniu danych o używaniu kanału w żądaniach może minąć krótki czas (do 24 godzin), zanim dane pojawią się w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych za pomocą BigQuery

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

BigQuery Export pozwala Ci automatycznie eksportować w ciągu dnia szczegółowe dane rozliczeniowe Google Cloud (takie jak dane o wykorzystaniu i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem przeglądać te dane w BigQuery w celu przeprowadzenia szczegółowej analizy. Dzięki temu możesz uzyskać dodatkowe informacje o źródłach korzystania z Google Maps Platform.

Jeśli chcesz zacząć korzystać z BigQuery Export i wysyłać zapytania dotyczące danych, możesz wypróbować zapytanie przykładowe poniżej. Przed uruchomieniem tego zapytania musisz:

• Włącz na swoim koncie rozliczenia i  eksport rozliczeń do 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 przez Ciebie zbioru danych (np. „SampleDataSet”).
• BILLING_ACCOUNT_ID to odwołanie do identyfikatora konta rozliczeniowego z przedrostkiem „gcp_billing_exportv1” i z kreskami (-) zastąpionymi przez 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
  

Przydatne materiały

Rozliczenia usługi Google Cloud:

• Tworzenie, modyfikowanie i zamykanie konta rozliczeniowego Cloud
• Zmiana ustawień płatności w projekcie
• Wyświetlanie raportów dotyczących płatności oraz trendów w zakresie kosztów
• Konfigurowanie budżetów i alertów dotyczących budżetu
• Ograniczanie użycia interfejsu API

• Płatności w Google Maps Platform
• Przewodnik optymalizacji
• Sprawdzone metody korzystania z klucza interfejsu API

Stan odpowiedzi i raporty

Tabela poniżej zawiera mapowanie stanu interfejsu Maps API, kodu odpowiedzi HTTP z odpowiedzi interfejsu Maps API i klasy kodu odpowiedzi HTTP w raporcie Użycie, a także wskazuje, czy odpowiednie żądanie pojawia się w raportach Użycie, Limit i Płatności.

Raport o korzystaniu w sekcji Wskaźniki Google Maps Platform zapewnia HTTP response code class poziom szczegółowości. Jeśli potrzebujesz większej szczegółowości, zapoznaj się z kodami stanu odpowiedzi dostępnymi w monitorowaniu wykorzystania Google Maps Platform.

Raporty dotyczące zaangażowania

Statystyki firmy

Google Maps Platform dostarcza Ci informacji o tym, jak użytkownicy korzystają z Twoich map. Te statystyki obejmują kluczowe wskaźniki zaangażowania, takie jak wyświetlenia na mapie lub interakcje z ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne miejsca na reklamy i marketing lub optymalizować wrażenia użytkowników.

Funkcje raportowania statystyk biznesowych:

• Wyświetlanie ogólnego podsumowania statystyk biznesowych, aby szybko sprawdzić najważniejsze trendy w statystykach biznesowych.
• Zagłębianie się w szczegóły, aby analizować określone dane w konsoli, aby dokładniej je poznać.
• Eksportowanie danych do pliku CSV, aby analizować dane z trendów biznesowych w ulubionym narzędziu do analizy biznesowej.

Dostępne dane o zaangażowaniu:

• Wyświetlenia mapy:śledzenie wyświetleń na mapie wynikających z przesunięcia, powiększenia lub przechylenia. Wyświetlenia mapy są obliczane według kodu pocztowego co tydzień (od niedzieli do soboty czasu pacyficznego). Nowe dane są publikowane co tydzień w pierwszą środę po zakończeniu okresu obserwacji.

Właściciele projektów i użytkownicy z rolą Wyświetlający dane analityczne Map mogą wyświetlać statystyki biznesowe na stronie danych w konsoli Cloud. Projekt musi mieć włączony interfejs Maps JavaScript API.

Możesz analizować dane dotyczące zaangażowania bezpośrednio w konsoli, korzystając z opcji Filtruj i Grupuj według, aby uzyskać bardziej szczegółowe informacje. Możesz na przykład filtrować według konkretnego regionu, aby dowiedzieć się, jak zmienia się liczba wyświetleń mapy tylko w przypadku kodów pocztowych z tego regionu. Możesz też grupować według konkretnego regionu, aby agregować interakcje w danym regionie.

Użytkownicy mogą wyeksportować cały zbiór danych lub widok z filtrem do pliku CSV, aby przeanalizować go w ulubionym narzędziu do analizy biznesowej. Możesz pobrać dane z maksymalnie 90 dni. Pobrane pliki zawierające więcej 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.

Dane w statystykach firmy są anonimowe, dlatego odzwierciedlają tylko ogólne trendy dotyczące korzystania z Twoich map. Małe wartości mogą być zaokrąglane do zera, a wkłady wartości odstających może zostać zmniejszony.

Za pomocą uprawnienia do Analytics w Mapach Google możesz kontrolować dostęp do statystyk biznesowych w projekcie Cloud w konsoli Google Cloud. Właściciele projektu mają to uprawnienie domyślnie i w razie potrzeby mogą udostępniać dostęp innym użytkownikom.

Statystyk biznesowych nie należy używać do szacowania kosztów użytkowania. Więcej informacji o użytkowaniu znajdziesz w raportach o korzystaniu.