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życiu interfejsu API, limitach i płatnościach. Korzystając z tych raportów, możesz określić liczbę wykonanych wywołań interfejsu API, sprawdzić, jak blisko jesteś osiągnięcia limitów użycia interfejsu API, oraz monitorować wykorzystanie rozliczeń na przestrzeni 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 tym projektem.
  • Raporty dotyczące limitu: limit żądań jest raportowany na wykresach, 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 na przestrzeni czasu są przedstawiane w postaci wykresu liniowego z wartościami skumulowanymi. Wyświetl użycie limitu w bieżącym miesiącu, w tym wszelkie zastosowane środki promocyjne związane z konkretnym użyciem, a także łączny prognozowany koszt za cały bieżący miesiąc.
  • Raporty dotyczące zaangażowania: zawierają informacje o tym, jak użytkownicy korzystają z Twoich aplikacji map.

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

Wyświetlaj raporty o użyciu, limicie i płatnościach Google Maps Platform za pomocą konsoli Cloud.

Raporty o wykorzystaniu

Korzystanie jest określane na podstawie liczby żądań wysyłanych przez Twój projekt do interfejsów API Google Maps Platform za pomocą danych logowania powiązanych z tym projektem. Żądania obejmują żądania zakończone powodzeniem, żądania, które powodują błędy serwera, oraz żądania, które powodują błędy klienta. Dane logowania obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów w ramach abonamentu Premium i przeniesionych projektów w ramach abonamentu Premium). Więcej informacji znajdziesz w artykule Omówienie abonamentu Premium oraz w informacjach o korzystaniu z 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 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.
    • Informacje o ruchu, błędach i czasie 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żytkowaniu 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. Korzystanie wyświetlane na wykresach i w tabelach możesz filtrować, wybierając przedział 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.

Przykłady monitorowania interfejsów API

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

  1. W konsoli Google Cloud otwórz stronę selektora projektu:

    Strona selektora projektów

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

    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 interfejsu API.

Strona Przegląd w Mapach Google

Na stronie Przegląd w Mapach Google znajduje się tabela z interfejsami API i zapytaniami o użycie w ciągu ostatnich 30 dni. Żądania według interfejsu API są też wyświetlane w postaci wykresu. Wykres płatności zawiera informacje o bieżącym rachunku i łącznym wykorzystaniu z ostatnich 3 miesięcy.

Wykres Przegląd zawierający tabelę z interfejsami API i żądaniami do interfejsów API z ostatnich 30 dni.

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

Strona Interfejsy API i usługi Map Google zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępne w Twoim projekcie. 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.

interfejsy API

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 Map Google znajdują się 3 wykresy: Ruch, Błędy i Średnie opóźnienie. 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 konkretne interfejsy API, dane logowania, klasy kodu odpowiedzi, typ platformy i domena. Możesz też wybrać okres (od 1 godziny do 30 dni) oraz szczegółowość (na sekundę lub dzień) wyświetlanych danych o użytkowaniu.

Strona danych z 3 wykresami: Ruch, Błędy i Średni czas oczekiwania.

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

Filtr Platforma jest widoczny tylko wtedy, gdy wybrany jest pojedynczy interfejs API. Filtr Platforma jest widoczny tylko wtedy, gdy wybrany jest pojedynczy interfejs API.

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.

Format danych logowania Znaczenie
Nazwa klucza
Na przykład „Klucz aplikacji mobilnej”
Do załadowania interfejsu API użyto klucza API: ?key=... nazwy kluczy znajdziesz w konsoli Map Platform w sekcji Klucze i dane logowania.
Numer projektu
Na przykład „numer_projektu:123456”, gdzie 123456 to numer projektu.
Jeśli widzisz te dane logowania, oznacza to jedno z tych 2 możliwych scenariuszy:
  1. W przypadku interfejsów API, które akceptują identyfikatory klienta Maps Platform: do załadowania interfejsu API użyto identyfikatora klienta Maps Platform. Na przykład:&client=gme-_mycompany_.

    Te interfejsy API akceptują identyfikatory klienta: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (starsza wersja), Distance Matrix API (starsza wersja), Geocoding API, Time Zone API. Więcej informacji znajdziesz w artykule zarządzanie identyfikatorem klienta w planie Premium.

  2. W przypadku interfejsów API obsługujących OAuth: interfejs API został załadowany za pomocą OAuth bez klucza interfejsu API.

