Raportowanie w Google Maps Platform obejmuje zestaw wstępnie zdefiniowanych wizualnych raportów dotyczących podstawowego wykorzystania interfejsu API, limitów i informacji rozliczeniowych w konsoli Google Cloud. Raporty te mogą 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 interfejsu API w czasie.
Typy raportów:
- Raporty o wykorzystaniu: zawierają liczbę żą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.
- 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 na cały bieżący miesiąc.
- 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 w Google Maps Platform możesz wyświetlać w konsoli Google 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, które spowodowały błędy serwera, i żądaniami prowadzącymi do błędów klienta. Dane uwierzytelniające obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów Premium i przeniesionych projektów w ramach abonamentu Premium). Więcej informacji znajdziesz w artykule Omówienie abonamentu Premium oraz informacjami 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 śledzenia:
Wszystkie interfejsy API: możesz filtrować i grupować dane o wykorzystaniu wszystkich interfejsów API w jeden z tych sposobów:
- 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 korzystaniu z określonego interfejsu API. Aby to zrobić:
- Filtruj według przedziału czasu, wersji interfejsu API, danych logowania i metod.
- Wyświetlanie ruchu, błędów i czasu oczekiwania, pogrupowane według kodu odpowiedzi, metody interfejsu API, wersji i 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. Dane o korzystaniu wyświetlane na wykresach i w tabelach możesz filtrować, wybierając przedział czasu od 1 godziny do ostatnich 30 dni.
Wykres Ruch pokazuje wykorzystanie w zapytaniach na sekundę (QPS) na interfejs API.
Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy w przypadku poszczególnych interfejsów 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 na te żądania.
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 listą włączonych interfejsów API i próśb o użycie z ostatnich 30 dni. Żądania według interfejsu API są też przedstawione w postaci wykresu. Wykres płatności przedstawia bieżący rachunek i całkowite wykorzystanie z 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 interfejsów 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:
- W menu po lewej stronie wybierz Interfejsy API.
Strona Dane w Mapach Google
Na stronie Dane w Mapach Google pojawią się 3 wykresy: Ruch, Błędy i Mediana Opóźnienia. Dane o korzystaniu na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody API, danych logowania, platformy i domeny.
Pod wykresami strona Wskaźniki zawiera tabelę interfejsów API, która pokazuje żądania, błędy i czas oczekiwania dla wybranych interfejsów API.
Za pomocą menu API u góry oraz opcji grupowania i filtrowania w prawym panelu możesz grupować i filtrować wyświetlane wskaźniki wykorzystania, wybierając określone lub wiele interfejsów API, danych logowania, klas kodu odpowiedzi, typu platformy lub domeny. Możesz też wybrać przedział czasu (od godziny do ostatnich 30 dni) i szczegółowość wyświetlanych danych o wykorzystaniu (na sekundę lub dzień).
Na tych obrazach widać filtry Platformy i Domena dla pojedynczego interfejsu API, gdy na liście Pogrupowane według zaznaczone są filtry Platforma i Domena:
Aby uzyskać dostęp do strony ze wskaźnikami w interfejsie Google Maps Platform API:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Dane.
Raporty 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 „Mobile App Key” |
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 Twojego projektu. |
Te dane logowania mogą się wyświetlać na 2 sposoby:
|
Wykresy kodów 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) |
Uwagi |
---|---|---|
OK | 2xx | Odpowiedź pomyślna. Jest to żądanie podlegające rozliczeniu i będzie zajmować limit. |
OK | 3xx | Odpowiedź pomyślna. Jest to żądanie podlegające rozliczeniu i będzie zajmować limit. Na przykład udane żądania zdjęcia miejsca zwracają przekierowanie 302 do wskazanego obrazu. |
DATA_NOT_AVAILABLE | 4xx(1) | Odpowiedź wskazująca, że brakuje dostępnych danych dla podanych lokalizacji. Jest to żądanie podlegające rozliczeniu i będzie zajmować limit. |
ZERO_RESULTS | 4xx(1) | Pomyślna odpowiedź nie zwróciła żadnych wyników. Jest to żądanie podlegające rozliczeniu i będzie zajmować limit. |
NOT_FOUND | 4xx(1) | W przypadku interfejsu Directions API ten komunikat oznacza, że co najmniej jednej z lokalizacji określonych w punkcie początkowym, docelowym lub punkcie pośrednim żądania nie udało się przetworzyć geokodu. W przypadku interfejsu Places API ten komunikat oznacza, że wskazanej lokalizacji (identyfikator miejsca) nie udało się znaleźć w bazie danych Miejsc. Jest to żądanie podlegające rozliczeniu i będzie zajmować limit. |
FAILED_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 będzie zajmować limit. |
REQUEST_DENIED | 4xx | Błąd klienta spowodowany m.in. m.in. błędem uwierzytelniania i błędem dostępu. 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 przez nieprawidłowe żądanie. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
NOT_FOUND (404) (Nie znaleziono) | 4xx | W przypadku interfejsu Geolocation API ten komunikat oznacza, że dane wejściowe nie są wystarczające do utworzenia oszacowania lokalizacji. W przypadku interfejsu Roads API ten komunikat oznacza, że nie udało się w rozsądny sposób przypisać danych wejściowych do dróg. Jest to żądanie podlegające rozliczeniu i będzie zużywać limit. |
UNKNOWN_ERROR | 5xx | Błąd serwera wskazujący, że nie można zrealizować żądania: błąd wewnętrzny, przeciążenie usługi, brak dostępności, 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 na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded do 4xx ,
{1.
stan API/Map: {1.} z kodu HTTP/Map, {1.
do kodu HTTP/Map, {1.3/} z klasy kodu odpowiedzi HTTP 2xx na 4xx .rateLimitExceeded userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie.
Potwierdź, że wzrost liczby 4xx lub 5xx wskaźników Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (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 wybranego interfejsu API (np. w dokumencie Geocoding Responses lub Directions Responses).
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 nauczyć się czegoś podczas ćwiczeń z programowania.
Aby poznać wykorzystanie i sposoby ulepszania naszych rozwiązań, Google umieszcza w wywołaniach interfejsu API parametr zapytania solution_channel
w celu zbierania informacji o wykorzystaniu przykładowego kodu:
- Parametr zapytania
solution_channel
jest domyślnie uwzględniany w przykładowym kodzie rozwiązania. - Parametr zapytania zwraca statystyki dotyczące przyjęcia rozwiązania do Google, aby poprawić jakość rozwiązania w kolejnych iteracjach.
- Możesz zrezygnować, 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 jest używany tylko do raportowania wykorzystania kodu.
- Parametr zapytania różni się od 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ętrznych raportów 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 Cloud Console. Można je grupować w żądaniach na minutę. Aktualne limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania.
Aby obliczyć wartość limitu na minutę dla dowolnej usługi GMP API, skorzystaj z tego kalkulatora.
Strona Limity w Mapach Google
Na stronie Limity w Mapach Google znajdziesz informacje o limitach dla wybranego interfejsu API.
Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch generowany przez Twoje 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 pokazuje tylko żądania zużywające 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 – uwierzytelnianie, autoryzację i błędy nieprawidłowego argumentu (REQUEST_DENIED
, OVER_QUERY_LIMIT
, INVALID_REQUEST
(nieprawidłowy parametr, błąd analizy żądania)) – nie zużywają limitu i nie są wyświetlane.
Jednostka limitu 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 są pewne wyjątki:
- W przypadku interfejsu Distance Matrix API jednostka limitu to element, który jest parą miejsca wylotu i miejsca docelowego.
- W przypadku interfejsu Maps JavaScript API jednostka limitu to wczytanie mapy.
- W przypadku pakietów SDK Maps na Androida i Maps SDK na iOS jednostką przydziału jest żądanie Street View lub wczytanie panoramy. Wczytania mapy są dostępne bez opłat i nie zajmują Twojego limitu.
Aby uzyskać dostęp do strony z limitami 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 zawiera jednostkę limitu 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 |
Interfejs API Map Tiles | 1 prośba |
Interfejs Maps Aerial View API | 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 Google Cloud Console. Więcej informacji znajdziesz w artykule Rozliczenia.
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 Przejdź do połączonego konta, aby otworzyć stronę Przegląd połączonego konta rozliczeniowego.
- W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty rozliczeniowe dotyczące połączonego konta rozliczeniowego.
Jak odczytywać wykres raportu rozliczeniowego
Raporty rozliczeniowe przedstawiają koszt na przestrzeni czasu w postaci skumulowanego wykresu liniowego. W widoku domyślnym wyświetlane są dzienne koszty użytkowania w bieżącym miesiącu pogrupowane według projektów (w przypadku wszystkich usług), obejmujące wszelkie zastosowane środki związane z wykorzystaniem, a także całkowity prognozowany koszt na cały bieżący miesiąc. Każda linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi (od największej do najmniejszej wartości kosztu). Więcej informacji o interpretowaniu wykresu w raporcie rozliczeniowym
Wskazówka: przeanalizuj wykorzystanie i koszt SKU
Aby lepiej poznać szczegóły modelu cenowego płatności według wykorzystania i jego wpływ na implementację, zapoznaj się z wykorzystaniem i kosztem wykorzystania według kodów SKU.
Aby zmienić widok raportu tak, by wyświetlały się elementy zamówienia 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 Przedział czasu, Projekty, Produkty, Kody SKU i Lokalizacje. Umożliwiają one filtrowanie według skąd są przesyłane żądania 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 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) i goog-maps-channel (ustawiony numeryczny kanał z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu
Widok wykresu możesz zmienić, aby wykluczyć środki za wykorzystanie, odznaczając pole wyboru Uwzględnij środki w kosztach w prawym panelu.
Monitorowanie i ograniczanie wykorzystania
Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz wykonać te czynności:
- Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków względem określonej kwoty. Ustawienie budżetu nie ogranicza korzystania z interfejsu API. Informuje tylko o tym, że wydatki zbliżają się do ustalonej kwoty.
Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami używania płatnych interfejsów API. Ustawiając limity dziennej liczby żądań, możesz ograniczyć wydatki. Za pomocą prostego równania określ limit dzienny w zależności od tego, ile chcesz wydać. Na przykład: (miesięczne wydatki /cena na każdy kod SKU)/30 = liczba żądań dziennie (w przypadku 1 interfejsu API).
Śledzenie wykorzystania na kanał
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ą oznaczone jako klucz goog-maps-channel.
Filtrowanie raportu rozliczeniowego według kodu SKU i kanału
- Użyj filtra SKU Grupuj według.
- Kliknij kursor Etykiety.
- Kliknij menu Klucz i wybierz goog-maps-channel.
- Kliknij menu Wartość i wybierz kanały liczbowe, które chcesz filtrować.
Pogrupuj według klucza etykiety goog-maps-channel, by zobaczyć koszty wygenerowane przez każdy kanał.
Gdy zaimplementujesz w swoich żądaniach dane o wykorzystaniu kanałów, może minąć do 24 godzin, zanim pojawią się one w raporcie rozliczeniowym.
Eksportowanie danych rozliczeniowych do 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 w BigQuery w celu przeprowadzenia szczegółowej analizy. Zapewnia to dodatkową warstwę szczegółowości, która pozwala lepiej zrozumieć źródło korzystania z Google Maps Platform.
Jeśli chcesz zacząć korzystać z eksportów do BigQuery i wykonywania na nich zapytań dotyczących danych, możesz wypróbować poniższe przykładowe zapytanie. Przed uruchomieniem tego zapytania musisz:
- Włącz na swoim koncie płatności i eksport rozliczeń 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 identyfikator konta rozliczeniowego z prefiksem „gcp_billing_exportv1”, który umożliwia zmianę myślników (-) na podkreślenia (_).
Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmieniłby 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ń oraz trendów w zakresie kosztów
- Ustawiaj budżety i alerty dotyczące budżetu
- Ograniczanie wykorzystania interfejsu API
- Płatności za Google Maps Platform
- Przewodnik po optymalizacji
- Sprawdzone metody dotyczące kluczy interfejsu API
Stan odpowiedzi i raporty
Tabela poniżej pokazuje mapowanie między stanem interfejsu API Map Google, kodem odpowiedzi HTTP zwracanym w odpowiedziach interfejsu API Map Google a 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 danych Google Maps Platform zapewnia HTTP response code class
szczegół. Aby uzyskać wyższy poziom szczegółowości, zapoznaj się z kodami stanu odpowiedzi dostępnymi w monitorowaniu wykorzystania Google Maps Platform.
Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google | Dostępne w raporcie o wykorzystaniu | Zgłoszono do | |||
---|---|---|---|---|---|
Stan interfejsu API Map Google | Kod odpowiedzi HTTP | Klasa kodu odpowiedzi HTTP | Wykorzystanie | Limit | Płatności |
OK | 200, 204, 302 |
2xx, 3xx |
Tak | Tak | Tak |
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | Tak | Tak | Tak |
FAILED_REQUEST (nieprawidłowa wartość parametru), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED itd. |
200, 400 |
4xx | Tak | Tak | Tak |
FAILED_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 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 na 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded do 4xx ,
{1.
stan API/Map: {1.} z kodu HTTP/Map, {1.
do kodu HTTP/Map, {1.3/} z klasy kodu odpowiedzi HTTP 2xx na 4xx .rateLimitExceeded userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym będą widoczne oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie.
Potwierdź, że wzrost liczby 4xx lub 5xx wskaźników Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (więcej informacji o korzystaniu z Google Cloud Monitoring w Google Maps Platform).
|
Raporty z sekcji Zaangażowanie
Statystyki firmy
Google Maps Platform zapewnia wgląd w interakcje użytkowników z Twoimi mapami. Obejmują one kluczowe wskaźniki zaangażowania, takie jak wyświetlenia mapy lub interakcje z ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne lokalizacje do celów reklamowych i marketingowych lub optymalizować wrażenia użytkowników.
Funkcje raportowania statystyk biznesowych obejmują:
- wyświetlać ogólne podsumowanie statystyk biznesowych, aby szybko poznawać najważniejsze trendy w statystykach biznesowych;
- Analizowanie konkretnych danych w konsoli w celu bardziej szczegółowej analizy danych.
- Eksportowanie danych do pliku CSV, co umożliwia analizowanie danych ze statystyk biznesowych w ulubionym narzędziu do analizy biznesowej.
Dostępne dane o zaangażowaniu:
- Widoki mapy:śledź wyświetlenia mapy wynikające z przesunięcia, powiększenia lub przechylenia. 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 zakończeniu okresu obserwacji.
Użytkownicy mogą wyświetlać statystyki biznesowe na stronie Wskaźniki w Cloud Console. Widoki map są obecnie dostępne w celach testowych tylko dla niektórych programistów korzystających z interfejsu API Map Google w języku JavaScript.
Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli za pomocą funkcji filtrowania i grupowania według, aby bardziej szczegółowo przeanalizować dane. Możesz na przykład wybrać filtrowanie według konkretnego regionu, aby zobaczyć, jak zmieniają się trendy wyświetleń map tylko w przypadku kodów pocztowych w tym regionie. Z drugiej strony możesz wybrać grupowanie według konkretnego regionu, aby zebrać dane interakcji w tym regionie.
Użytkownicy mogą wyeksportować do pliku CSV cały zbiór danych lub filtrowany widok, aby przeprowadzić dalszą analizę 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 map 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 związane z korzystaniem z Twoich map. Niska liczba może być zaokrąglona do zera, a wpływ z wartości odstających może być 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 na temat użytkowania.
Lokalizator Plus
Użytkownicy lokalizatora Plus mogą korzystać z panelu analityki, który ułatwia analizowanie danych i generowanie statystyk na ich podstawie, dzięki czemu dokładnie 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 ten zapewnia również ważne dane porównawcze, które pozwalają porównać skuteczność Twojej implementacji z innymi sprzedawcami.
- Otwórz Locator Plus w konsoli Google Cloud.
- Otwórz sekcję Raporty zaangażowania w Google Cloud Console, aby wyświetlić panel statystyk.
Raport analizy porównawczej umożliwia porównywanie Twoich danych ze zbiorczymi danymi branżowymi innych firm, które udostępniły te dane. Porównanie zapewnia cenny kontekst, pomaga w określaniu istotnych celów, pozwala zorientować się w trendach w branży oraz sprawdzić, jak wypadamy na tle konkurencji.
Aby zobaczyć dane z analizy porównawczej, Twoje dane o zaangażowaniu są uwzględniane anonimowo w testach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania i uwzględniania danych o zaangażowaniu w raportach z analizy porównawczej, prześlij zgłoszenie do zespołu pomocy. Zgłoszenia do zespołu pomocy są zazwyczaj rozpatrywane w ciągu 3 dni.