Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Maski pól

W przypadku informacji o miejscu (nowych), wyszukiwania w pobliżu (nowego) i wyszukiwania tekstowego (nowego) użyj nagłówka FieldMask w żądaniach do interfejsu API, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Następnie zostanie naliczona opłata za najwyższy kod SKU, który dotyczy Twojego żądania. Oznacza to, że jeśli wybierzesz pola w SKU Essentials i Pro, opłaty będą naliczane na podstawie SKU Pro.

Używanie maskowania pól to dobra praktyka projektowa, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Sesje autouzupełniania (nowe)

Sesja Autouzupełniania (nowego) obejmuje co najmniej 1 żądanie Autouzupełniania (nowego) oraz żądanie informacji o miejscu (nowe) lub żądanie Weryfikacji adresów. Ten sam token sesji jest przekazywany do żądania autouzupełniania (nowego) i do kolejnego żądania informacji o miejscu (nowego) lub żądania Weryfikacji adresów.

Sesja rozpoczyna się od pierwszego żądania Autouzupełniania (nowego). Gdy użytkownik wybierze jedną z sugestii autouzupełniania (nowego), wysyłane jest żądanie informacji o miejscu (nowe) lub żądanie weryfikacji adresu. Jeśli sesja zostanie porzucona, co oznacza, że nie zostanie wysłane żadne żądanie informacji o miejscu (nowe) ani żądanie Weryfikacji adresów, żądania autouzupełniania (nowe) są rozliczane tak, jakby nie podano tokena sesji.

Gdy użytkownik wybierze miejsce (co oznacza, że zostanie wysłane żądanie informacji o miejscu (nowe) lub żądanie Weryfikacji adresów), musisz rozpocząć nową sesję, używając nowego tokena sesji.

Token sesji jest ważny przez jedną sesję i nie można go użyć w więcej niż jednej sesji. Jeśli użyjesz ponownie tokenu sesji, sesja zostanie uznana za nieprawidłową, a żądania zostaną rozliczone tak, jakby nie podano tokenu sesji.

Szczegóły kodów SKU i ceny Places API

W tabeli poniżej znajdziesz szczegóły dotyczące kodów SKU i cen Places API w modelu płatności według wykorzystania.

KategoriaSzczegóły kodu SKU Places API (nowość)Ceny SKU
Essentials SKU: żądania autouzupełniania Globalny cennik
Cennik w Indiach
Essentials SKU: wykorzystanie sesji autouzupełniania Globalny cennik
Cennik w Indiach
Essentials SKU: Szczegóły miejsca – podstawowe (tylko identyfikatory) Globalny cennik
Cennik w Indiach
Essentials SKU: Place Details Essentials Globalny cennik
Cennik w Indiach
Essentials SKU: Wyszukaj tekst – podstawowe zasady (tylko identyfikatory) Globalny cennik
Cennik w Indiach
Pro SKU: Wyszukiwanie w pobliżu (Pro) Globalny cennik
Cennik w Indiach
Pro SKU: Informacje o miejscu Pro Globalny cennik
Cennik w Indiach
Pro SKU: Text Search Pro Globalny cennik
Cennik w Indiach
Enterprise SKU: Wyszukiwanie w pobliżu Enterprise Globalny cennik
Cennik w Indiach
Enterprise SKU: Wyszukiwanie w pobliżu Enterprise + Atmosphere Globalny cennik
Cennik w Indiach
Enterprise SKU: Informacje o miejscu Enterprise Globalny cennik
Cennik w Indiach
Enterprise SKU: Place Details Enterprise + Atmosphere Globalny cennik
Cennik w Indiach
Enterprise SKU: Text Search Enterprise Globalny cennik
Cennik w Indiach
Enterprise SKU: Text Search Enterprise + Atmosphere Globalny cennik
Cennik w Indiach
Enterprise SKU: Place Details Photos Globalny cennik
Cennik w Indiach
KategoriaSzczegóły kodu SKU Places API (starsza wersja)Ceny SKU
Essentials SKU: Autocomplete – Per Request Globalny cennik
Cennik w Indiach
Essentials SKU: Autouzupełnianie (uwzględnione w informacjach o miejscu) – na sesję Globalny cennik
Cennik w Indiach
Essentials

