Raportowanie w Google Maps Platform udostępnia zestaw wstępnie zdefiniowanych wizualnych raportów dotyczących podstawowego wykorzystania interfejsu API, limitów i informacji rozliczeniowych w Google Cloud Console. Raporty te mogą Ci służyć do określania liczby wykonanych wywołań interfejsu API oraz tego, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, a także do monitorowania wykorzystania płatności na przestrzeni czasu.
Typy raportów obejmują:
- Raporty o wykorzystaniu: zawierają liczbę żądań wysyłanych przez Twój projekt do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z Twoim projektem.
- Raporty dotyczące limitów: przedstawiają wykorzystanie limitu na wykresach, które można grupować w żądaniach na minutę. Aktualne limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
- Raporty rozliczeniowe: przedstawiają koszty w czasie w postaci skumulowanego wykresu liniowego. Wyświetl wykorzystanie limitu w bieżącym miesiącu, w tym wszelkie zastosowane środki związane z wykorzystaniem, a także łączny prognozowany koszt w całym bieżącym miesiącu.
- Raporty zaangażowania: dostarczają informacji o tym, jak użytkownicy korzystają z Twoich aplikacji z mapami.
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 w artykule Stan odpowiedzi i raporty.
Raporty dotyczące wykorzystania, limitu i płatności Google Maps Platform możesz wyświetlać w konsoli Cloud.
Raporty o wykorzystaniu
Wykorzystanie jest określane na podstawie liczby żądań, które Twój projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z Twoim projektem. Żądania obejmują żądania zakończone powodzeniem, żądaniami wywołującymi błędy serwera oraz żądaniami skutkującymi błędami klienta. Dane uwierzytelniające obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów Premium i przeniesionych projektów abonamentu Premium). Więcej informacji znajdziesz w opisie abonamentów Premium oraz o korzystaniu z identyfikatora klienta.
Wskaźniki wykorzystania są wyświetlane w tabelach (Żądania, Błędy i Czas oczekiwania) oraz na wykresach (Ruch, Błędy i Czas oczekiwania). Do celów śledzenia:
Wszystkie interfejsy API: możesz filtrować i grupować dane o wykorzystaniu wszystkich interfejsów API w ten sposób:
- Filtruj według przedziału czasu i interfejsu API.
- Wyświetl ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
Konkretny interfejs API: możesz filtrować i grupować dane o wykorzystaniu przez określony interfejs API, korzystając z tych sposobów:
- Filtruj według przedziału czasu, wersji interfejsu API, danych logowania i metod.
- Wyświetl ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.
Strona panelu interfejsów API i usług
Panel interfejsów API i usług zawiera przegląd wskaźników wykorzystania wszystkich interfejsów API włączonych w projekcie: interfejsów API Google Maps Platform oraz innych interfejsów API i usług.
Na stronie Panel znajdują się 3 wykresy i tabela. Możesz filtrować wykorzystanie widoczne na wykresach i w tabelach, wybierając przedział czasu od 1 godziny do ostatnich 30 dni.
Wykres Ruch przedstawia wykorzystanie w zapytaniach na sekundę (QPS) na interfejs API.
Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy w poszczególnych interfejsach API.
Wykres Czas oczekiwania pokazuje medianę czasu oczekiwania dla żądań na interfejs API.
Pod wykresami znajduje się tabela z listą włączonych interfejsów API i usług. Żądania to liczba żądań (z wybranego okresu). Błędy to liczba żądań, które spowodowały błędy. Czas oczekiwania (średni czas oczekiwania i centyl) to czas oczekiwania dla tych żądań.
Aby uzyskać dostęp do strony panelu interfejsów API i usług:
- Otwórz stronę selektora projektów w konsoli Cloud:
- Wybierz projekt. Pojawi się strona panelu interfejsów API i usług.
Jeśli strona się nie wyświetli, kliknij przycisk menu
, a następnie Interfejsy API i usługi.
Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsu API.
Strona Przegląd w Mapach Google
Strona Przegląd w Mapach Google zawiera tabelę z aktywnymi interfejsami API i żądaniami wykorzystania z ostatnich 30 dni. Żądania według interfejsu API są też przedstawione w postaci wykresu. Wykres rozliczeniowy pokazuje bieżący rachunek i całkowite wykorzystanie w ciągu ostatnich 3 miesięcy.
Aby uzyskać dostęp do strony Przegląd w Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- 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 zawiera liczbę żądań, liczbę błędów oraz średni czas oczekiwania dla każdego włączonego interfejsu API w ciągu ostatnich 30 dni. Tabela Dodatkowe interfejsy API zawiera listę interfejsów API, które nie zostały włączone.
Aby uzyskać dostęp do strony interfejsów API Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- Z menu po lewej stronie wybierz Interfejsy API.
Strona Wskaźniki Map Google
Na stronie Dane w Mapach Google wyświetlane są 3 wykresy: Ruch, Błędy i Mediana czasu oczekiwania. Dane o korzystaniu 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, która przedstawia żądania, błędy i czas oczekiwania dla wybranych interfejsów API.
Korzystając z menu interfejsu API u góry oraz opcji grupowania i filtrowania w panelu po prawej stronie, 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 1 godziny do 30 dni) oraz szczegółowość wyświetlanych danych o wykorzystaniu (na sekundę lub dzień).
Na tych obrazach widać filtry Platforma i Domena dla pojedynczego interfejsu API, gdy na liście Pogrupowane według wybrano grupowanie według wymiaru Platforma i Domena:
Aby uzyskać dostęp do strony z danymi interfejsu Google Maps Platform API:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Dane.
Raportowanie danych logowania
Wskaźniki można filtrować i grupować według danych logowania użytych do wczytania interfejsu API.
| Format danych logowania | Znaczenie |
|---|---|
| Nazwa klucza Na przykład „Klucz aplikacji mobilnej” |
Do wczytania interfejsu API użyto klucza interfejsu API za pomocą ?key=...: nazwy kluczy znajdziesz w konsoli Maps Platform w sekcji Klucze i dane logowania. |
| Numer projektu Na przykład „project_number:123456”, gdzie 123456 to numer projektu. |
Dane logowania mogą być wyświetlane na 2 sposoby:
|
Wykresy kodu odpowiedzi
Wykresy Ruch według kodu odpowiedzi i Błąd według kodu odpowiedzi dzielą wykorzystanie według klasy kodu odpowiedzi HTTP. Ta tabela przedstawia mapowanie między stanem odpowiedzi interfejsu Google Maps Platform API a klasą kodu odpowiedzi HTTP:
| Stan interfejsu API Map Google | Klasa kodu odpowiedzi HTTP – raport o wykorzystaniu (2xx, 3xx, 4xx, 5xx) |
Notatki |
|---|---|---|
| OK | 2xx | Odpowiedź pomyślna. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. |
| OK | 3xx | Odpowiedź pomyślna. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. Na przykład udane żądania zdjęcia miejsca zwracają przekierowanie 302 do wskazanego obrazu. |
| DATA_NOT_AVAILABLE | 4xx(1) | Pomyślna odpowiedź wskazująca, że nie ma dostępnych danych dotyczących podanych lokalizacji. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. |
| ZERO_RESULTS | 4xx(1) | Pomyślna odpowiedź nie zwróciła żadnych wyników. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. |
| NOT_FOUND | 4xx(1) | W przypadku interfejsu Directions API ten komunikat oznacza, że co najmniej jednej lokalizacji określonej w punkcie początkowym, docelowym lub punkcie pośrednim w żądaniu nie udało się przetworzyć geokodu. W przypadku interfejsu Places API komunikat wskazuje, że wskazanej lokalizacji (identyfikator miejsca) nie znaleziono w bazie danych Miejsc. Jest to żądanie podlegające rozliczeniu i wyczerpuje 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. Więcej informacji znajdziesz w odpowiedzi interfejsu API. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. |
| REQUEST_DENIED | 4xx | Błąd klienta spowodowany m.in. błędem uwierzytelniania czy dostępem. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
| OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded |
4xx | Błąd klienta spowodowany zbyt dużą liczbą żądań w dozwolonym okresie. Spróbuj ponownie później. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
| FAILED_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) | 4xx | Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
| NOT_FOUND (404) (Nie znaleziono) | 4xx | W przypadku Geolocation API ten komunikat informuje, że dane wejściowe nie były wystarczające do utworzenia oszacowania lokalizacji. W przypadku interfejsu Roads API ten komunikat oznacza, że nie udało się prawidłowo przyciągnąć danych do dróg. Jest to żądanie podlegające rozliczeniu i wyczerpuje limit. |
| UNKNOWN_ERROR | 5xx | Błąd serwera wskazujący, że żądanie nie może zostać wykonane: błąd wewnętrzny, przeciążenie usługi, brak dostępności, przekroczenie limitu czasu itp. |
1
Aby poprawić spójność raportowania kodu 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 na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
{3) dla interfejsu API, {1) do stanu dailyLimitExceeded,
{13/Map, {13/Map}.
2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR
W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź, że wzrost wartości 4xx lub 5xx jest związany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer dokładny kod odpowiedzi (więcej informacji o korzystaniu z Google Cloud Monitoring w 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. w odpowiedziach na geokodowanie lub odpowiedzi na wskazówki dojazdu).
Parametr rozwiązań Google Maps Platform
Google Maps Platform udostępnia wiele typów przykładowego kodu, który ułatwia szybkie rozpoczęcie pracy. Możesz na przykład użyć Szybkiego konstruktora w Cloud Console, skorzystać z przewodników po implementacji rozwiązań branżowych i wyciągnąć wnioski z ćwiczeń z programowania.
Aby poznać wykorzystanie naszych rozwiązań i sposoby ich ulepszania, Google umieszcza parametr zapytania solution_channel w wywołaniach interfejsu API i zbiera informacje o wykorzystaniu przykładowego kodu:
- Parametr zapytania
solution_channeljest domyślnie zawarty w przykładowym kodzie rozwiązania. - Parametr zapytania zwraca dane analityczne dotyczące przyjęcia rozwiązania do Google, aby poprawić jego jakość w kolejnych wersjach.
- Możesz zrezygnować, usuwając parametr zapytania
solution_channeli jego wartość z przykładowego kodu. - Nie ma wymogu zachowania parametru. Usunięcie parametru zapytania nie wpływa na wydajność.
- Parametr zapytania jest używany tylko do raportowania użycia przykładowego kodu.
- Parametr zapytania różni się od wszelkich statystyk i raportów związanych z interfejsem API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie wyłącza wewnętrznego raportowania interfejsu Maps JavaScript API.
Raporty dotyczące limitów
Limity liczby żądań, które Twój projekt może wysłać do interfejsów API Google Maps Platform. Żądania można ograniczać na 3 sposoby: dziennie, na minutę i na użytkownika na minutę. Do limitu wliczają się tylko udane żądania i żądania, które powodują błędy serwera. Żądania, które nie przejdą uwierzytelniania, nie wliczają się do limitu.
Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w konsoli Cloud. Można je grupować w żądaniach na minutę. Aktualne limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
Aby obliczyć wartość limitu na minutę dla dowolnej usługi GMP API, użyj tego kalkulatora.
Strona Limity w Mapach Google
Na stronie Limity w Mapach Google możesz zobaczyć limity oraz zużycie limitów dla wybranego interfejsu API.
Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch generowany przez klucze interfejsu API i identyfikatory klientów. Ruch związany z identyfikatorem klienta jest też widoczny na wykresie wskaźników w konsoli Cloud.
Strona zawiera tylko żądania, które zużywają limit: żądania udane (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) i żądania powodujące błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru), UNKNOWN_ERROR).
Żądania, które powodują błędy klienta – błędy uwierzytelniania, autoryzacji i nieprawidłowych argumentów (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (nieprawidłowy parametr, błąd analizy żądania)) nie zajmują limitu i nie są wyświetlane.
Jednostka limitu jest żądaniem dotyczącym większości interfejsów API Google Maps Platform (Map Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API oraz Elevation API), ale istnieją pewne wyjątki:
- W przypadku interfejsu Range Matrix API jednostka limitu to element, który jest parą miejsca wylotu i miejsca docelowego.
- W przypadku interfejsu Maps JavaScript API jednostką limitu jest wczytanie mapy.
- W przypadku pakietu Maps SDK na Androida i pakietu SDK Map Google na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Wczytania mapy są dostępne bez opłat i nie zajmują limitu.
Aby uzyskać dostęp do strony Limity w Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Limity.
- Wybierz interfejs API z listy.
Liczba jednostek przydziału
Ta tabela przedstawia jednostkę limitu dla interfejsów API Google Maps Platform.
| Interfejs API Google Maps Platform | Jednostka limitu |
|---|---|
| Maps | |
| Maps SDK na Androida | 1 panorama |
| Maps SDK na iOS | 1 panorama |
| Interfejs API Map Tiles | 1 prośba |
| Interfejs API Map Google z lotu ptaka | 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 | |
| Routes API (Compute Routes) | 1 prośba |
| Routes API (Compute Route Matrix) | 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 |
| Miejsca | |
| Places API | 1 prośba |
| Address Validation API | 1 prośba |
| Geocoding API | 1 prośba |
| Geolocation API | 1 prośba |
| Time Zone API | 1 prośba |
| Środowisko | |
| Air Quality API (CurrentConditions i HeatmapTile) | 1 prośba |
| Air Quality API (historia) | 1 strona |
| Pollen API | 1 prośba |
| Solar API | 1 prośba |
Raporty rozliczeniowe
Wyświetlanie raportu rozliczeniowego
Raporty rozliczeniowe za korzystanie z usług Google Maps Platform są dostępne w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Płatności.
Aby uzyskać dostęp do raportów rozliczeniowych:
- Otwórz stronę selektora projektów w konsoli Cloud:
- Wybierz projekt.
- Kliknij kolejno przycisk menu i Płatności.
- Jeśli masz kilka kont rozliczeniowych, wybierz Otwórz połączone konto rozliczeniowe, aby otworzyć stronę Przegląd połączonego konta rozliczeniowego.
- W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty płatności dla połączonego konta rozliczeniowego.
Jak odczytywać wykres w raporcie płatności
Raporty rozliczeniowe przedstawiają koszt na przestrzeni czasu w postaci skumulowanego wykresu liniowego. W widoku domyślnym wyświetlane są dzienne koszty wykorzystania w bieżącym miesiącu zgrupowane według projektu (w przypadku wszystkich usług), wraz ze wszystkimi zastosowanymi środkami za wykorzystanie, a także całkowity prognozowany koszt w całym bieżącym miesiącu. Każda linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi, od największej do najmniejszej wartości według kosztu. Więcej informacji o interpretowaniu wykresu raportu rozliczeniowego
Wskazówka: przeanalizuj wykorzystanie i koszt kodu SKU
Aby lepiej poznać szczegóły modelu płatności według wykorzystania i jego wpływ na Twoją implementację, przeanalizuj wykorzystanie i koszt według kodu SKU.
Aby zmienić widok raportu tak, aby elementy zamówienia były wyświetlane według kodu SKU:
- W panelu po prawej stronie wykresu rozwiń filtr Grupuj według.
- Wybierz SKU.
Inne dostępne filtry raportów rozliczeniowych to Zakres czasu, Projekty, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według źródła żądań do interfejsu API.
Aby oprócz usługi sklasyfikować źródło wykorzystania, pogrupuj raporty rozliczeniowe według jednej z wymienionych wartości. Trzy klucze powiązane z interfejsami API Google Maps Platform to goog-maps-api-key-suffix (ostatnie 4 znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) oraz goog-maps-channel (ustawiona wartość liczbowa kanału za pomocą zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu
Widok wykresu możesz zmienić, aby wykluczać środki za wykorzystanie, odznaczając pole wyboru Uwzględnij środki w koszcie w panelu po prawej stronie.
Monitorowanie i ograniczanie konsumpcji
Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz wykonać następujące czynności:
- Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków względem określonej kwoty. Ustawienie budżetu nie ogranicza możliwości korzystania z interfejsu API. Alerty są wysyłane tylko wtedy, gdy wydatki zbliżą się do ustalonej kwoty.
Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami używania interfejsów API podlegających rozliczeniu. 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ć. Na przykład: (miesięczne wydatki /cena na każdy kod SKU)/30 = limit dzienny liczby żądań (w przypadku 1 interfejsu API).
Śledzenie wykorzystania w poszczególnych kanałach
Aby śledzić wykorzystanie za pomocą kanałów numerycznych, musisz dodać parametr „channel” do żądań do interfejsu API. Jedyne dopuszczalne wartości kanałów to liczby z zakresu 0-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>
Monitoruj wykorzystanie kanału bezpośrednio w raporcie rozliczeniowym. W sekcji Etykiety kanały będą widoczne jako klucz goog-maps-channel.
Filtrowanie raportu rozliczeniowego według kodu SKU i kanału
- Użyj filtra Pogrupuj według kodu SKU.
- Kliknij kursor Etykiety.
- Kliknij menu Key (Klucz) i wybierz goog-maps-channel.
- Kliknij menu Wartość i wybierz kanały numeryczne, które chcesz filtrować.
Pogrupuj według klucza etykiety goog-maps-channel, aby zobaczyć koszty wygenerowane przez każdy kanał.
Po zaimplementowaniu danych o wykorzystaniu kanału w swoich żądaniach może minąć do 24 godzin, zanim pojawią się one w raporcie rozliczeniowym.
Eksportowanie danych rozliczeniowych za pomocą BigQuery
Możesz też wyeksportować dane rozliczeniowe do BigQuery.
BigQuery Export umożliwia automatyczne eksportowanie w ciągu dnia szczegółowych danych z Rozliczeń usługi Google Cloud (np. danych o wykorzystaniu i szacowanych kosztach) do wskazanego przez Ciebie zbioru danych BigQuery. Umożliwi Ci to dostęp do danych rozliczeniowych z BigQuery w celu przeprowadzenia szczegółowej analizy. Daje to dodatkowy poziom szczegółowości informacji o źródle korzystania z Google Maps Platform.
Jeśli chcesz zacząć korzystać z eksportów BigQuery i wykonywania na nich zapytań, możesz wypróbować poniższe przykładowe zapytanie. Przed uruchomieniem tego zapytania musisz:
- Włącz płatności i eksport rozliczeń BigQuery na swoim koncie.
- 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 jest odwołaniem do identyfikatora konta rozliczeniowego z prefiksem „gcp_billing_exportv1” oraz 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
Przydatne materiały
Rozliczenia usługi Google Cloud:
- Tworzenie, modyfikowanie i zamykanie konta rozliczeniowego Cloud
- Zmień ustawienia płatności projektu
- Wyświetlanie raportów dotyczących rozliczeń i trendów kosztów
- Ustawiaj budżety i alerty dotyczące budżetu
- Ograniczenie wykorzystania interfejsu API
- Płatności za Google Maps Platform
- Przewodnik po optymalizacji
- Kluczowe sprawdzone metody dotyczące klucza interfejsu API
Stan odpowiedzi i raporty
Tabela poniżej przedstawia mapowanie między stanem interfejsu API Map Google, kodem odpowiedzi HTTP zwracanym w odpowiedziach interfejsu API Map Google i klasą kodu odpowiedzi HTTP w raporcie o wykorzystaniu oraz wskazuje, czy odpowiednie żądanie pojawia się w raportach dotyczących wykorzystania, limitu i rozliczeń.
Raport o korzystaniu w sekcji Dane Google Maps Platform zapewnia HTTP response code class stopień szczegółowości. Jeśli potrzebujesz wyższego poziomu szczegółowości, zapoznaj się z sekcją Kody stanu odpowiedzi dostępne w sekcji Monitorowanie wykorzystania Google Maps Platform.
| Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google | Dostępne w raporcie o wykorzystaniu | Zgłoszone 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 |
| Nieprawidłowe_REQUEST (nieprawidłowy/brakujący parametr, błąd analizy żądania) | 200, 400 |
4xx | Tak | Nie | Nie |
| REQUEST_DENIED | 200, 400, 403 |
4xx1 | Tak | Nie | Nie |
| OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded |
200, 403, 429 |
4xx1 | Tak | Nie | Nie |
| UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | Tak | Tak | Nie |
1
Aby poprawić spójność raportowania kodu 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 na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
{3) dla interfejsu API, {1) do stanu dailyLimitExceeded,
{13/Map, {13/Map}.
2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR
W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź, że wzrost wartości 4xx lub 5xx jest związany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer dokładny kod odpowiedzi (więcej informacji o korzystaniu z Google Cloud Monitoring w Google Maps Platform).
|
|||||
Raporty z sekcji Zaangażowanie
Statystyki firmy
Google Maps Platform daje wgląd w to, jak użytkownicy korzystają z Twoich map. Obejmują one kluczowe wskaźniki zaangażowania, takie jak wyświetlenia mapy lub interakcje z ważnym miejscem. Na podstawie tych statystyk możesz odkrywać popularne lokalizacje do celów reklamowych i marketingowych lub optymalizować wrażenia użytkowników.
Funkcje raportowania w statystykach biznesowych:
- wyświetlać ogólne podsumowanie statystyk biznesowych, aby szybko poznać najważniejsze trendy;
- Analizowanie konkretnych danych w konsoli w celu dogłębnej analizy konkretnych danych.
- Eksportowanie danych do pliku CSV, co umożliwia analizowanie danych ze statystyk biznesowych w ulubionym narzędziu do analizy biznesowej.
Dostępne wskaźniki zaangażowania:
- Widoki mapy:śledź wyświetlenia mapy wynikające z przesunięcia, powiększenia lub przechylenia. Liczba wyświetleń mapy jest obliczana 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.
Użytkownicy mogą wyświetlać statystyki biznesowe na stronie Wskaźniki w Cloud Console. Projekt musi mieć włączony interfejs Maps JavaScript API.
Dzięki funkcjom filtrowania i grupowania według możesz analizować dane o zaangażowaniu bezpośrednio w konsoli. Możesz na przykład wybrać filtrowanie według konkretnego regionu, aby poznać trendy wyświetleń mapy tylko dla kodów pocztowych w tym regionie. Z drugiej strony możesz pogrupować dane według konkretnego regionu, aby zebrać interakcje w tym regionie.
Użytkownicy mogą wyeksportować do pliku CSV cały zbiór danych lub filtrowany widok, aby dokładniej przeanalizować dane w Twoim ulubionym narzędziu do analizy biznesowej. Jednorazowo możesz pobrać dane z maksymalnie 90 dni, a dane powyżej 60 tys. komórek zostaną obcięte. Eksportowanie danych o wyświetleniach mapy do pliku CSV może potrwać kilka minut w zależności od wybranego zakresu czasu.
Dane w Statystykach firmy są anonimizowane, więc odzwierciedlają tylko ogólne trendy dotyczące zainteresowania użytkowników Twoimi mapami. Niska wartość może zostać zaokrąglona do zera, a udział w wynikach odstających od normy może zostać zmniejszony.
Dostęp do statystyk biznesowych dotyczących projektu Cloud możesz kontrolować w konsoli Google Cloud 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.
Nie należy używać statystyk biznesowych do szacowania kosztów wykorzystania. Więcej informacji o korzystaniu znajdziesz w raportach o użyciu.
Lokalizator Plus
W przypadku Lokalizatora Plus panel ze statystykami ułatwia analizowanie danych i generowanie statystyk na ich podstawie, dzięki czemu widać, jak skutecznie kupujący korzystają z lokalizatora sklepów. Możesz mierzyć skuteczność w ujęciu tygodniowym, w tym liczbę wyświetleń, liczbę interakcji z wyszukiwarką i informacjami o miejscu oraz ogólny współczynnik zaangażowania. Panel zawiera też ważne porównania Twojej implementacji z innymi sprzedawcami.
- Otwórz Locator Plus w konsoli Google Cloud.
- Otwórz sekcję Raporty zaangażowania w konsoli Google Cloud, aby wyświetlić panel statystyk.
Raport analizy porównawczej umożliwia porównanie Twoich danych ze zbiorczymi danymi branżowymi innych firm, które udostępniły te informacje. Porównanie zapewnia cenny kontekst, pomaga w wyznaczaniu realistycznych celów, zapewnia wgląd w trendy branżowe oraz pozwala określić swoją skuteczność na tle konkurencji.
Aby mieć widoczne dane z analizy porównawczej, Twoje dane o zaangażowaniu są uwzględniane anonimowo w analizach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania danych o zaangażowaniu w raportach z analizy porównawczej i ich uwzględniania, prześlij zgłoszenie do zespołu pomocy. Zgłoszenia do zespołu pomocy są zwykle rozpatrywane w ciągu 3 dni.