Raportowanie w Google Maps Platform zapewnia zestaw wstępnie zdefiniowanych raportów wizualnych dotyczących podstawowego wykorzystania interfejsu API, limitów i informacji rozliczeniowych w konsoli Google Cloud. Dzięki tym raportom możesz określić liczbę wywołań interfejsu API, sprawdzić, jak blisko jesteś osiągnięcia limitów wykorzystania interfejsu API, oraz monitorować wykorzystanie rozliczeń w czasie.
Dostępne są te typy raportów:
- Raporty dotyczące wykorzystania: zawierają liczbę żądań wysyłanych przez projekt do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z projektem.
- Raporty dotyczące wykorzystania limitów: zawierają wykresy wykorzystania limitów, które można grupować według żądań na minutę. Bieżące limity 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 promocyjne związane z wykorzystaniem, a także łączny prognozowany koszt w całym bieżącym miesiącu.
Pełną listę stanów i kodów odpowiedzi, które określają, czy żądanie pojawia się w raportach Wykorzystanie, Limit i Płatności, znajdziesz w artykule Stan odpowiedzi i raporty.
Raporty dotyczące wykorzystania, limitów i płatności w Google Maps Platform możesz wyświetlać w konsoli Cloud.
Raporty dotyczące wykorzystania
Wykorzystanie jest określane na podstawie liczby żądań, które projekt wysyła do interfejsów API Google Maps Platform przy użyciu danych logowania powiązanych z projektem. Żądania obejmują żądania zakończone powodzeniem, żądania, które powodują błędy serwera, oraz żądania, które powodują błędy klienta. Dane logowania obejmują klucze interfejsu API i identyfikatory klienta (w przypadku abonamentu Premium i przeniesionych projektów z abonamentem Premium). Więcej informacji znajdziesz w omówieniu abonamentu Premium oraz w artykule o używaniu 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 okresu i interfejsu API.
- Wyświetlaj ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, interfejsu API i danych logowania.
Konkretny interfejs API: możesz filtrować i grupować dane o wykorzystaniu konkretnego interfejsu API na te sposoby:
- Filtruj według przedziału czasu, wersji interfejsu API, danych logowania i metod.
- Wyświetlaj ruch, błędy i czas oczekiwania pogrupowane według kodu odpowiedzi, metody i wersji interfejsu API oraz danych logowania.
Strona panelu interfejsów API i usług
Panel Interfejsy API i usługi 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.
Strona Panel zawiera 3 wykresy i tabelę. Możesz filtrować wykorzystanie wyświetlane na wykresach i w tabelach, wybierając 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 zakończyły się błędami, w podziale na interfejsy 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 zakończyły się błędem. Czas oczekiwania (średni czas oczekiwania i centyl) to czas oczekiwania na te żądania.
Aby uzyskać dostęp do strony panelu Interfejsy API i usługi:
- Otwórz stronę Wybór projektu w konsoli Cloud:
- Wybierz projekt. Pojawi się strona panelu Interfejsy API i usługi.
Jeśli strona się nie pojawi, kliknij przycisk menu
, a następnie wybierz Interfejsy API i usługi.
Więcej informacji znajdziesz w artykule Monitorowanie wykorzystania interfejsu API.
Strona Przegląd w Mapach Google
Strona Przegląd Map 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ż wyświetlane w formie wykresu. Wykres rozliczeń pokazuje bieżący rachunek i łączne wykorzystanie z ostatnich 3 miesięcy.
Aby otworzyć stronę Przegląd Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie kliknij Przegląd.
Strona interfejsów API i usług Google Maps Platform
Strona Interfejsy API i usługi Map Google zawiera siatkę kafelków reprezentujących interfejsy API, pakiety SDK i inne usługi dostępne w Twoim projekcie. W każdym kafelku możesz włączyć lub wyłączyć daną usługę, wybierając Włącz lub Wyłącz. Możesz też uzyskać dostęp do informacji o danych logowania, wskaźników 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 i 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 Wskaźniki w Mapach Google
Na stronie Dane Map Google wyświetlane są 3 wykresy: Ruch, Błędy i Średni czas oczekiwania. Dane o użyciu na wykresach można grupować według klasy kodu odpowiedzi, interfejsu API, metody interfejsu API, danych logowania, platformy i domeny.
Pod wykresami na stronie Wskaźniki znajduje się tabela interfejsów API, która wyświetla żądania, błędy i czas oczekiwania dla wybranych interfejsów API.
Przy użyciu menu interfejsu API u góry oraz opcji grupowania i filtrowania w panelu po prawej stronie możesz grupować i filtrować wyświetlane wskaźniki wykorzystania, wybierając konkretne lub wiele interfejsów API, danych logowania, klas kodów odpowiedzi, typów platform i domen. Możesz też wybrać okres (od 1 godziny do ostatnich 30 dni) i szczegółowość (na sekundę lub dzień) wyświetlanych danych o wykorzystaniu.
Poniższe obrazy pokazują filtry Platforma i Domena dla konkretnego interfejsu API, gdy na liście Grupowanie według wybrano grupowanie według Platforma i Domena:
Aby uzyskać dostęp do strony Wskaźniki interfejsu API Google Maps Platform:
- Otwórz stronę Google Maps Platform w konsoli Cloud:
- W menu po lewej stronie wybierz Dane.
Raporty dotyczące danych logowania
Możesz filtrować i grupować dane według danych logowania użytych do wczytania interfejsu API.
| Format danych logowania | Znaczenie |
|---|---|
| Nazwa klucza Na przykład „Klucz aplikacji mobilnej”. |
Do wczytania interfejsu API użyto klucza interfejsu API za pomocą ?key=...: nazwy kluczy znajdziesz w konsoli Maps Platform w sekcji Klucze i dane logowania. |
| Numer projektu Na przykład „project_number:123456”, gdzie 123456 to numer projektu. |
Jeśli widzisz te dane logowania, możliwe są 2 sytuacje:
|
Wykresy kodów odpowiedzi
Wykresy Ruch według kodu odpowiedzi i Błędy według kodu odpowiedzi dzielą wykorzystanie według klasy kodu odpowiedzi HTTP. Ta tabela pokazuje mapowanie między stanem odpowiedzi interfejsu API Google Maps Platform a klasą kodu odpowiedzi HTTP:
| Stan interfejsu API Map Google | Klasa kodu odpowiedzi HTTP – raport dotyczący wykorzystania (2xx, 3xx, 4xx, 5xx) |
Uwagi |
|---|---|---|
| OK | 2xx | Odpowiedź informująca o powodzeniu. To żądanie jest płatne i spowoduje wykorzystanie limitu. |
| OK | 3xx | Odpowiedź informująca o powodzeniu. To żądanie jest płatne i spowoduje wykorzystanie limitu. Na przykład żądania zdjęcia miejsca, które zostały zrealizowane, zwracają przekierowanie 302 do wskazanego obrazu. |
| DATA_NOT_AVAILABLE | 4xx(1) | Odpowiedź o powodzeniu wskazująca, że nie ma dostępnych danych dla podanych lokalizacji. To żądanie jest płatne i spowoduje wykorzystanie limitu. |
| ZERO_RESULTS | 4xx(1) | Odpowiedź nie zwróciła żadnego wyniku. To żądanie jest płatne i spowoduje wykorzystanie limitu. |
| NOT_FOUND | 4xx(1) | W przypadku Directions API (starsza wersja) ten komunikat oznacza, że nie udało się geokodować co najmniej jednej lokalizacji określonej w miejscu początkowym, miejscu docelowym lub punktach orientacyjnych żądania. W przypadku Places API ten komunikat oznacza, że wskazana lokalizacja (place_id) nie została znaleziona w bazie danych miejsc. Jest to żądanie podlegające opłacie, które spowoduje wykorzystanie limitu. |
| INVALID_REQUEST (nieprawidłowa wartość parametru), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED i inne. |
4xx | Błąd spowodowany nieprawidłową wartością parametru. Więcej informacji znajdziesz w odpowiedzi interfejsu API. To żądanie jest płatne i spowoduje wykorzystanie limitu. |
| REQUEST_DENIED | 4xx | Błąd klienta spowodowany błędem uwierzytelniania, błędem dostępu lub innym błędem. 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 przedziale czasu. Spróbuj ponownie później. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
| INVALID_REQUEST (nieprawidłowy lub brakujący parametr, błąd analizy lub weryfikacji żądania) | 4xx | Błąd klienta spowodowany nieprawidłowym żądaniem. Więcej informacji znajdziesz w odpowiedzi interfejsu API. |
| NOT_FOUND (404) (Nie znaleziono) | 4xx | W sekcji
Directions API (starsza wersja) – ten komunikat oznacza, że nie udało się określić kodu geograficznego co najmniej jednej z lokalizacji podanych w miejscu rozpoczęcia, miejscu docelowym lub punktach orientacyjnych żądania. W przypadku Geolocation API ten komunikat oznacza, że dane wejściowe nie wystarczyły do oszacowania lokalizacji. W przypadku Roads API ten komunikat oznacza, że nie udało się dopasować danych wejściowych do dróg. Jest to żądanie podlegające opłacie, które spowoduje wykorzystanie limitu. |
| UNKNOWN_ERROR | 5xx | Błąd serwera wskazujący, że nie można przetworzyć żądania: błąd wewnętrzny, przeciążenie usługi, niedostępność, przekroczenie limitu czasu i inne. |
1
Aby poprawić 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 – status,
2) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded,
3) z klasy kodu odpowiedzi HTTP 2xx do 5xx w przypadku stanu interfejsu API Map Google: UNKNOWN_ERROR.
W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie.
Sprawdź, czy wzrost liczby 4xx lub 5xx we wskaźnikach Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorerze, który kod odpowiedzi wzrasta (dowiedz się więcej o korzystaniu z Cloud Monitoring w przypadku Google Maps Platform).
Więcej informacji o kodach stanu i komunikatach o błędach znajdziesz w dokumentacji odpowiedzi interfejsu API, który Cię interesuje (np. odpowiedzi geokodowania lub odpowiedzi dotyczące wskazówek dojazdu).
Parametr atrybucji wykorzystania Google Maps Platform
Google Maps Platform udostępnia wiele rodzajów przykładowego kodu, który pomoże Ci szybko rozpocząć pracę. Możesz na przykład użyć Szybkiego kreatora w konsoli Cloud, postępować zgodnie z przewodnikami po implementacji rozwiązań branżowych i uczyć się z ćwiczeń programistycznych.
Aby dowiedzieć się, jak użytkownicy korzystają z naszych rozwiązań i jak możemy je ulepszyć, Google dołącza parametr internal_usage_attribution_ids do wywołań interfejsu API, aby zbierać informacje o użyciu przykładowego kodu:
- Parametr
internal_usage_attribution_idsmoże być domyślnie uwzględniony w przykładowym kodzie rozwiązania. - Parametr zwraca do Google statystyki dotyczące wdrażania rozwiązania, aby poprawić jego jakość w przyszłych iteracjach.
- Możesz zrezygnować z tej opcji, usuwając parametr
internal_usage_attribution_idsi jego wartość z przykładowego kodu. - Nie ma wymogu zachowania parametru. Usunięcie parametru nie wpłynie na wydajność.
- Parametr jest używany tylko do raportowania wykorzystania przykładowego kodu.
- Parametr jest niezależny od statystyk i raportów dotyczących interfejsu API. Oznacza to, że usunięcie parametru z przykładowego kodu rozwiązania nie wyłącza wewnętrznego raportowania interfejsu Maps JavaScript API.
Raporty dotyczące wykorzystania limitów
Limity określają liczbę żądań, które projekt może wysył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 są wliczane do limitu.
Wykorzystanie limitu jest wyświetlane na wykresach na stronie Limity w konsoli Cloud i może być grupowane według żądań na minutę. Bieżące limity wybranych interfejsów API są wyświetlane w tabelach pod wykresami wykorzystania limitów.
Aby uzyskać wartość limitu na minutę dla dowolnej usługi GMP API, użyj tego kalkulatora.
Strona Limitów Map Google
Strona Limity w Mapach Google pokazuje limity i wykorzystanie dla wybranego interfejsu API.
Wykres wykorzystania limitu w konsoli Google Cloud pokazuje łączny ruch związany z kluczami interfejsu API i identyfikatorami klienta. Ruch związany z identyfikatorem klienta jest też dostępny na wykresie danych w konsoli Cloud.
Na stronie wyświetlane są tylko żądania, które wykorzystują limit: żądania zakończone powodzeniem (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) i żądania, które powodują błędy serwera (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nieprawidłowa wartość parametru) i 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.
W przypadku większości interfejsów API Google Maps Platform (Maps Static API, Street View Static API, Geocoding API, Directions API (starsza wersja), Places API, Time Zone API, Geolocation API i Elevation API) jednostką limitu jest żądanie, ale są pewne wyjątki:
- W przypadku interfejsu Distance Matrix API (starsza wersja) jednostką limitu jest element, który jest parą miejsce początkowe–miejsce docelowe.
- W przypadku interfejsu Maps JavaScript API jednostką limitu jest wczytanie mapy.
- W przypadku pakietów Maps SDK na Androida i Maps SDK na iOS jednostką limitu jest żądanie Street View lub wczytanie panoramy. Wczytywanie map jest bezpłatne i nie zużywa limitu.
Aby uzyskać dostęp do strony Limitó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 zawiera jednostki 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 |
| Map Tiles API | 1 prośba |
| 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 miejsce początkowe – miejsce docelowe) |
| Directions API (starsza wersja) | 1 prośba |
| Distance Matrix API (starsza wersja) | 1 element (para miejsce początkowe – miejsce docelowe) |
| Roads API | 1 prośba |
| Route Optimization API | 1 prośba |
| Pakiet SDK do nawigacji na Androida | 1 miejsce docelowe |
| Pakiet SDK do nawigacji na iOS | 1 miejsce docelowe |
| Miejsca | |
| Places API | 1 prośba |
| Places Aggregate 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 |
| Narzędzia agenta Maps Experience | 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 |
| Weather API | 1 prośba |
Raporty rozliczeniowe
Wyświetlanie raportu rozliczeniowego
Raporty rozliczeniowe dotyczące korzystania 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ę Wybór projektu w konsoli Cloud:
- Wybierz projekt.
- Kliknij przycisk menu , a następnie wybierz Płatności.
- Jeśli masz kilka kont rozliczeniowych, kliknij 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 dla połączonego konta rozliczeniowego.
Jak odczytywać wykres raportu rozliczeniowego
Raporty rozliczeniowe przedstawiają koszty w czasie w postaci skumulowanego wykresu liniowego. Widok domyślny wyświetla koszty związane z codziennym użytkowaniem w bieżącym miesiącu pogrupowane według projektu (dla wszystkich produktów), w tym wszelkie zastosowane środki związane z użytkowaniem, a także łączny prognozowany koszt dla całego bieżącego miesiąca. Każda linia na wykresie (i wiersz w tabeli podsumowania) odpowiada projektowi, który jest uszeregowany od największego do najmniejszego pod względem kosztów. Więcej informacji o interpretowaniu wykresu raportu rozliczeniowego
Wskazówka: przeanalizuj wykorzystanie i koszty według kodów SKU
Aby dokładniej zrozumieć szczegóły modelu płatności według wykorzystania i jego wpływ na implementację, sprawdź wykorzystanie i koszty według SKU.
Aby zmienić widok raportu i wyświetlić elementy zamówienia według SKU:
- W panelu po prawej stronie wykresu rozwiń filtr Grupuj według.
- Wybierz SKU.
Inne dostępne filtry raportu rozliczeniowego to Zakres czasu, Projekty, Usługi, Kody SKU i Lokalizacje, które umożliwiają filtrowanie według miejsca, z którego są obsługiwane żądania do interfejsu API.
Aby oprócz usługi skategoryzować źródło wykorzystania, pogrupuj raporty rozliczeniowe według jednej z podanych wartości. Trzy klucze związane z interfejsami API Google Maps Platform to goog-maps-api-key-suffix (ostatnie 4 znaki klucza interfejsu API), goog-maps-platform-type (platforma: Android, iOS, JavaScript lub usługa internetowa) i goog-maps-channel (ustawiona wartość liczbowa kanału z zapytania do interfejsu API). Więcej informacji o filtrowaniu i grupowaniu
Aby wykluczyć z widoku wykresu środki związane z wykorzystaniem, odznacz pole wyboru Uwzględnij środki w kosztach w panelu po prawej stronie.
Monitorowanie i ograniczanie zużycia
Aby ułatwić sobie planowanie budżetu i kontrolowanie kosztów, możesz:
-
alert, aby śledzić, jak wydatki zbliżają się do określonej kwoty. Budżet nie ogranicza wykorzystania interfejsu API, tylko ostrzega, gdy kwota wydatków zbliża się do określonej kwoty.
Ograniczanie dziennego wykorzystania interfejsu API
użycie, aby zarządzać kosztami korzystania z płatnych interfejsów API. Ustawiając limity żądań dziennie, możesz ograniczyć wydatki. Użyj równania, aby określić limit dzienny w zależności od tego, ile chcesz wydać. Na przykład: (miesięczne wydatki / 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 numerycznych, musisz dodać parametr „channel” do żądań do interfejsu API. Jedynymi akceptowanymi wartościami kanału są 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>
Możesz monitorować wykorzystanie kanałów bezpośrednio w raporcie rozliczeniowym. Użycie kanału znajduje się w sekcji Etykiety jako klucz goog-maps-channel.
Aby filtrować raport rozliczeniowy według SKU i kanału:
- Użyj filtra SKU Grupuj według.
- Kliknij strzałkę Etykiety.
- W menu Klucz wybierz goog-maps-channel.
- Z menu Wartość wybierz kanały liczbowe, które chcesz filtrować.
Pogrupuj według klucza etykiety goog-maps-channel, aby zobaczyć koszty generowane przez każdy kanał.
Po wdrożeniu danych o korzystaniu z kanału w żądaniach może minąć trochę czasu (do 24 godzin), zanim dane te pojawią się w raporcie rozliczeniowym.
Eksportowanie danych rozliczeniowych za pomocą BigQuery
Możesz też wyeksportować dane rozliczeniowe do BigQuery.
Użyj BigQuery Export, aby automatycznie eksportować w ciągu dnia szczegółowe dane rozliczeniowe usługi Google Cloud (takie jak wykorzystanie zasobów i szacowane koszty) do wskazanego przez Ciebie zbioru danych BigQuery. Możesz potem szczegółowo analizować te dane w BigQuery. Dzięki temu uzyskasz dodatkową warstwę szczegółowości, która pozwoli Ci lepiej zrozumieć źródło wykorzystania Google Maps Platform.
Jeśli chcesz zacząć korzystać z eksportu do BigQuery i zapytań o dane, możesz wypróbować przykładowe zapytanie poniżej. Przed uruchomieniem tego zapytania musisz:
- Włącz na swoim koncie płatności i eksportowanie danych rozliczeniowych do BigQuery.
- Format tabeli to PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, gdzie:
- PROJECT_ID to rzeczywisty identyfikator projektu (np. „my-project-123456”).
- DATASET_NAME to nazwa utworzonego zbioru danych (np. „SampleDataSet”).
- BILLING_ACCOUNT_ID to odniesienie do identyfikatora konta rozliczeniowego z prefiksem „gcp_billing_exportv1” i kreskami (-) zmienionymi na podkreślenia (_).
Na przykład identyfikator konta rozliczeniowego 123456-7890AB-CDEF01 zmieni się na
gcp_billing_export_v1_123456_789AB_CDEF01.
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
Przydatne materiały
Rozliczenia usługi Google Cloud:
- Tworzenie, modyfikowanie i zamykanie konta rozliczeniowego Cloud
- Modyfikowanie ustawień rozliczeń projektu
- Wyświetlanie raportów rozliczeniowych oraz trendów w zakresie kosztów
- Konfigurowanie budżetów i dotyczących ich alertów
- Ograniczanie wykorzystania interfejsu API
- Płatności w Google Maps Platform
- Przewodnik 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 i klasą kodu odpowiedzi HTTP w raporcie dotyczącym wykorzystania. Wskazuje też, czy odpowiednie żądanie pojawia się w raportach dotyczących wykorzystania, limitów i rozliczeń.
Raport dotyczący wykorzystania we wskaźnikach Google Maps Platform
zapewniają szczegółowość na poziomie HTTP response code class. Jeśli potrzebujesz bardziej szczegółowych informacji, zapoznaj się z artykułem Kody stanu odpowiedzi.
dostępne w monitorowaniu wykorzystania Google Maps Platform.
| Kody odpowiedzi dostępne w odpowiedziach interfejsu API Map Google | Dostępne w raporcie dotyczącym wykorzystania | 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, itd. |
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 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 – status,
2) z klasy kodu odpowiedzi HTTP 2xx do 4xx w przypadku stanów interfejsu API Map Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded,
3) z klasy kodu odpowiedzi HTTP 2xx do 5xx w przypadku stanu interfejsu API Map Google: UNKNOWN_ERROR.
W okresie przejściowym możesz zobaczyć oba kody odpowiedzi. Kody odpowiedzi zwracane w odpowiedziach interfejsu API Map Google nie ulegają zmianie.
Sprawdź, czy wzrost liczby 4xx lub 5xx we wskaźnikach Google Maps Platform jest związany z tą migracją. W tym celu sprawdź w Metrics Explorerze, który kod odpowiedzi wzrasta (dowiedz się więcej o korzystaniu z Cloud Monitoring w przypadku Google Maps Platform).
|
|||||