Raportowanie w Google Maps Platform udostępnia zestaw wstępnie zdefiniowanych elementów wizualnych raportów dotyczących podstawowego wykorzystania interfejsu API, limitów oraz informacji rozliczeniowych Konsola Google Cloud. Użyj tych raportów, aby określić liczbę interfejsów API liczby wykonanych wywołań, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, korzystanie z płatności w miarę upływu czasu.
Typy raportów:
- Raporty o wykorzystaniu: raportuje liczbę żądań wysłanych przez projekt do: interfejsów API Google Maps Platform za pomocą danych logowania powiązanych z Twoim projektem.
- Raporty dotyczące limitów: przedstawiają wykorzystanie limitu w formie 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 z zastosowanymi środkami związanymi z wykorzystaniem, a także łączną kwotą prognozowany koszt 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 odpowiedzi i kodów odpowiedzi definiujących czy żądanie jest widoczne w sekcjach Użycie, Limit, lub Płatności, zobacz Stan odpowiedzi i raporty –
Raporty o wykorzystaniu, limitach i rozliczeniach Google Maps Platform możesz wyświetlać za pomocą Konsola Cloud.
Raporty o wykorzystaniu
Wykorzystanie zależy od liczby żądań wysyłanych przez Twój projekt do Interfejsy API Google Maps Platform używające danych logowania powiązanych z w projektach AI. Żądania obejmują żądania zakończone pomyślnie i pozostawiające serwer oraz żądania, które powodują błędy klienta. Dane uwierzytelniające obejmują Klucze API i identyfikatory klienta (na potrzeby projektów w abonamencie Premium i przeniesionych projektów premium). Szczegółowe informacje znajdziesz w artykułach Omówienie abonamentu Premium oraz Dowiedz się więcej 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 opóźnienia). Do celów śledzenia:
Wszystkie interfejsy API: możesz filtrować i grupować dane o wykorzystaniu dla wszystkich interfejsów API w tych sposoby:
- Filtruj według przedziału czasu i interfejsu API.
- Możesz wyświetlać ruch, błędy i czas oczekiwania według kodu odpowiedzi, interfejsu API danych logowania.
Konkretny interfejs API: możesz filtrować i grupować dane dotyczące wykorzystania dla określonego interfejsu API. w następujący sposób:
- Filtruj według okresu, wersji interfejsu API, danych logowania i metod.
- Wyświetlanie ruchu, błędów i czasu oczekiwania według kodu odpowiedzi i metody interfejsu API oraz wersję i dane logowania.
Interfejsy API Strona panelu usług
Interfejsy API Usługi Panel zawiera przegląd wskaźników wykorzystania wszystkich interfejsów API tych interfejsów API: Google Maps Platform API oraz Interfejsy API i usługi.
Na stronie Panel znajdują się 3 wykresy i tabela. Możesz filtrować wykorzystanie danych, wyświetlane na wykresach i w tabelach, wybierając przedział czasu za okres od 1 godziny do ostatnich 30 dni.
Wykres Ruch pokazuje wykorzystanie w zapytaniach na minutę (QPM) na interfejs API.
Wykres Błędy pokazuje odsetek żądań, które spowodowały błędy za interfejs 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 interfejsów API Strona Panelu usług:
- Otwórz stronę selektora projektów w konsoli Cloud:
- Wybierz projekt. Interfejsy API Pojawi się strona panelu usług.
Jeśli strona się nie pojawi, kliknij przycisk menua następnie wybierz Interfejsy API Usługi.
Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsów API.
Strona Przegląd w Mapach Google
Mapy Google Strona Przegląd zawiera tabelę z interfejsami API włączonymi i żądaniami wykorzystania 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 oraz 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 konsoli Cloud:
- W menu po lewej stronie wybierz Przegląd.
Interfejsy API i Strona Usługi
Mapy Google Interfejsy API strona usługi zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępnych dla Twojego projektu. W każdym kafelku możesz włączyć lub wyłączyć te elementy usługi, wybierając Włącz lub Wyłącz, i możesz uzyskać dostęp do danych logowania informacje, dane i przewodniki użytkownika dotyczące 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 interfejsów API Google Maps Platform i Strona Usługi:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Interfejsy API i Usługi.
Strona danych Map Google
Mapy Google Strona Wskaźniki powoduje wyświetlenie 3 wykresów: 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 na stronie Wskaźniki znajduje się tabela interfejsów API żądań, błędów i czasu oczekiwania w wybranych interfejsach API.
Korzystając z 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 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ści (na sekundę lub dzień) wyświetlanych wskaźników wykorzystania.
Poniższe obrazy przedstawiają filtry platformy i domeny dla pojedynczego interfejsu API, gdy grupowanie według platformy i domeny jest wybrane 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 API.
Format danych logowania | Znaczenie |
---|---|
Nazwa klucza Na przykład „Klucz aplikacji mobilnej” |
Do wczytania interfejsu API użyto klucza za pomocą
?key=... : nazwy kluczy możesz znaleźć w Maps Platform
Konsola w sekcji Klucze Dane logowania. |
Numer projektu Na przykład „project_number:123456”, gdzie 123456 to numer projektu. |
Dane logowania mogą się wyświetlać na 2 sposoby:
|
Wykresy kodu odpowiedzi
Wykresy Ruch według kodu odpowiedzi i Błąd według kodu odpowiedzi są podzielone dla klasy kodu odpowiedzi HTTP. Ta tabela przedstawia mapowanie stan odpowiedzi interfejsu Google Maps Platform API i klasę kodu odpowiedzi HTTP:
Stan interfejsu API Map Google | Klasa kodu odpowiedzi HTTP – raport o wykorzystaniu (2xx, 3xx, 4xx, 5xx) |
Uwagi |
---|---|---|
OK | 2xx | Odpowiedź udzielona. To żądanie płatne i zużywa limit. |
OK | 3xx, | Odpowiedź udzielona. To żądanie płatne i zużywa limit. Na przykład Zdjęcie miejsca udane żądania zwracają przekierowanie 302 do wskazanego obrazu. |
DATA_NOT_AVAILABLE | 4xx(1) | Odpowiedź informująca o tym, że nie ma dostępnych danych dla
lokalizacji wejściowych. To żądanie płatne i zużywa limit. |
ZERO_RESULTS | 4xx(1) | Odpowiedź pomyślna nie zwróciła żadnych wyników. To żądanie płatne i zużywa limit. |
NOT_FOUND | 4xx(1) | W przypadku atrybutu
Directions API,
ten komunikat oznacza, że co najmniej jedna z lokalizacji podanych w
Nie udało się przetworzyć danych geograficznych punktu początkowego, miejsca docelowego lub punktów pośrednich żądania. W przypadku atrybutu Places API ten komunikat oznacza, że podana lokalizacja (place_id) nie została znalezione w bazie danych Miejsc. To żądanie płatne 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. Sprawdź interfejs API
. To żądanie płatne 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, Przekroczono limit liczby żądań, DailyLimitExceeded (Przekroczono limit dzienny), userRateLimitExceeded |
4xx | Błąd klienta spowodowany zbyt dużą liczbą żądań w dozwolonym okresie. Spróbuj jeszcze raz może przesłać żądanie w późniejszym terminie. Aby dowiedzieć się więcej, sprawdź odpowiedź interfejsu API. |
INVALID_REQUEST (nieprawidłowy lub brakujący parametr, żądanie błąd analizy lub weryfikacji) | 4xx | Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedzi interfejsu API . |
NOT_FOUND (404) (Nie znaleziono) | 4xx | W przypadku atrybutu
Geolocation API,
ten komunikat oznacza, że dane wejściowe nie były wystarczające do wygenerowania
od szacowanej lokalizacji. W przypadku interfejsu Roads API: ten komunikat oznacza, że danych wejściowych nie udało się w rozsądny sposób przyciągnąć do dróg. To żądanie płatne i zużywa limit. |
UNKNOWN_ERROR | 5xx | Błąd serwera wskazujący, że nie można kontynuować żądania: wewnętrzny błąd, przeciążona usługa, niedostępna, przekroczenie limitu czasu itp. |
1.
Aby poprawić spójność raportowania kodów błędów, Google Maps Platform
Przenosimy interfejsy API:
1) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla
Stany interfejsu API Map Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS – stan,
2) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla
Stany interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded
rateLimitExceeded , userRateLimitExceeded
3) z klasy kodu odpowiedzi HTTP 2xx na 5xx dla
Stan interfejsu API Map Google: UNKNOWN_ERROR .
Podczas przenoszenia możesz zobaczyć oba kody odpowiedzi
okresu przejściowego. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź wzrost wskaźnika 4xx lub 5xx w
Dane Google Maps Platform
jest związany z tą migracją, sprawdzając, który dokładny kod odpowiedzi zwiększa się
za pomocą narzędzia Metrics Explorer,
(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 odpowiedzi dokumentację interfejsu API, który Cię interesuje (na przykład Geocoding Responses lub odpowiedzi na wskazówki).
Parametr rozwiązań Google Maps Platform
Google Maps Platform udostępnia wiele rodzajów przykładowego kodu, który ułatwia rozpoczęcie pracy i szybkie działanie. Na przykład możesz użyć Szybki konstruktor w Cloud Console postępuj zgodnie z rozwiązaniami branżowymi przewodnikach po implementacji, i wyciągać wnioski ćwiczenia z programowania.
Aby zrozumieć wykorzystanie rozwiązań i sposoby ich ulepszania, Google uwzględnia
solution_channel
parametr zapytania
w wywołaniach interfejsu API w celu zbierania informacji o użyciu przykładowego kodu:
- Parametr zapytania
solution_channel
jest domyślnie uwzględniony. w przykładowym kodzie rozwiązania. - Parametr zapytania zwraca statystyki dotyczące wdrożenia rozwiązania do Google. aby poprawić jakość rozwiązania w kolejnych iteracjach.
- Możesz z tego zrezygnować, usuwając zapytanie
solution_channel
i jego wartość z przykładowego kodu. - Nie ma wymogu zachowania parametru. Usuwam zapytanie nie wpływa na wydajność.
- Parametr zapytania jest używany tylko do przykładowego raportowania wykorzystania kodu.
- Parametr zapytania jest niezależny od analityki związanej z interfejsem API i raportowania danych. Oznacza to 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 dotyczące liczby żądań, które projekt może wysłać do interfejsów API Google Maps Platform. Żądania mogą zostać ograniczone na 3 sposoby: na dzień, minutę i na użytkownika na minutę. Tylko udane żądania oraz Żądania, które powodują błędy serwera, są wliczane do limitu. Prośby, które nieudane uwierzytelnianie nie jest wliczane do limitu.
Wykorzystanie limitu jest wyświetlane w formie wykresów na stronie Limity w konsoli Cloud. i można je grupować według żądań na minutę. Obecne limity dla wybrane interfejsy API są wyświetlane w tabelach poniżej wykorzystania limitu wykresy.
Aby uzyskać wartość limitu na minutę w przypadku dowolnej usługi GMP API, użyj tego kalkulatora.
Strona limitów w Mapach Google
Mapy Google Strona Limity pokazuje limity i wykorzystanie limitów dla wybranego przez Ciebie interfejsu API.
Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch klucze interfejsu API i identyfikatory klientów. Ruch generowany przez ID klienta jest też dostępny w Wykres wskaźników w konsoli Cloud.
Na stronie wyświetlają się tylko żądania, które zużywają limit: żądania udane (OK
,
ZERO_RESULTS
, DATA_NOT_AVAILABLE
) i żądania, które powodują błędy serwera
(NOT_FOUND
, INVALID_REQUEST/INVALID_VALUE
(nieprawidłowa wartość parametru), UNKNOWN_ERROR
).
Żądania, które powodują błędy klienta – uwierzytelnianie, autoryzacja i
błędy dotyczące nieprawidłowych argumentów (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 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 interfejsie DISTANCE Matrix API jednostka limitu jest elementem czyli parę miejsc wylotu i przylotu.
- W przypadku Maps JavaScript API jednostką limitu jest obciążenie mapy.
- W przypadku Maps SDK na Androida i Maps SDK na iOS jednostka limitu to prośba o Street View lub Panorama strony. 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.
Jednostki przydziału
Ta tabela przedstawia jednostkę limitu dla interfejsów Google Maps Platform API.
Interfejs API Google Maps Platform | Jednostka limitu |
---|---|
Mapy | |
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: 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, 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 na temat płatności. dla połączonego konta rozliczeniowego.
Jak odczytywać wykres raportu rozliczeniowego
Raporty rozliczeniowe przedstawiają koszt w postaci skumulowanego wykresu liniowego z upływem czasu. Domyślny przedstawia dzienne koszty z bieżącego miesiąca pogrupowane według wykorzystania projektu (dla wszystkich usług), w tym wszelkie zastosowane środki oraz łączny koszt prognozowany za bieżący miesiąc. Każdy linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi, w kolejności od największej do najmniejszej według kosztu. Więcej informacji o interpretowaniu wykresu raportu rozliczeniowego.
![Zrzut ekranu pokazujący raport rozliczeniowy zawierający wykres i tabelę przy użyciu
domyślny widok gotowych ustawień](https://cloud.google.com/billing/docs/images/billing-reports1.png?authuser=19&hl=pl)
Wskazówka: przeanalizuj wykorzystanie i koszt na kod SKU
Aby lepiej zrozumieć szczegóły modelu cenowego płatności według wykorzystania jak wpływa to na implementację, należy przyjrzeć się wykorzystaniu i kosztom w podziale na kody SKU.
![Raport rozliczeniowy pogrupowany według kodu SKU](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-table-by-sku.png?authuser=19&hl=pl)
![Zrzut ekranu przedstawiający filtry raportu rozliczeniowego](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filters-sku.png?authuser=19&hl=pl)
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 raportów rozliczeniowych to Zakres czasowy, Projekty, Produkty, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według gdzie żądania do interfejsu API.
Aby skategoryzować źródło użytkowania (oprócz usługi), skonfiguruj płatności grupowe według jednej z wymienionych wartości. 3 klucze, które odnoszą się do Interfejsy Google Maps Platform API to goog-maps-api-key-suffix (ostatnie cztery znaków klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) oraz goog-maps-channel (z wartością liczbową, wartość kanału z zapytania API). Więcej o filtrowaniu i grupowaniu.
Możesz zmienić widok wykresu tak, aby wykluczyć środki związane z wykorzystaniem, usuwając zaznacz pole wyboru Uwzględnij środki w koszcie w panelu po prawej stronie.
Monitorowanie i ograniczanie wykorzystania
Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz wykonać te czynności:
- Skonfiguruj alert dotyczący budżetu. śledzić wzrost wydatków do określonej kwoty. Ustawianie budżetu nie ogranicza wykorzystania interfejsu API, ale ostrzega tylko, gdy wydatki zbliżą się do określoną kwotę.
Ogranicz dzienne wykorzystanie interfejsu API, aby zarządzać kosztami korzystania z płatnych interfejsów API. Przez ustawienie limitów liczby żądań na dzień, możesz ograniczyć wydatki. Za pomocą prostego równania określamy dzienny poziom w zależności od tego, ile chcesz wydać. Na przykład: (Wydatki miesięczne /cena za każdy kod SKU)/30 = limit żądań dziennie (dla jednego interfejsu API).
Śledzenie wykorzystania na kanał
Aby śledzić wykorzystanie za pomocą kanałów liczbowych, musisz dodać parametr „channel” parametr do żądań do interfejsu API. 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ą odzwierciedlać w sekcji Etykiety jako klucz goog-maps-channel.
![Filtruj według etykiet](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/reporting-and-monitoring/images/billing-report-filter-channel.png?authuser=19&hl=pl)
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 dane zostaną uwzględnione w raporcie rozliczeniowym.
Eksportowanie danych rozliczeniowych do BigQuery
Możesz też wyeksportować dane rozliczeniowe do BigQuery.
BigQuery Export umożliwia eksportowanie szczegółowych danych o rozliczeniach usługi Google Cloud (takich jak wykorzystanie prognozowanych kosztów) automatycznie w ciągu dnia do określony przez Ciebie zbiór 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 płatności Eksport rozliczeń BigQuery na swoim koncie.
- 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 identyfikator Twojego konta rozliczeniowego.
poprzedzony prefiksem „gcp_billing_exportv1” i zmianą myślników (-) na podkreślenia (_).
Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmienił się w
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ń rozliczeń projektu
- Wyświetlanie raportów dotyczących rozliczeń i trendów w zakresie kosztów
- Konfigurowanie alertów dotyczących 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
W tabeli poniżej znajdziesz mapowanie stanu interfejsu API Map Google i kodu odpowiedzi HTTP zwracanych w odpowiedziach interfejsu API Map Google i klasie kodu odpowiedzi HTTP w raporcie wykorzystania oraz wskazuje jeśli odpowiednie żądanie jest widoczne w raportach na temat wykorzystania, limitu i rozliczeń.
Raport o wykorzystaniu w danych Google Maps Platform.
zapewniają szczegółowość na poziomie HTTP response code class
. Jeśli potrzebujesz wyższego poziomu
szczegółowość – patrz Kody stanu odpowiedzi
dostępne w
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 (DANE_NIEDOSTĘPNE), NOT_FOUND, ZERO_RESULTS |
200, 404, |
4xx1 | Tak | Tak | Tak |
INVALID_REQUEST (nieprawidłowa wartość parametru), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, ip. |
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 (Przekroczono limit dzienny), Przekroczono limit liczby żądań, 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, Google Maps Platform
Przenosimy interfejsy API:
1) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla
Stany interfejsu API Map Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS – stan,
2) z klasy kodu odpowiedzi HTTP 2xx na 4xx dla
Stany interfejsu API Map Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded
rateLimitExceeded , userRateLimitExceeded
3) z klasy kodu odpowiedzi HTTP 2xx na 5xx dla
Stan interfejsu API Map Google: UNKNOWN_ERROR .
Podczas przenoszenia możesz zobaczyć oba kody odpowiedzi
okresu przejściowego. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie się zmieniają.
Potwierdź wzrost wskaźnika 4xx lub 5xx w
Dane Google Maps Platform
jest związany z tą migracją, sprawdzając, który dokładny kod odpowiedzi zwiększa się
za pomocą narzędzia Metrics Explorer,
(dowiedz się więcej o korzystaniu z
Google Cloud Monitoring dla Google Maps Platform).
|
Raporty dotyczące zaangażowania
Statystyki firmowe
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 poznać trendy dotyczące wyświetleń mapy tylko dla 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 Lokalizator Plus panel statystyk pomaga analizować i generować analizy na podstawie danych, dające jasny obraz tego, jak radzą sobie używając lokalizatora sklepów. Skuteczność możesz mierzyć tygodniowo przez w tym tygodniu, w tym liczbę wyświetleń i interakcji z wyszukiwarką, Informacje o miejscu i ogólny współczynnik zaangażowania. Ponadto w panelu zawiera ważne testy porównawcze w porównaniu z implementacją z innymi sprzedawcami.
- Otwórz Lokalizator Plus w 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 danych ze wskaźnikami dane branżowe pochodzące od innych firm, które je udostępniają. Porównanie zapewnia cenny kontekst, pomagający wyznaczać realistyczne cele, trendy w branży i możliwość sprawdzenia, jak wypadasz w porównaniu z konkurencji.
Aby wyświetlić dane z analizy porównawczej, dane o zaangażowaniu są dołączane anonimowo w testach porównawczych Google. Aby zrezygnować zarówno z oglądania, anonimowo w raportach analizy porównawczej, zgłoszenie. Rozpatrywanie zgłoszenia zazwyczaj zajmuje do 3 dni.