Raportowanie w Google Maps Platform obejmuje zestaw wstępnie zdefiniowanych raportów wizualnych, dzięki którym możesz z łatwością poznać podstawowe informacje o wykorzystaniu interfejsu API, limitach oraz o płatnościach w Google Cloud Console. Możesz szybko określić liczbę wywołań interfejsu API oraz to, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, a także sprawdzać wykorzystanie płatności 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ę. Bieżące limity wykorzystania limitów 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 przyznane środki za wykorzystanie, 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 poniżej w sekcji Stan odpowiedzi i raporty.
Raporty dotyczące wykorzystania, limitów i płatności Google Maps Platform możesz wyświetlać w Cloud Console.
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, żądania skutkujące błędami serwera oraz te, które powodują błędy klienta. Dane uwierzytelniające obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów Premium i przeniesionych projektów z abonamentem Premium).
Dane o korzystaniu są wyświetlane w tabelach (Żądania, Błędy i Czas oczekiwania) oraz na wykresach (Ruch, Błędy i Czas oczekiwania). Na potrzeby śledzenia:
- Wskaźniki wykorzystania wszystkich interfejsów API można filtrować według przedziału czasu i interfejsu API. Możesz też przeglądać ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
- Wskaźniki wykorzystania określonego interfejsu API można filtrować według przedziału czasu oraz wersji, danych logowania i metod interfejsu API. Możesz też zobaczyć 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
Na stronie Panel interfejsów API i usług znajdziesz przegląd wskaźników wykorzystania wszystkich interfejsów API włączonych w projekcie (interfejsach API Google Maps Platform oraz innych interfejsów API i usług).
Na stronie panelu znajdują się 3 wykresy i tabela. Możesz filtrować wykorzystanie wyświetlane na wykresach i w tabelach, wybierając przedział czasu (od 1 godziny do ostatnich 30 dni).
Wykres natężenia ruchu przedstawia wykorzystanie w zapytaniach na sekundę (QPS) na interfejs API. Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy, w przypadku każdego interfejsu API. Wykres czasu oczekiwania pokazuje medianę czasu oczekiwania dla żądań do poszczególnych interfejsów 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 Cloud Console:
- Wybierz projekt. Pojawi się strona panelu interfejsów API i usług.
Jeśli strona się nie wyświetli, wybierz 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 żądań użycia z ostatnich 30 dni. Żądania według interfejsu API są też widoczne 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ądu Google Maps Platform:
- Otwórz stronę Google Maps Platform w Cloud Console:
- 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 przedstawia liczbę żądań, liczbę błędów i ś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 Cloud Console:
- W menu po lewej stronie wybierz Interfejsy API.
Strona danych Map Google
Na stronie Dane w Mapach Google znajdują się 3 wykresy: Ruch, Błędy i Mediana Opóźnienia. Dane na temat wykorzystania na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.
Pod wykresami strona Wskaźniki zawiera tabelę interfejsów API, która przedstawia żądania, błędy i czas oczekiwania dla wybranych interfejsów API.
Za pomocą menu API u góry i 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 godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych danych o korzystaniu.
Na poniższych obrazach widać filtry Platforma i Domena dla pojedynczego interfejsu API, gdy na liście Pogrupowane według wybrano opcję Platforma i Domena:
Aby uzyskać dostęp do strony wskaźników w interfejsie API Google Maps Platform:
- Otwórz stronę Google Maps Platform w Cloud Console:
- W menu po lewej stronie wybierz Dane.
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. W tabeli poniżej znajdziesz mapowanie stanu odpowiedzi interfejsu Google Maps Platform API na 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 płatne żądanie, które zużywa limit. |
OK | 3xx | Odpowiedź pomyślna. Jest to płatne żądanie, które zużywa limit. Na przykład udane żądania Place Photo, które zwracają przekierowanie 302 do wskazanego obrazu. |
DATA_NOT_AVAILABLE | 4xx(1) | Odpowiedź informująca o braku dostępnych danych dotyczących wprowadzonych lokalizacji. Jest to płatne żądanie, które zużywa limit. |
ZERO_RESULTS | 4xx(1) | Pomyślna odpowiedź nie zwróciła żadnych wyników. Jest to płatne żądanie, które zużywa limit. |
NOT_FOUND | 4xx(1) | W przypadku interfejsu Directions API oznacza to, że nie udało się przekodować co najmniej 1 lokalizacji podanej w miejscu wylotu, miejscu docelowym lub punktach pośrednich w żądaniu. W przypadku interfejsu Places API wskazuje to, że wskazana lokalizacja (identyfikator miejsca) nie została znaleziona w bazie danych Miejsc. Jest to płatne żądanie, które zużywa limit. |
INVALID_REQUEST (nieprawidłowa wartość parametru), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED itp. |
4xx | Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API. Jest to płatne żądanie, które zużywa limit. |
REQUEST_DENIED | 4xx | Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu itp. 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. Ponów prośbę później. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
INVALID_REQUEST (nieprawidłowy/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 dane wejściowe są niewystarczające do utworzenia oszacowania lokalizacji. W przypadku interfejsu Roads API wskazuje to, że nie udało się przyciągnąć danych wejściowych do dróg. Jest to płatne żądanie, które 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, przekroczenie limitu czasu itp. |
1
Aby poprawić spójność raportowania kodów błędów, przenosimy interfejsy API Google Maps Platform:
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 ,
rateLimitExceeded , dailyLimitExceeded ,
rateLimitExceeded .2xx userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym będziesz mieć widoczne oba kody odpowiedzi. Kody odpowiedzi zwrócone w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź, że wzrost wartości 4xx lub 5xx w danych Google Maps Platform jest powiązany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer, który dokładnie kod odpowiedzi się zwiększa (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).
|
Więcej informacji o kodach stanu i komunikatach o błędach znajdziesz w dokumentacji odpowiedzi konkretnego interfejsu API (np. 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 wdrożenie. Możesz na przykład użyć szybkiego konstruktora w Cloud Console, skorzystać z przewodników po implementacji rozwiązań branżowych i uczyć się z laboratoriów.
Aby lepiej poznać wykorzystanie i sposoby ulepszania naszych rozwiązań, Google umieszcza parametr zapytania solution_channel
w wywołaniach interfejsu API. W ten sposób zbieramy informacje o przykładowym wykorzystaniu kodu:
- Parametr zapytania
solution_channel
jest domyślnie zawarty 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łynie 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 spowoduje wyłączenia 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 Cloud Console. Można je grupować w żądaniach na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitu.
Użyj tego kalkulatora, aby obliczyć wartość limitu na minutę dla dowolnej usługi GMP API
Strona Limity w Mapach Google
Strona Limity w Mapach Google zawiera informacje o limitach i wykorzystaniu limitów 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 Cloud Console.
Na stronie wyświetlane są 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
(wartość nieprawidłowego parametru), UNKNOWN_ERROR
).
Żądania, które powodują błędy klienta (błędy uwierzytelniania/autoryzacji/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 to żądanie dotyczące 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 i Elevation API). Istnieją jednak 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 pakietu Maps SDK na Androida i Maps SDK na iOS jednostka przydziału to żądanie Street View lub wczytanie panoramy (wczytania mapy są dostępne bezpłatnie i nie wliczają się do limitu miejsca).
Aby uzyskać dostęp do strony Limity w Google Maps Platform:
- Otwórz stronę Google Maps Platform w Cloud Console:
- W menu po lewej stronie wybierz Limity.
- Wybierz interfejs API z listy.
Liczba jednostek przydziału
Tabela poniżej przedstawia 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 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 |
Interfejs API Pollen | 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 (zobacz Rozliczenia).
Aby uzyskać dostęp do raportów rozliczeniowych:
- Otwórz stronę selektora projektów w Cloud Console:
- 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.
- W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty rozliczeniowe dotyczące połączonego konta rozliczeniowego.
Jak czytać wykres w raporcie rozliczeniowym
Raporty rozliczeniowe przedstawiają koszt na przestrzeni czasu w postaci skumulowanego wykresu liniowego. Domyślny widok to wyświetlanie dziennych kosztów wykorzystania w bieżącym miesiącu, pogrupowanych według projektów (w przypadku wszystkich usług), w tym wszelkich zastosowanych środków do wykorzystania za wykorzystanie, a także łączny prognozowany koszt na cały bieżący miesiąc. Każdy wiersz na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi (od największej do najmniejszej wartości według kosztu). Dowiedz się więcej o interpretowaniu wykresu raportu rozliczeniowego

Wskazówka: przeanalizuj wykorzystanie i koszt kodu SKU
Aby lepiej zrozumieć szczegóły modelu płatności według wykorzystania i jego wpływ na Twoje wdrożenie, przeanalizuj wykorzystanie i koszt według kodu SKU.


Aby zmienić widok raportu tak, aby 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 Zakres czasowy, Projekty, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według tego, skąd są wysyłane żądania do interfejsu API.
Aby oprócz usługi sklasyfikować źródło użycia, 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 (ustawiona wartość liczbowa kanału pochodząca z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu
Widok wykresu możesz zmienić tak, aby nie uwzględniał środków za wykorzystanie, odznaczając pole wyboru Uwzględnij środki w kosztach w panelu po prawej stronie.
Monitorowanie i ograniczanie wykorzystania
Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz:
- Ustaw alert dotyczący budżetu, aby śledzić wzrost wydatków pod kątem określonej kwoty. Ustalenie budżetu nie ogranicza wykorzystania interfejsu API, a powiadomienie Cię tylko wtedy, gdy wydatki zbliżą się do określonej kwoty.
- Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Ustawiając limity żądań dziennie, możesz ograniczyć wydatki. Użyj prostego równania, aby określić dzienny limit 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). Pamiętaj, że implementacja może używać wielu płatnych interfejsów API, więc dostosuj równanie odpowiednio do potrzeb. Pamiętaj, że każdego miesiąca masz do dyspozycji środki w Google Maps Platform w wysokości 200 USD, więc uwzględnij tę kwotę w obliczeniach.
Ś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 płatności. W sekcji Etykiety kanały będą widoczne jako klucz goog-maps-channel.

Aby filtrować raport rozliczeniowy według kodu SKU i kanału
- Użyj filtra kodów SKU Grupuj według.
- Wybierz daszek Etykiety.
- Wybierz 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 umieścisz w swoich żądaniach dane o wykorzystaniu kanału, 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. Gdy to zrobisz, uzyskasz dostęp do danych rozliczeniowych z BigQuery, aby przeprowadzić szczegółową analizę. Daje to dodatkowy poziom szczegółowości informacji o źródle wykorzystania 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 na swoim koncie płatności i eksport płatności BigQuery.
- Format tabeli to PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, gdzie:
- PROJECT_ID to Twój rzeczywisty identyfikator projektu (np. „mój-projekt-123456”).
- DATASET_NAME to nazwa utworzonego przez Ciebie zbioru danych (np. „SampleDataSet”).
- BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego z prefiksem „gcp_billing_exportv1”, który jest złożony z myślników (-) i podkreślania (_).
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
- Modyfikowanie ustawień płatności w projekcie
- Wyświetlanie raportów dotyczących płatności oraz trendów w zakresie kosztów
- Ustawianie budżetów i alertów dotyczących budżetu
- Ograniczenie wykorzystania interfejsu API
- Rozliczenia za Google Maps Platform
- Przewodnik po optymalizacji
- 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 a klasą kodu odpowiedzi HTTP w raporcie o wykorzystaniu. Wskazuje, czy odpowiednie żądanie pojawia się w raportach dotyczących wykorzystania, przydziału i płatności.
Raport o wykorzystaniu w danych Google Maps Platform dostarcza HTTP response code class
szczegółowości. Jeśli potrzebujesz większej 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łoszono dla | |||
---|---|---|---|---|---|
Stan interfejsu API Map Google | Kod odpowiedzi HTTP | Klasa kodu odpowiedzi HTTP | Wykorzystanie | Limit | Rozliczenia |
OK | 200, 204, 302 |
2xx, 3xx |
Tak | Tak | Tak |
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200 | 4xx1 | Tak | Tak | Tak |
NOT_FOUND (Street View Static, Geolocation i Roads API), ZERO_RESULTS (Street View Static API) |
404 | 4xx | Tak | Tak | Tak |
INVALID_REQUEST (nieprawidłowa wartość parametru), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED itp. |
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 poprawić spójność raportowania kodów błędów, przenosimy interfejsy API Google Maps Platform:
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 ,
rateLimitExceeded , dailyLimitExceeded ,
rateLimitExceeded .2xx userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym będziesz mieć widoczne oba kody odpowiedzi. Kody odpowiedzi zwrócone w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź, że wzrost wartości 4xx lub 5xx w danych Google Maps Platform jest powiązany z tą migracją. W tym celu sprawdź w narzędziu Metrics Explorer, który dokładnie kod odpowiedzi się zwiększa (więcej informacji o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).
|
Raporty z sekcji Zaangażowanie
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 miejscem. Możesz analizować te dane, aby znaleźć popularne lokalizacje na potrzeby reklamy i marketingu lub zoptymalizować wrażenia użytkowników.
Funkcje raportowania w statystykach biznesowych:
- wyświetlać ogólne podsumowanie statystyk biznesowych, aby poznać najważniejsze trendy w statystykach biznesowych;
- Analizowanie konkretnych danych w konsoli w celu bardziej szczegółowej analizy danych w celu ich szczegółowego zrozumienia.
- 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. Liczba wyświetleń mapy jest obliczana według kodu pocztowego co tydzień (od niedzieli do soboty czasu pacyficznego). Nowe dane są udostępniane co tydzień w pierwszą środę po okresie 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 interfejsu API Map Google JS.
Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli za pomocą funkcji filtrowania i grupowania według, które pozwalają na bardziej szczegółową analizę danych. Możesz na przykład wybrać filtrowanie według konkretnego regionu, aby poznać trendy wyświetleń map tylko dla kodów pocztowych w tym regionie. Z drugiej strony możesz pogrupować dane według konkretnego regionu, by zebrać dane o interakcjach w jego obrębie.
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. Za jednym razem możesz pobrać dane z maksymalnie 90 dni, a dane powyżej 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 czasu.
Dane ze statystyk biznesowych są anonimowe, więc odzwierciedlają tylko ogólne trendy w korzystaniu z Twoich map. Niskie liczby mogą być zaokrąglone do zera, a udział z wartości odstających może być zmniejszony.
Dostęp do firmowych statystyk 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ą przyznać dostęp innym użytkownikom.
Statystyki biznesowe nie powinny być używane do szacowania kosztów użytkowania. Więcej informacji o korzystaniu z tej funkcji znajdziesz w raportach o wykorzystaniu.
Lokalizator Plus
Użytkownicy lokalizatora Plus mogą korzystać z panelu statystyk, aby analizować dane i generować statystyki na ich podstawie, dając jasne informacje o tym, jak dobrze kupujący korzystają z lokalizatora sklepów. Możesz mierzyć skuteczność w poszczególnych tygodniach, 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, dzięki którym sprawdzisz, jak Twoja implementacja wypada na tle innych sprzedawców.
- Otwórz Locator Plus w konsoli Google Cloud.
- Aby wyświetlić panel statystyk, otwórz sekcję Raporty zaangażowania w Google Cloud Console.
Raport analizy porównawczej umożliwia porównywanie Twoich danych ze zbiorczymi danymi branżowymi innych firm, które udostępniły te informacje. Porównanie zapewnia cenny kontekst, pomagając w wyznaczaniu realistycznych celów, zwracaniu uwagi na trendy branżowe oraz sprawdzaniu wyników firmy w porównaniu z konkurencją.
Aby mieć widoczne dane porównawcze, Twoje dane o zaangażowaniu są anonimowo uwzględniane w testach porównawczych Google. Aby zrezygnować z anonimowego wyświetlania danych o zaangażowaniu i uwzględniania ich 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.