Raportowanie w Google Maps Platform udostępnia zestaw wstępnie zdefiniowanych raportów wizualnych w konsoli Google Cloud, które przedstawiają podstawowe informacje o wykorzystaniu interfejsu API, limitach i informacjach rozliczeniowych. Korzystaj z tych raportów, aby określać liczbę wykonanych wywołań interfejsu API i osiągać limity wykorzystania interfejsu API oraz monitorować wykorzystanie płatności w czasie.
Typy raportów:
- Raporty wykorzystania: raportuje liczbę żądań wysyłanych przez Twój projekt do interfejsów Google Maps Platform API z użyciem danych logowania powiązanych z Twoim projektem.
- Raporty dotyczące limitów: przedstawiają wykorzystanie limitu w postaci wykresów, które można grupować według żądań na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
- Raporty rozliczeniowe: raporty o kosztach na przestrzeni czasu w postaci skumulowanego wykresu liniowego. Wyświetl wykorzystanie limitu w bieżącym miesiącu, włącznie ze wszystkimi zastosowanymi środkami związanymi z wykorzystaniem, a także łączny koszt prognozowany na cały bieżący miesiąc.
- Raporty zaangażowania: zawierają statystyki biznesowe dotyczące tego, jak użytkownicy korzystają z Twoich aplikacji z mapami.
Pełną listę stanów i kodów odpowiedzi określających, czy żądanie ma pojawiać się w raportach Wykorzystanie, Limit i Płatności, znajdziesz w artykule Stan i raporty odpowiedzi.
Raporty dotyczące wykorzystania, limitów i płatności w Google Maps Platform możesz wyświetlać w Cloud Console.
Raporty o wykorzystaniu
Wykorzystanie zależy od liczby żądań, które Twój projekt wysyła do interfejsów Google Maps Platform API za pomocą danych logowania powiązanych z Twoim projektem. Żądania obejmują żądania udane i błędy serwera oraz żądania powodujące błędy klienta. Dane logowania obejmują klucze interfejsu API i identyfikatory klienta (w przypadku projektów w abonamencie Premium i przeniesionych projektów Premium). Szczegółowe informacje znajdziesz w omówieniu abonamentu Premium i w informacjach 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: wskaźniki wykorzystania wszystkich interfejsów API możesz filtrować i grupować w następujący sposób:
- Filtruj według przedziału czasu i interfejsu API.
- Wyświetlaj ruch, błędy i czas oczekiwania według kodu odpowiedzi, interfejsu API i danych logowania.
Konkretny interfejs API – możesz filtrować i grupować wskaźniki wykorzystania przez konkretny interfejs API na te sposoby:
- Filtruj według okresu, wersji interfejsu API, danych logowania i metod.
- Wyświetlaj ruch, błędy i czas oczekiwania według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.
Strona panelu interfejsów API i usług
W panelu interfejsów API i usług znajdziesz przegląd danych dotyczących wykorzystania wszystkich interfejsów API włączonych w Twoim projekcie: interfejsów Google Maps Platform API oraz innych interfejsów API i usług.
Na stronie Panel znajdują się 3 wykresy i tabela. Wykorzystanie 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) przez 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 żądań na interfejs API.
Pod wykresami znajduje się tabela z listą włączonych interfejsów API i usług. Żądania to liczba żądań (w wybranym okresie). 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ę panel interfejsów API i usług.
Jeśli strona się nie wyświetla, kliknij przycisk menu , a następnie wybierz Interfejsy API i usługi.
Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsów API.
Strona Przegląd w Mapach Google
Strona Przegląd Map Google zawiera tabelę z listą interfejsów API włączonych i żądań użytkowania z ostatnich 30 dni. Żądania według interfejsu API są również wyświetlane w postaci wykresu. Wykres płatności pokazuje bieżący rachunek i całkowite wykorzystanie z ostatnich 3 miesięcy.
Aby uzyskać dostęp do strony przeglądu Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Przegląd.
Strona interfejsów API i usług Google Maps Platform
Strona Interfejsy API i usługi w Mapach Google zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępne dla Twojego projektu. W każdym kafelku możesz włączyć lub wyłączyć daną usługę, wybierając Włącz lub Wyłącz. Masz też dostęp do informacji o danych logowania, metrics i przewodników użytkownika dotyczących włączonych interfejsów API. Możesz też użyć filtrów strony, aby wyświetlić włączone lub wyłączone usługi oraz inne kategorie usług.
Aby uzyskać dostęp do strony interfejsów API i usług Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Interfejsy API i usługi.
Strona danych Map Google
Na stronie Dane Map Google są wyświetlane 3 wykresy: Ruch, Błędy i Mediana czasu oczekiwania. 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, w której znajdują się żądania, błędy i czas oczekiwania dotyczące wybranych interfejsów API.
Korzystając z menu API u góry oraz opcji grupowania i filtrowania w panelu po prawej stronie, możesz grupować i filtrować wyświetlane wskaźniki wykorzystania. Aby to zrobić, wybierz konkretne lub wiele interfejsów API, danych logowania, klas kodu odpowiedzi, typu platformy lub domeny. Możesz też wybrać przedział czasu (od 1 godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych wskaźników wykorzystania.
Poniższe obrazy przedstawiają filtry platformy i domeny dla pojedynczego interfejsu API podczas grupowania według Platformy i Domena po wybraniu na liście Pogrupowane według:
Aby uzyskać dostęp do strony Dane 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żesz 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 sekcji Klucze i dane logowania w konsoli Maps Platform. |
Numer projektu Na przykład „project_number:123456”, gdzie 123456 to numer projektu. |
Dane logowania możesz zobaczyć 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. W tej tabeli pokazano 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ź udzielona. Jest to żądanie podlegające rozliczeniu i zużywa limit. |
OK | 3xx, | Odpowiedź udzielona. Jest to żądanie podlegające rozliczeniu i zużywa limit. Na przykład udane żądania Miejsce Zdjęcie zwracają przekierowanie 302 do wskazanego obrazu. |
DATA_NOT_AVAILABLE | 4xx(1) | Odpowiedź z informacją, że nie ma dostępnych danych dla lokalizacji wejściowych. Jest to żądanie podlegające rozliczeniu i zużywa limit. |
ZERO_RESULTS | 4xx(1) | Odpowiedź pomyślna nie zwróciła żadnych wyników. Jest to żądanie podlegające rozliczeniu i zużywa limit. |
NOT_FOUND | 4xx(1) | W przypadku interfejsu Directions API ten komunikat oznacza, że nie udało się przetworzyć danych geograficznych co najmniej jednej lokalizacji podanej w żądaniu, miejscu docelowym lub punkcie pośrednim. W przypadku interfejsu Places API ten komunikat oznacza, że wskazanej lokalizacji (place_id) nie znaleziono w bazie danych Miejsc. Jest to żądanie podlegające rozliczeniu i zużywa 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. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API. Jest to żądanie podlegające rozliczeniu i zużywa limit. |
REQUEST_DENIED | 4xx | Błąd klienta spowodowany między innymi przez błąd uwierzytelniania czy błąd dostępu. Aby dowiedzieć się więcej, 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 okresie. Spróbuj przesłać żądanie później. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API. |
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) | 4xx | Błąd klienta spowodowany nieprawidłowym żądaniem. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API. |
NOT_FOUND (404) (Nie znaleziono) | 4xx | W przypadku interfejsu Geolocation API ten komunikat oznacza, że dane wejściowe nie były wystarczające do wygenerowania szacowanej lokalizacji. W przypadku interfejsu Roads API ten komunikat oznacza, że nie udało się w rozsądny sposób przyciągnąć danych wejściowych do dróg. To żądanie podlegające rozliczeniu, które zużywa limit. |
UNKNOWN_ERROR | 5xx | Błąd serwera wskazujący, że nie można kontynuować żą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, interfejsy API Google Maps Platform
przenoszą:
1) z klasy kodu odpowiedzi HTTP 2xx na 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 stanach interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded , dailyLimitExceeded kod interfejsu API, rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded )2xx userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Aby potwierdzić, że z migracją wiąże się wzrost wartości 4xx lub 5xx we wskaźnikach Google Maps Platform, sprawdź w narzędziu Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (dowiedz się więcej 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 odpowiedniego 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 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 uczyć się z modułów z programowania.
Aby ułatwić zrozumienie wykorzystania i ulepszenia naszych rozwiązań, Google uwzględnia w wywołaniach interfejsu API parametr zapytania solution_channel
, który zbiera informacje o użyciu przykładowego kodu:
- Parametr zapytania
solution_channel
jest domyślnie zawarty w przykładowym kodzie rozwiązania. - Parametr zapytania zwraca statystyki po wdrożeniu rozwiązania do Google, aby poprawić jakość rozwiązania w kolejnych iteracjach.
- Możesz z tego zrezygnować, usuwając parametr zapytania
solution_channel
i jego wartość z przykładowego kodu. - Nie ma wymogu zachowania parametru. Usunięcie tego parametru nie wpłynie na wydajność.
- Parametr zapytania jest używany tylko do przykładowego raportowania wykorzystania kodu.
- Parametr zapytania jest oddzielny od wszelkich analiz i raportów związanych z interfejsem API. Oznacza to, że usunięcie parametru z kodu przykładowego rozwiązania nie wyłącza wewnętrznego raportowania interfejsu Maps JavaScript API.
Raporty dotyczące limitów
Ustalone limity liczby żądań, które Twój projekt może wysyłać do interfejsów Google Maps Platform API. Żądania mogą być ograniczone na 3 sposoby: na dzień, na minutę i na użytkownika na minutę. Do limitu wliczają się tylko żądania udane i powodujące 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ć według żądań na minutę. Bieżące limity dla wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
Aby sprawdzić wartość limitu na minutę w przypadku dowolnej usługi GMP API, użyj tego kalkulatora.
Strona limitów w Mapach Google
Na stronie Limity Map Google wyświetlane są limity oraz wykorzystanie limitów dla wybranego przez Ciebie interfejsu API.
Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch związany z kluczami interfejsu API i identyfikatorami klientów. Ruch powiązany z identyfikatorem klienta jest też dostępny na wykresie wskaźników w konsoli Cloud.
Na stronie wyświetlane są 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łowego argumentu (REQUEST_DENIED
, OVER_QUERY_LIMIT
, INVALID_REQUEST
(nieprawidłowy parametr, błąd analizy żądania)) – nie wykorzystują limitu i nie są wyświetlane.
Jednostka limitu to żądanie większości interfejsów Google Maps Platform API (Maps Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API i Elevation API), ale są pewne wyjątki:
- W przypadku interfejsu DISTANCE Matrix API jednostka limitu to element będący parą miejsce/miejsce docelowe.
- W przypadku Maps JavaScript API jednostką limitu jest obciążenie mapy.
- W przypadku pakietu Maps SDK na Androida i Maps SDK na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Wczytania mapy są dostępne bez opłat i nie zużywają 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 przedstawia jednostkę limitu dla interfejsów Google Maps Platform API.
Interfejs API Google Maps Platform | Jednostka limitu |
---|---|
Maps | |
Maps SDK na Androida | 1 panorama |
Maps SDK na iOS | 1 panorama |
Map Tiles API | 1 prośba |
Interfejs API Map Google Aerial View | 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 | |
Interfejs Routes API (trasy Compute) | 1 prośba |
Interfejs Routes API (tablica tras Compute) | 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 |
Route Optimization 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 przycisk menu i wybierz Płatności.
- Jeśli masz kilka kont rozliczeniowych, kliknij Przejdź do połączonego konta, aby otworzyć stronę Przegląd połączonego konta.
- W menu po lewej stronie wybierz Raporty, aby otworzyć stronę Raporty dotyczącą płatności na połączonym koncie rozliczeniowym.
Jak odczytywać wykres raportu rozliczeniowego
Raporty rozliczeniowe przedstawiają koszt w postaci skumulowanego wykresu liniowego z upływem czasu. Widok domyślny zawiera dzienne koszty w danym miesiącu związane z wykorzystaniem, pogrupowane według projektów (wszystkich usług) i obejmujące wszystkie zastosowane środki związane z wykorzystaniem, 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 według kosztu). Dowiedz się więcej o interpretowaniu wykresu raportu rozliczeniowego
Wskazówka: przeanalizuj wykorzystanie i koszt na kod SKU
Aby dokładniej poznać szczegóły modelu cenowego płatności według wykorzystania oraz jego wpływ na implementację, przeanalizuj wykorzystanie i koszt według kodu SKU.
Aby zmienić widok raportu tak, aby wyświetlać elementy zamówienia według kodu SKU:
- W panelu po prawej stronie wykresu rozwiń filtr Grupuj według.
- Wybierz SKU.
Inne dostępne filtry raportu rozliczeniowego to Przedział czasu, Projekty, Usługi, Kody SKU i Lokalizacje. Pozwalają filtrować dane według tego, skąd są dostarczane żądania do interfejsu API.
Aby przypisać źródło użytkowania do określonej usługi (oprócz usługi), 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 (cztery ostatnie znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) oraz goog-maps-channel (ustawiona liczbowa wartość kanału z zapytania interfejsu API). Więcej informacji o filtrowaniu i grupowaniu
Możesz zmienić widok wykresu tak, aby wykluczyć środki związane z wykorzystaniem. W tym celu w panelu po prawej stronie zaznacz pole wyboru Uwzględnij środki w koszcie.
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ć, jak wydatki wzrastają do określonej kwoty. Ustawienie budżetu nie ogranicza wykorzystania interfejsu API, a jedynie powiadamia, gdy kwota wydatków zbliży się do określonej kwoty.
Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z interfejsów API podlegających rozliczeniu. Ustawiając limity liczby żą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ć. Przykład: (miesięczne wydatki /cena za każdy kod SKU)/30 = limit żądań dziennie (dla 1 interfejsu API).
Śledzenie wykorzystania na kanał
Aby śledzić wykorzystanie za pomocą kanałów liczbowych, musisz dodać do żądań do interfejsu API parametr „channel”. Jedyne dopuszczalne wartości kanałów to liczby od 0 do 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>
Sprawdzaj wykorzystanie kanału bezpośrednio w raporcie rozliczeniowym. Kanały będą widoczne w sekcji Etykiety jako klucz goog-maps-channel.
Aby filtrować raport rozliczeniowy według kodu SKU i kanału
- Użyj filtra Pogrupuj według SKU.
- Wybierz 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, aby zobaczyć koszty wygenerowane przez każdy kanał.
Gdy wdrożysz dane o korzystaniu z kanału w swoich żądaniach, może minąć trochę czasu (do 24 godzin), zanim pojawią się one w raporcie rozliczeniowym.
Eksportowanie danych rozliczeniowych do BigQuery
Możesz też wyeksportować dane rozliczeniowe do BigQuery.
Funkcja BigQuery Export pozwala na automatyczne eksportowanie w ciągu dnia szczegółowych danych z rozliczeń usługi Google Cloud (takich jak dane o wykorzystaniu i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem uzyskać dostęp do danych rozliczeniowych w BigQuery, aby przeprowadzić szczegółową analizę. Zapewnia to dodatkowy poziom szczegółowości informacji o źródle korzystania z Google Maps Platform.
Jeśli chcesz zacząć eksportować dane do BigQuery i wysyłać do nich zapytania, 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 identyfikator Twojego projektu (np. „mój-projekt-123456”).
- DATASET_NAME to nazwa utworzonego zbioru danych (np. „SampleDataSet”).
- BILLING_ACCOUNT_ID to odwołanie do identyfikatora konta rozliczeniowego z prefiksem „gcp_billing_exportv1” i zmieniające łączniki (-) 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:
- Utwórz, zmodyfikuj i zamknij konto rozliczeniowe Cloud
- Modyfikowanie ustawień płatności projektu
- Wyświetlanie raportów rozliczeniowych i trendów kosztów
- Ustawiać budżety i alerty dotyczące budżetu
- Ograniczenie wykorzystania interfejsu API
- Rozliczenia za Google Maps Platform
- Przewodnik po optymalizacji
- Sprawdzone metody dotyczące kluczy interfejsu API
Stan odpowiedzi i raporty
Poniższa tabela przedstawia mapowanie stanu interfejsu API Map Google, kodu odpowiedzi HTTP zwracanego w odpowiedziach interfejsu API Map Google i klasy kodu odpowiedzi HTTP w raporcie wykorzystania. Wskazuje też, czy odpowiednie żądanie pojawia się w raportach o wykorzystaniu, limitach i rozliczeniach.
Raport o wykorzystaniu w danych Google Maps Platform zapewnia szczegółowość na poziomie HTTP response code class
. Jeśli potrzebujesz wyższego poziomu szczegółowości, zapoznaj się z kodami stanu odpowiedzi dostępnymi w artykule Monitorowanie 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 |
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, interfejsy API Google Maps Platform
przenoszą:
1) z klasy kodu odpowiedzi HTTP 2xx na 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 stanach interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded , dailyLimitExceeded kod interfejsu API, rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded , rateLimitExceeded )2xx userRateLimitExceeded 5xx UNKNOWN_ERROR
W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Aby potwierdzić, że z migracją wiąże się wzrost wartości 4xx lub 5xx we wskaźnikach Google Maps Platform, sprawdź w narzędziu Metrics Explorer, jaki dokładnie kod odpowiedzi rośnie (dowiedz się więcej o korzystaniu z Google Cloud Monitoring dla Google Maps Platform).
|
Raporty z sekcji Zaangażowanie
Statystyki firmy
Google Maps Platform zapewnia wgląd w to, jak użytkownicy korzystają z Twoich map. Te statystyki obejmują kluczowe wskaźniki zaangażowania, takie jak wyświetlenia na mapie i interakcje z ważnym miejscem. Możesz analizować te statystyki, aby odkrywać popularne lokalizacje związane z reklamami i marketingiem lub optymalizować wrażenia użytkowników.
Funkcje raportowania statystyk biznesowych obejmują:
- przeglądać ogólne podsumowanie statystyk biznesowych, aby mieć szybki wgląd w kluczowe trendy w tych statystykach;
- Analizowanie konkretnych danych w konsoli w celu uzyskania bardziej szczegółowych informacji na temat danych.
- eksportowanie danych do pliku CSV, aby móc analizować dane ze statystyk biznesowych w ulubionym narzędziu do analizy biznesowej;
Dostępne dane o zaangażowaniu:
- Wyświetlenia mapy:śledź wyświetlenia mapy wynikające z przesunięcia, powiększenia lub przechylenia. Wyświetlenia na mapach są obliczane według kodu pocztowego co tydzień (od niedzieli do soboty czasu pacyficznego). Nowe dane są publikowane co tydzień w pierwszą środę po okresie obserwacji.
Użytkownicy mogą wyświetlać statystyki biznesowe na stronie Wskaźniki w Cloud Console. Projekt musi mieć włączony interfejs Maps JavaScript API.
Wskaźniki zaangażowania możesz analizować bezpośrednio w konsoli dzięki funkcjom Filtruj i Pogrupuj według, które pozwalają bardziej szczegółowo analizować dane. Możesz na przykład ustawić filtrowanie według konkretnego regionu, aby sprawdzić trendy wyświetleń mapy dotyczące tylko kodów pocztowych w tym regionie. Z drugiej strony możesz pogrupować dane według konkretnego regionu, by zebrać w nim interakcje.
Użytkownicy mogą wyeksportować cały zbiór danych lub filtrowany widok do pliku CSV, aby przeprowadzić dalszą analizę w ulubionym narzędziu do analizy biznesowej. Jednocześnie możesz pobierać dane maksymalnie z 90 dni. Pobierane pliki większe niż 60 tys. komórek zostaną obcięte. Eksportowanie danych widoków map do pliku CSV może potrwać kilka minut w zależności od wybranego zakresu czasowego.
Dane statystyk biznesowych są anonimizowane i odzwierciedlają tylko ogólne trendy w zainteresowaniu Twoimi mapami. Małe wartości mogą zostać zaokrąglone do zera, a wkład danych z wyników odstających może zostać zredukowany.
Dostęp do statystyk biznesowych swojego projektu Cloud możesz kontrolować w Google Cloud Console 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.
Statystyki biznesowe nie powinny być używane do szacowania kosztów wykorzystania. Więcej informacji o wykorzystaniu znajdziesz w raportach o wykorzystaniu.
Lokalizator Plus
W przypadku użytkowników Lokalizatora Plus panel statystyk pomaga analizować dane i generować na ich podstawie statystyki, dając jasny obraz tego, jak kupujący wchodzą w interakcje z lokalizatorem sklepów. Możesz mierzyć skuteczność z tygodnia na tydzień, w tym liczbę wyświetleń, liczbę interakcji z informacjami o wyszukiwarce i informacjach o miejscu oraz ogólny współczynnik zaangażowania. Panel zawiera też ważne porównania Twojej implementacji z wynikami innych sprzedawców.
- 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 pozwala porównać Twoje dane ze zbiorczymi danymi innych firm z branży, które udostępniają te informacje. Porównanie daje cenny kontekst, pomaga wyznaczać wymierne cele, daje wgląd w trendy branżowe i pomaga określić, jak wypadasz na tle konkurencji.
Aby wyświetlić dane z analizy porównawczej, dane o zaangażowaniu są anonimowo uwzględniane w testach porównawczych Google. Aby zrezygnować z wyświetlania i anonimowego uwzględniania danych o zaangażowaniu w raportach analizy porównawczej, wyślij zgłoszenie. Rozpatrywanie zgłoszenia zazwyczaj zajmuje do 3 dni.