Wykresy kodów odpowiedzi

Wykresy Ruch według kodu odpowiedziBłędy według kodu odpowiedzi pokazują wykorzystanie według klasy kodu odpowiedzi HTTP. Tabela przedstawia mapowanie między stanem odpowiedzi interfejsu API Google Maps Platform a klasą kodu odpowiedzi HTTP:

Stan interfejsu API Map Google Klasa kodu odpowiedzi HTTP – raport o użytkowaniu
(2xx, 3xx, 4xx, 5xx)
Uwagi
OK 2xx Odpowiedź jest pomyślna.

To jest płatne żądanie, które spowoduje wykorzystanie limitu.
OK 3xx Odpowiedź jest pomyślna.

To jest płatne żądanie, które spowoduje wykorzystanie limitu.

Na przykład żądania dotyczące zdjęcia miejsca, które zostały wykonane pomyślnie, zwracają przekierowanie 302 do obrazu, na który się odwołują.
DATA_NOT_AVAILABLE 4xx(1) Pomyślna odpowiedź wskazująca, że nie ma dostępnych danych dla podanych lokalizacji.

To jest płatne żądanie, które spowoduje wykorzystanie limitu.
ZERO_RESULTS 4xx(1) Odpowiedź z powodu braku wyniku.

To jest płatne żądanie, które spowoduje wykorzystanie limitu.
NOT_FOUND 4xx(1)

W przypadku interfejsu Directions API (starszej wersji) ten komunikat oznacza, że co najmniej 1 z wymienionych w prośbie lokalizacji (początkowej, docelowej lub przelotowej) nie zostało zgeokodowane.

W przypadku Places API ten komunikat wskazuje, że odwołująca się do niej lokalizacja (place_id) nie została znaleziona w bazie danych Places.

Jest to płatne żądanie, które spowoduje wykorzystanie limitu.

INVALID_REQUEST (nieprawidłowa wartość parametru),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED i inne.
4xx Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API.

To jest płatne żądanie, które spowoduje wykorzystanie limitu.
REQUEST_DENIED 4xx Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu i innymi. Aby uzyskać więcej informacji, 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 przedziale czasu. Spróbuj ponownie wysłać prośbę w późniejszym czasie. Aby uzyskać więcej informacji, sprawdź odpowiedź interfejsu API.
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji zapytania) 4xx Błąd klienta spowodowany nieprawidłowym żądaniem. Aby uzyskać więcej informacji, sprawdź odpowiedź interfejsu API.
NOT_FOUND (404) (Nie znaleziono) 4xx

Directions API (Legacy): ten komunikat oznacza, że co najmniej 1 z lokalizacji określonych w źródle, miejscu docelowym lub punktach pośrednich żądania nie zostało powiązane z geografią.

W przypadku interfejsu Geolocation API ten komunikat oznacza, że podanych danych wejściowych było za mało, aby oszacować lokalizację.

W przypadku interfejsu Roads API ten komunikat oznacza, że podanych danych nie można było odpowiednio dopasować do dróg.

Jest to płatne żądanie, które spowoduje wykorzystanie limitu.

UNKNOWN_ERROR 5xx Błąd serwera wskazujący, że żądanie nie może zostać zrealizowane: błąd wewnętrzny, przeciążenie usługi, niedostępność, przekroczenie limitu czasu i inne.

1 Aby zwiększyć spójność raportowania kodów błędów, interfejsy API platformy Map Google przechodzą na: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) z klasy kodu odpowiedzi HTTP 2xx na 5xx w przypadku stanu interfejsu API Map: UNKNOWN_ERROR. W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Aby sprawdzić, czy wzrost wartości 4xx lub 5xxdanych metryki Google Maps Platform jest związany z tą migracją, sprawdź, który kod odpowiedzi wzrasta w eksploratorze danych (więcej informacji o używaniu monitorowania Google Cloud w przypadku Google Maps Platform).

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 pomoże Ci szybko rozpocząć pracę. Możesz na przykład korzystać z Kreatora szybkiego w konsoli Google Cloud, stosować się do instrukcji implementacji dotyczących rozwiązań branżowych oraz korzystać z codelabs.

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 korzystaniu z 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 oddzielny 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: dziennie, co minutę i na użytkownika na minutę. Do limitu wliczane są tylko żądania, które zostały zrealizowane, oraz te, które spowodowały błędy serwera. Żądania, które nie przeszły uwierzytelniania, nie są wliczane do limitu.

Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w konsoli Cloud i można je grupować według liczby żądań na minutę. Aktualne limity limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami limitów użycia.

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

