Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Informacje o maskach pól

W przypadku interfejsów Informacje o miejscu (New), Wyszukiwanie w pobliżu (New) i Wyszukaj tekst (New) użyj nagłówka FieldMask w żądaniach do interfejsu API, aby określić listę pól, które mają być zwracane w odpowiedzi. Następnie obciążymy Cię opłatą za najwyższy kod SKU odpowiedni dla Twojego żądania. Oznacza to, że jeśli wybierzesz pola w przypadku SKU Essentials i Pro, opłata zostanie naliczona na podstawie SKU Pro.

Używanie maskowania pól to dobra praktyka projektowania, która pozwala uniknąć wysyłania żądań niepotrzebnych danych, co z kolei pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Informacje o sesjach autouzupełniania (nowa wersja)

Sesja Autouzupełnianie (nowe) obejmuje co najmniej 1 żądanie Autouzupełnianie (nowe) oraz żądanie informacji o miejscu (nowe) lub żądanie Weryfikacja adresu. Ten sam token sesji jest przekazywany do żądania Autouzupełnianie (nowe) i do kolejnego żądania informacje o miejscu (nowe) lub żądania Weryfikacja 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 żądanie informacji o miejscu (nowe) ani żądanie weryfikacji adresu, żądania autouzupełniania (nowe) będą naliczane tak, jakby nie podano tokena sesji.

Gdy użytkownik wybierze miejsce (czyli zostanie wysłana prośba o informacje o miejscu (nowa) lub prośba o Weryfikację adresów), musisz rozpocząć nową sesję, używając nowego tokena sesji.

Token sesji jest ważny tylko w przypadku jednej sesji i nie można go użyć w więcej niż jednej sesji. Jeśli ponownie użyjesz tokena sesji, sesja zostanie uznana za nieprawidłową, a żądania zostaną obciążone tak, jakby token sesji nie został podany.

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

W tabeli poniżej znajdziesz szczegóły jednostek SKU w modelu płatności według wykorzystania i ceny interfejsu Places API.

KategoriaSzczegóły kodów SKU interfejsu 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: Place Details Essentials (IDs Only) Globalny cennik
Cennik w Indiach
Essentials SKU: Place Details Essentials Globalny cennik
Cennik w Indiach
Essentials SKU: Text Search Essentials (IDs Only) Globalny cennik
Cennik w Indiach
Pro SKU: Wyszukiwanie w pobliżu (Pro) Globalny cennik
Cennik w Indiach
Pro SKU: Place Details Pro Globalny cennik
Cennik w Indiach
Pro SKU: Text Search Pro Globalny cennik
Cennik w Indiach
Enterprise SKU: Nearby Search Enterprise Globalny cennik
Cennik w Indiach
Enterprise SKU: Nearby Search Enterprise + Atmosphere Globalny cennik
Cennik w Indiach
Enterprise SKU: Place Details 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 interfejsu Places API (starsza wersja)Ceny SKU
Essentials SKU: Autocomplete – Per Request Globalny cennik
Cennik w Indiach
Essentials SKU: Autocomplete (included with Place Details) - Per Session 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: Query Autocomplete - Per Request Globalny cennik
Cennik w Indiach
Pro SKU: Autouzupełnianie bez informacji o miejscu – na sesję Globalny cennik
Cennik w Indiach
Pro

SKU: Find Place

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: Places - Nearby Search

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: Places - Text Search

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Pro

SKU: Places Details

Dodatkowe opłaty:

Globalny cennik
Cennik w Indiach
Enterprise

SKU: dane atmosferyczne

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

Informacje o sprawdzaniu limitów i limitów wykorzystania oraz zarządzaniu nimi znajdziesz w artykule 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 optymalizacji wykorzystania interfejsu Places API i zmniejszenia związanych z nim kosztów.

Używanie masek pól

Używanie maskowania pól zapewnia, że nie prosisz 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.

Następnie obciążymy Cię opłatą za najwyższy kod SKU odpowiedni dla Twojej prośby. 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 cennika sesji w przypadku informacji o miejscu (nowość)

Jeśli Twoje aplikacje mają miesięczną liczbę wywołań wynoszącą co najmniej 100 001–500 000 lub jeśli użytkownicy wysyłają więcej niż 12 żądań autouzupełniania na sesję, Google zaleca korzystanie z sesji z autouzupełnianiem (nowych). Sesje upraszczają ceny i zapewniają spójny model cenowy do użycia z funkcją Autouzupełnianie (nowa).

Więcej informacji znajdziesz w artykule Autouzupełnianie (nowe) i sesja – cennik.

Dostosuj limit

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

Aby zmodyfikować wartość limitu interfejsu API:

  1. W konsoli Cloud otwórz Google Maps Platform > Limity.
  2. Wybierz interfejs API, dla którego chcesz zmodyfikować limit.
  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 te z przeszłości i oczekujące:

  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 Zwiększ liczbę żądań.

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

Informacje o warunkach korzystania znajdziesz w zasadach dotyczących interfejsu Places API oraz w sekcji Ograniczenia licencji Warunków korzystania z usługi Google Maps Platform.