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 obciążymy Cię opłatą 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 adresu, żądania Autouzupełniania (nowość) będą 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 w modelu płatności według wykorzystania.

KategoriaSzczegóły kodu SKU Places API (nowość)Ceny kodów SKU
Essentials SKU: żądania autouzupełniania Globalna lista cen
Lista cen w Indiach
Essentials SKU: wykorzystanie sesji autouzupełniania Globalna lista cen
Lista cen w Indiach
Essentials SKU: informacje o miejscu – Essentials (tylko identyfikatory) Globalna lista cen
Lista cen w Indiach
Essentials SKU: informacje o miejscu – Essentials Globalna lista cen
Lista cen w Indiach
Essentials SKU: wyszukiwanie tekstowe – podstawowe zasady dotyczące wyszukiwarki (tylko identyfikatory) Globalna lista cen
Lista cen w Indiach
Pro SKU: wyszukiwanie w pobliżu – Pro Globalna lista cen
Lista cen w Indiach
Pro SKU: informacje o miejscu – Pro Globalna lista cen
Lista cen w Indiach
Pro SKU: wyszukiwanie tekstowe – Pro Globalna lista cen
Lista cen w Indiach
Enterprise SKU: wyszukiwanie w pobliżu – Enterprise Globalna lista cen
Lista cen w Indiach
Enterprise SKU: wyszukiwanie w pobliżu – Enterprise + atmosfera Globalna lista cen
Lista cen w Indiach
Enterprise SKU: informacje o miejscu – Enterprise Globalna lista cen
Lista cen w Indiach
Enterprise SKU: informacje o miejscu – Enterprise + atmosfera Globalna lista cen
Lista cen w Indiach
Enterprise SKU: wyszukiwanie tekstowe – Enterprise Globalna lista cen
Lista cen w Indiach
Enterprise SKU: wyszukiwanie tekstowe – Enterprise + atmosfera Globalna lista cen
Lista cen w Indiach
Enterprise SKU: zdjęcia informacji o miejscu Globalna lista cen
Lista cen w Indiach
KategoriaSzczegóły kodu SKU Places API (starsza wersja)Ceny kodów SKU
Essentials SKU: autouzupełnianie – na żądanie Globalna lista cen
Lista cen w Indiach
Essentials SKU: autouzupełnianie (wliczone w informacje o miejscu) – na sesję Globalna lista cen
Lista cen w Indiach
Essentials

SKU: dane podstawowe

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Essentials SKU: znajdź miejsce – tylko identyfikator Globalna lista cen
Lista cen w Indiach
Essentials SKU: informacje o miejscu – Essentials – odświeżanie identyfikatora Globalna lista cen
Lista cen w Indiach
Essentials SKU: autouzupełnianie zapytań – na żądanie Globalna lista cen
Lista cen w Indiach
Pro SKU: autouzupełnianie bez informacji o miejscu – na sesję Globalna lista cen
Lista cen w Indiach
Pro

SKU: znajdź miejsce

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Pro

SKU: miejsca – wyszukiwanie w pobliżu

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Pro

SKU: miejsca – wyszukiwanie tekstowe

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Pro

SKU: informacje o miejscach

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Enterprise

SKU: dane o atmosferze

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Enterprise

SKU: dane kontaktowe

Dodatkowe opłaty:

Globalna lista cen
Lista cen w Indiach
Enterprise SKU: Place Photos Globalna lista cen
Lista cen 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 obciążymy Cię opłatą 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 korzystanie z sesji z Autouzupełnianiem (nowość). Sesje upraszczają ceny 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 zmodyfikować wartość limitu interfejsu API:

  1. W konsoli Cloud otwórz Google Maps Platform > Limity.
  2. Wybierz interfejs API, którego limit chcesz zmodyfikować.
  3. Znajdź 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, w przypadku 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

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.