Strona limitów Map Google

Strona Limity Map Google zawiera 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 zakończone powodzeniem (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) oraz żądania powodujące błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru) i UNKNOWN_ERROR).

Żądania, które powodują błędy po stronie klienta (błędy uwierzytelniania, autoryzacji i 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 (interfejsów API Map Static, Street View Static, Geocoding, Directions (starsza wersja), Places, Time Zone, Geolocation i Elevation), ale istnieją pewne wyjątki:

  • W przypadku interfejsu Distance Matrix API (starszej wersji) 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 Mapy na Androida i SDK Mapy na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Ładowanie map jest bezpłatne i nie zużywa limitu.

strona Limity Map w konsoli Google Cloud, na której za pomocą selektora można sprawdzić limity dla poszczególnych interfejsów API, a następnie wyświetlić liczbę wczytań Map w zależności od ustawionych limitów dla danego interfejsu API;

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 zawiera jednostkę limitu dla interfejsów API Google Maps Platform.

Interfejs API Google Maps Platform Jednostka limitu
Mapy
Maps SDK na Androida 1 panoramy
Maps SDK na iOS 1 panoramy
Map Tiles API 1 żądanie
Interfejs Mapy – widok z lotu API 1 żądanie
Maps Static API 1 żądanie
Maps JavaScript API 1 wczytanie mapy
Street View Static API 1 żądanie
Maps Embed API 1 wczytanie mapy
Trasy
Routes API (Compute Routes) 1 żądanie
Interfejs Routes API (Compute Route Matrix) 1 element (para: punkt początkowy – punkt docelowy)
Directions API (starsza wersja) 1 żądanie
Distance Matrix API (starsza wersja) 1 element (para: punkt początkowy – punkt docelowy)
Roads API 1 żądanie
Route Optimization API 1 żądanie
Pakiet SDK do nawigacji na Androida 1 miejsce docelowe
Pakiet SDK do nawigacji na iOS 1 miejsce docelowe
Miejsca
Places API 1 żądanie
Places Aggregate API 1 żądanie
Address Validation API 1 żądanie
Geocoding API 1 żądanie
Geolocation API 1 żądanie
Time Zone API 1 żądanie
Środowisko
Interfejs API jakości powietrza (CurrentConditions i HeatmapTile) 1 żądanie
Air Quality API (historia) 1 strona
Pollen API 1 żądanie
Solar API 1 żądanie

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 sekcji Rozliczenia.

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

  1. W konsoli Google Cloud otwórz stronę selektora projektu:

    Strona selektora projektów

  2. Wybierz projekt.
  3. Kliknij kolejno przycisk menu menuPł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 wyświetla dzienne koszty związane z korzystaniem w bieżącym miesiącu pogrupowane według projektu (w przypadku wszystkich usług), w tym z uwzględnieniem wszelkich zastosowanych środków, a także łączny prognozowany koszt 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

Zrzut ekranu raportu rozliczeniowego z wykresem i tabelą w domyślnym widoku wstępnym
Rysunek 1. Raport Płatności z wykresem i tabelą w domyślnym widoku wstępnie ustawionym

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

Aby dokładniej zrozumieć szczegóły modelu płatności według wykorzystania i sposób, w jaki wpływa on na Twoją implementację, sprawdź wykorzystanie i koszt według kodu SKU.

Raport rozliczeniowy pogrupowany według kodu SKU
Rysunek 2. Tabela płatności z elementami zamówienia dotyczącymi użycia i kosztów według kodu SKU
Zrzut ekranu pokazujący filtry raportu dotyczącego płatności
Rysunek 3. Filtry raportu rozliczeniowego
Aby zmienić widok raportu tak, aby 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 powią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 (wartość kanału numerycznego z zapytania 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:

  • Ustawianie budżetu

    alert, aby śledzić, jak Twoje wydatki rosną w stosunku do określonej kwoty. Budżet nie ogranicza użycia interfejsu API, tylko wysyła powiadomienie, gdy kwota wydatków zbliża się do określonej kwoty.

  • Ustawienie limitu dziennego interfejsu API

    użycie, aby zarządzać kosztami korzystania z płatnych interfejsów API; Możesz ograniczyć wydatki, ustawiając limit żądań dziennie. Użyj równania, aby określić dzienny limit wydatków w zależności od kwoty, jaką chcesz wydać. Na przykład: (Wydatki miesięczne / cena za każdy SKU) / 30 = limit próśb dziennie (dla jednej 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 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 monitorować wykorzystanie kanału bezpośrednio w raporcie rozliczeniowym. Użycie kanału znajduje się w sekcji Etykiety jako klucz goog-maps-channel.

Jak filtrować według etykiet
Rysunek 4. Filtrowanie według SKU i kanałów
Aby filtrować raport rozliczeniowy według kodu SKU i kanału
  1. Użyj filtra Grupuj według SKU.
  2. Kliknij Etykiety.
  3. W menu Klucz wybierz goog-maps-channel.
  4. W menu Wartość wybierz kanały liczbowe, które chcesz filtrować.

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

Po wdrożeniu danych o używaniu kanału w żądaniach może wystąpić krótka zwłoka (do 24 godzin) przed uwzględnieniem tych danych w raporcie rozliczeniowym.

Eksportowanie danych rozliczeniowych za pomocą BigQuery

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

Korzystając z BigQuery Export, możesz automatycznie eksportować w ciągu dnia szczegółowe dane rozliczeniowe usługi Google Cloud (takie jak dane o wykorzystaniu i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem szczegółowo analizować te dane w BigQuery. Dzięki temu możesz uzyskać więcej informacji o źródłach korzystania z Google Maps Platform.

Jeśli chcesz zacząć korzystać z BigQuery Export i wysyłać zapytania do 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 prefiksem „gcp_billing_exportv1” i zmianą myślników (-) 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

Tabela poniżej zawiera mapowanie stanu interfejsu Maps API, kodu odpowiedzi HTTP zwracanego w odpowiedziach 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 użytkowaniu w danych Google Maps Platform

zapewniają szczegółowość HTTP response code class. Jeśli potrzebujesz większej szczegółowości, zapoznaj się z kodami stanu odpowiedzi.

dostępne w monitorowaniu wykorzystania Google Maps Platform.

Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Dostępne w raporcie Wykorzystanie 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,
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
REQUEST_DENIED 200,
400,
403
4xx1 Tak Nie Nie
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 Tak Nie Nie
UNKNOWN_ERROR 200,
500,
503
5xx1 Tak Tak Nie
1 Aby zwiększyć spójność raportowania kodów błędów, interfejsy API platformy Map Google przechodzą na: 1) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – stan, 2) z klasy kodu odpowiedzi HTTP 2xx na 4xx w przypadku stanów interfejsu API Map: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) z klasy kodu odpowiedzi HTTP 2xx na 5xx w przypadku stanu interfejsu API Map: UNKNOWN_ERROR. W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie. Aby sprawdzić, czy wzrost wartości 4xx lub 5xxdanych metryki Google Maps Platform jest związany z tą migracją, sprawdź, który kod odpowiedzi wzrasta w eksploratorze danych (więcej informacji o używaniu monitorowania Google Cloud w przypadku 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 do reklamowania i marketingu lub optymalizować wrażenia użytkowników.

Możliwości raportowania statystyk biznesowych:

  • Wyświetlanie ogólnego podsumowania statystyk firmy, aby szybko sprawdzić najważniejsze trendy w statystykach firmy.
  • szczegółowe analizowanie konkretnych danych w konsoli, aby lepiej je poznać;
  • Eksportowanie danych do pliku CSV, aby móc 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 Filtrowanie i Grupowanie 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 zająć kilka minut w zależności od wybranego zakresu czasowego.

Eksportowanie statystyk firmy

Dane w statystykach biznesowych 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ą uprawnień 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ępnić 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 z usługi.