SKU: dane podstawowe

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Essentials SKU: Find Place – ID only Globalny cennik
Cennik w Indiach
Essentials SKU: Place Details Essentials - ID Refresh Globalny cennik
Cennik w Indiach
Essentials SKU: autouzupełnianie zapytania – z uwzględnieniem żądań Globalny cennik
Cennik w Indiach
Pro SKU: Autocomplete without Place Details - Per Session Globalny cennik
Cennik w Indiach
Pro

SKU: Find Place

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: Miejsca – Wyszukiwanie w pobliżu

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: Miejsca – Wyszukaj tekst

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: informacje o miejscu

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Enterprise

SKU: dane o atmosferze

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Enterprise

SKU: dane kontaktowe

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Enterprise SKU: Place Photos Globalny cennik
Cennik w Indiach

Limity wykorzystania

Aby sprawdzić limity i limity wykorzystania oraz nimi zarządzać, zapoznaj się z artykułem Limity i alerty dotyczące limitów.

  • Places API (nowy): limit liczby żądań na minutę jest określany na metodę interfejsu API na projekt. Innymi słowy, każda metoda interfejsu API ma osobny limit.

  • Places API (starsza wersja): limit żądań na minutę jest obliczany jako suma żądań po stronie klienta i po stronie serwera dla wszystkich aplikacji korzystających z danych logowania tego samego projektu.

Ekonomiczne strategie dotyczące Places API

W tej sekcji znajdziesz sposoby na optymalizację wykorzystania i obniżenie kosztów związanych z Places API.

Używanie masek pól

Używanie maskowania pól gwarantuje, że nie będziesz prosić o niepotrzebne dane, co pomaga zmniejszyć opóźnienia i opłaty.

W przypadku żądań dotyczących informacji o miejscu (nowych), wyszukiwania w pobliżu (nowego) i wyszukiwania tekstowego (nowego) użyj maski pola, aby określić listę pól, które mają zostać zwrócone w odpowiedzi.

Opłata zostanie naliczona według najwyższej stawki SKU, która ma zastosowanie do Twojego żądania. Jeśli na przykład wybierzesz pola z kodów SKU Essentials i Pro, opłaty będą naliczane na podstawie kodu SKU Pro.

Korzystanie z cen za sesję w przypadku informacji o miejscu (nowych)

Jeśli Twoje aplikacje mają miesięczną liczbę wywołań na poziomie 100 001–500 000 lub większą albo jeśli użytkownicy wysyłają więcej niż 12 żądań autouzupełniania na sesję, Google zaleca korzystanie z sesji z autouzupełnianiem (nowym). Sesje pomagają uprościć ceny i zapewniają spójny model cenowy do stosowania z Autouzupełnianiem (nowym).

Więcej informacji znajdziesz w artykule Autouzupełnianie (nowe) i ceny sesji.

Dostosuj limit

Limity określają maksymalną liczbę żądań dozwolonych w przypadku konkretnego interfejsu API lub usługi w danym przedziale czasu. Gdy liczba żądań w projekcie osiągnie limit, usługa przestanie odpowiadać na żądania.

Aby zmienić wartość limitu dla interfejsu API:

  1. W konsoli Cloud otwórz Google Maps Platform > Limity.
  2. Wybierz interfejs API, którego limit chcesz zmienić.
  3. Odszukaj wartość limitu, którą chcesz zmienić, i zaznacz ją za pomocą pola wyboru.
  4. Kliknij Edytuj, wpisz nową wartość limitu i kliknij Prześlij prośbę.

Wyświetlanie próśb o zwiększenie limitu

Aby wyświetlić wszystkie prośby o zwiększenie limitu, w tym prośby z przeszłości i oczekujące, wykonaj te czynności:

  1. W konsoli Cloud otwórz Google Maps Platform > Limity.
  2. Wybierz interfejs API, dla którego chcesz wyświetlić prośbę o zwiększenie limitu.
  3. Kliknij Prośby o zwiększenie.

Ograniczenia wynikające z Warunków korzystania z usługi

Więcej informacji o warunkach korzystania znajdziesz w zasadach dotyczących Places API i w sekcji poświęconej ograniczeniom licencji w Warunkach korzystania z Google Maps Platform.