Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Maski pól

W przypadku interfejsów informacje o miejscu (nowość), Wyszukiwanie w pobliżu (nowość) i Wyszukaj tekst (nowość) 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 naliczana jest opłata według najwyższego kodu SKU, który ma zastosowanie do Twojego żądania. Oznacza to, że jeśli wybierzesz pola w kodach SKU Essentials i Pro, opłata zostanie naliczona na podstawie kodu SKU Pro.

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

Sesje Autouzupełniania (nowość)

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

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

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

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

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

W tabeli poniżej znajdziesz szczegóły i ceny kodów SKU w interfejsie Places API.

KategoriaSzczegóły kodu SKU Places API (nowość)Ceny kodów SKU
Essentials SKU: żądania autouzupełniania Główny cennik
Cennik w Indiach
Essentials SKU: wykorzystanie sesji autouzupełniania Główny cennik
Cennik w Indiach
Essentials SKU: Informacje o miejscu Essentials (tylko identyfikatory) Główny cennik
Cennik w Indiach
Essentials SKU: Place Details Essentials Główny cennik
Cennik w Indiach
Essentials SKU: podstawowe zasady dotyczące wyszukiwarki (tylko identyfikatory) Główny cennik
Cennik w Indiach
Pro SKU: Nearby Search Pro Główny cennik
Cennik w Indiach
Pro SKU: Place Details Pro Główny cennik
Cennik w Indiach
Pro SKU: Text Search Pro Główny cennik
Cennik w Indiach
Enterprise SKU: Nearby Search Enterprise Główny cennik
Cennik w Indiach
Enterprise SKU: Nearby Search Enterprise + Atmosphere Główny cennik
Cennik w Indiach
Enterprise SKU: Place Details Enterprise Główny cennik
Cennik w Indiach
Enterprise SKU: Place Details Enterprise + Atmosphere Główny cennik
Cennik w Indiach
Enterprise SKU: Text Search Enterprise Główny cennik
Cennik w Indiach
Enterprise SKU: Text Search Enterprise + Atmosphere Główny cennik
Cennik w Indiach
Enterprise SKU: Place Details Photos Główny cennik
Cennik w Indiach
KategoriaSzczegóły kodu SKU Places API (starsza wersja)Ceny kodów SKU
Essentials SKU: Autouzupełnianie – na żądanie Główny cennik
Cennik w Indiach
Essentials SKU: Autouzupełnianie (wliczone w informacje o miejscu) – na sesję Główny cennik
Cennik w Indiach
Essentials

SKU: dane podstawowe

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Essentials SKU: Find Place – tylko identyfikator Główny cennik
Cennik w Indiach
Essentials SKU: informacje o miejscu Essentials – odświeżanie identyfikatora Główny cennik
Cennik w Indiach
Essentials SKU: Query Autocomplete – na żądanie Główny cennik
Cennik w Indiach
Pro SKU: Autouzupełnianie bez informacji o miejscu – na sesję Główny cennik
Cennik w Indiach
Pro

SKU: Find Place

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Pro

SKU: Miejsca – Wyszukiwanie w pobliżu

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Pro

SKU: Miejsca – Wyszukaj tekst

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Pro

SKU: Place Details

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Enterprise

SKU: dane o atmosferze

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Enterprise

SKU: dane kontaktowe

Dodatkowe opłaty:

Główny cennik
Cennik w Indiach
Enterprise SKU: Place Photos Główny cennik
Cennik w Indiach

Limity wykorzystania

Aby sprawdzić limity i nimi zarządzać, przeczytaj artykuł Limity i alerty o limitach.

  • Places API (nowość): limit liczby żądań na minutę dotyczy metody interfejsu API w projekcie. Innymi słowy, każda metoda interfejsu API ma osobny limit.

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

Opłacalne strategie korzystania z interfejsu 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 pozwala uniknąć żądania niepotrzebnych danych, co pomaga zmniejszyć opóźnienie i opłaty.

W przypadku żądań Place Details (nowość), Nearby Search (nowość) i Text Search (nowość) użyj maski pola, aby określić listę pól, które mają zostać zwrócone w odpowiedzi.

Następnie naliczana jest opłata według najwyższego kodu SKU, który ma zastosowanie do Twojego żądania. Jeśli na przykład wybierzesz pola z kodów SKU Essentials i Pro, opłata zostanie naliczona na podstawie kodu SKU Pro.

Używanie cen 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 używanie sesji z Autouzupełnianiem (nowość). Sesje upraszczają cennik i zapewniają spójny model cenowy do użycia z Autouzupełnianiem (nowość).

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

Dostosowywanie limitu

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

Aby zmienić wartość limitu 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 pole wyboru obok niej.
  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:

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

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

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