Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Płatności i ceny interfejsu Places API

Informacje o tym, jak Google oblicza opłaty i ceny, znajdziesz w cenniku Google Maps Platform lub cenniku Google Maps Platform – Indie.

Kody SKU produktów (Nowe)

Aby wyświetlić spis treści tej strony, kliknij ikonę informacje. W poniższych sekcjach znajdziesz szczegółowe informacje o każdym kodzie SKU:

Kategoria Określa, czy kod SKU należy do kategorii Essentials, Pro czy Enterprise.
Zdarzenie podlegające rozliczeniu Jakie zdarzenie jest naliczane w przypadku kodu SKU.
Aktywatory Jakie elementy kodu wywołują zdarzenia podlegające rozliczeniu.
Ceny Linki do tabeli cen dla grupy tego kodu SKU.

Informacje o maskach pól

W przypadku zapytań Szczegóły miejsca (Nowe), Wyszukiwanie w pobliżu (Nowe) i Wyszukiwanie tekstowe (Nowe) użyj nagłówka FieldMask w żądaniach interfejsu API, aby określić listę pól, które mają być zwracane w odpowiedzi. Następnie zostaniesz obciążony opłatą za najwyższy kod SKU odpowiedni dla Twojego żądania. Oznacza to, że jeśli wybierzesz pola zarówno w SKU Essentials, jak i SKU Pro, zostaniesz obciążony opłatą na podstawie SKU Pro.

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

Informacje o sesjach autouzupełniania (nowej wersji)

Sesja Autouzupełnianie (nowa) zawiera co najmniej 1 żądanie Autouzupełnianie (nowe) oraz żądanie Szczegóły miejsca (nowe) lub żądanie Weryfikacja adresu. Ten sam token sesji jest przekazywany do żądania Autouzupełnianie (nowe) oraz do kolejnych żądań Szczegóły miejsca (nowe) lub Weryfikacja adresu.

Sesja rozpoczyna się od pierwszego żądania Autouzupełnianie (Nowe). Gdy użytkownik wybierze jedną z sugestii autouzupełniania (nowej), wysyłane jest żądanie szczegółów miejsca docelowego (nowego) lub żądanie weryfikacji adresu. Jeśli sesja zostanie przerwana, co oznacza, że nie wysłano żądania Szczegóły miejsca (Nowe) ani żądania weryfikacji adresu, żądania autouzupełniania (Nowe) są obciążane tak, jakby nie podano tokena sesji.

Gdy użytkownik wybierze miejsce (czyli wyśle żądanie Szczegóły miejsca (Nowe) lub żądanie weryfikacji adresu), musisz rozpocząć nową sesję za pomocą nowego tokenu 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 tokena sesji, sesja zostanie uznana za nieprawidłową, a za żądania zostanie naliczona opłata, jakby token sesji nie został podany.

SKU: żądania autouzupełniania

Ta SKU obciąża kosztami żądania interfejsu Autocomplete API, które nie korzystają z sesji. Informacje o używaniu sesji do ograniczania liczby próśb o płatność w ramach pojedynczej sesji autouzupełniania znajdziesz w artykule Tokeny sesji lub SKU: korzystanie z sesji autouzupełniania.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory

Ten kod SKU jest uruchamiany w tych warunkach:

  • Twoje żądanie nie zawiera tokenu sesji.
  • Twoje żądanie zawiera token sesji, ale nie kończysz sesji.
  • Twoja prośba zawiera token sesji, ale kończysz sesję w określonych warunkach. Informacje o użyciu sesji autouzupełniania znajdziesz w artykule Tokeny sesji lub Użycie sesji autouzupełniania.
  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: wykorzystanie sesji autouzupełniania

Ta SKU jest naliczana za każde żądanie do interfejsu Autocomplete (New), które zawiera token sesji.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory

Ten identyfikator SKU jest uruchamiany, gdy wysyłasz żądanie do interfejsu Autocomplete (New) API, które zawiera token sesji.

Ten identyfikator SKU działa jako element opakowujący dla żądań autouzupełniania (nowego) SKU, który umożliwia ograniczenie liczby żądań, za które naliczane są opłaty podczas jednej sesji autouzupełniania. Informacje o używaniu sesji autouzupełniania znajdziesz w sekcji Tokeny sesji.

Więcej informacji znajdziesz w artykule Autouzupełnianie (nowa wersja) i cena sesji.

  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: podstawowe informacje o miejscach z interfejsu Places API (tylko identyfikatory)

Ten kod SKU jest naliczany za żądania dotyczące szczegółów miejsca, które zwracają tylko identyfikator miejsca.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory

Ten kod SKU jest uruchamiany, gdy żądasz tych pól:

Pola usługi internetowej

attributions
id
name*
photos

* Pole name zawiera nazwę zasobu miejsca w formie: places/PLACE_ID. Użyj displayName, aby wyświetlić nazwę tekstową miejsca.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: podstawowe informacje o miejscach w interfejsie Places API

Ten kod SKU obciąża za żądania do interfejsu Place Details API, które pobierają pola w tym kodzie.
  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory

Ten SKU jest uruchamiany, gdy żądasz tych pól lokalizacji:

Pola usługi internetowej

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Szczegóły miejsca w interfejsie Places API Pro

Ten kod SKU jest rozliczany za pola określone w żądaniu Szczegóły miejsca Pro.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Ta cena SKU jest aktywowana, gdy tylko wysyłasz te pola lub pola z niższą stawką:

Pola usługi internetowej

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* Pole googleMapsLinks znajduje się w fazie podglądu przed GA i nie jest płatne, co oznacza, że za korzystanie z niego w trakcie podglądu nie jest naliczana opłata.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Enterprise – szczegóły miejsca w Places API

Ta SKU jest naliczana za żądanie dotyczące Miejsc, które zawiera pola Enterprise.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Ta SKU jest uruchamiany, gdy żądasz tych pól:

Pola usługi internetowej

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

Jeśli zakończysz sesję autouzupełniania wywołaniem szczegółów miejsca, które prosi o dowolne polewersji SKU: Szczegóły miejsca – Essentials, Pro, Enterprise lub Enterprise + Atmosphere, to wywołanie zostanie naliczone zgodnie z wersją SKU: Szczegóły miejsca – Enterprise + Atmosphere. Więcej informacji znajdziesz w artykule SKU: wykorzystanie sesji autouzupełniania.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Szczegóły miejsca w usłudze Places API Enterprise + Atmosphere

Ten kod SKU jest naliczany za wywołania interfejsu Place Details API, które wymagają podania określonych pól dotyczących atmosfery.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory

Ten kod SKU jest uruchamiany, gdy żądasz tych pól:

  • Usługa internetowa:
    allowsDogs
    curbsidePickup
    delivery
    dineIn
    editorialSummary
    evChargeOptions
    fuelOptions
    goodForChildren
    goodForGroups
    goodForWatchingSports
    liveMusic
    menuForChildren
    parkingOptions
    paymentOptions
    outdoorSeating
    reservable
    restroom
    reviews
    routingSummaries*
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine
    takeout

    * Tylko w przypadku wyszukiwania tekstowego i wyszukiwania w pobliżu

Jeśli sesja autouzupełniania zostanie zakończona wywołaniem szczegółów miejsca, które prosi o dowolne pole z SKU: Szczegóły miejsca Essentials, Pro, Enterprise lub Enterprise + Atmosphere, wywołanie zostanie naliczone zgodnie z SKU: Szczegóły miejsca Enterprise + Atmosphere. Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie – wykorzystanie sesji.

  Przykłady rozliczeń za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Places API Nearby Search Pro

Ta cena SKU jest naliczana za pola określone w żądaniu wyszukiwania w pobliżu Pro.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Ta cena SKU jest aktywowana, gdy tylko wysyłasz te pola lub pola z niższą stawką:

Pola usługi internetowej

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* Pole places.googleMapsLinks znajduje się w fazie podglądu przed udostępnieniem wersji GA. Za korzystanie z niego w trakcie podglądu nie są naliczane opłaty, co oznacza, że za korzystanie z niego nie trzeba płacić.

** Pole places.name zawiera nazwę zasobu miejsca w formie: places/PLACE_ID. Użyj places.displayName, aby wyświetlić nazwę tekstową miejsca.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Places API Enterprise Nearby Search

Ten kod SKU jest naliczany za żądania wyszukiwania w pobliżu, które zawierają dowolne pola Enterprise.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Reguły

Ten kod SKU jest uruchamiany, gdy żądasz tych pól:

Pola usługi internetowej

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Places API Nearby Search Enterprise + Atmosphere

Ten kod SKU jest naliczany za żądania wyszukiwania w pobliżu, które zawierają określone pola dotyczące atmosfery.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory

Ten kod SKU jest uruchamiany, gdy żądasz tych pól:

  • Usługa internetowa:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Tylko w przypadku wyszukiwania tekstowego i wyszukiwania w pobliżu

  Przykłady rozliczeń za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Podstawowe funkcje wyszukiwania tekstowego w usłudze Places API (tylko identyfikatory)

Ta cena SKU jest naliczana za żądania do interfejsu Text Search API, które zwracają tylko identyfikatory.
  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory

Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Pola usługi internetowej

places.attributions
places.id
places.name*
nextPageToken

* Pole places.name zawiera nazwę zasobu miejsca w formie: places/PLACE_ID. Użyj places.displayName, aby wyświetlić nazwę tekstową miejsca.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Places API Text Search Pro

Ta jednostka SKU to jednostka SKU danych, która obciąża kosztami pola określone w żądaniu wyszukiwania tekstu Pro.
  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Ta cena SKU jest aktywowana, gdy tylko przesyłasz te pola lub pola o niższej stawce:

Pola usługi internetowej

places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* Pole places.googleMapsLinks znajduje się w fazie wstępnej przed GA i nie jest płatne, co oznacza, że za korzystanie z niego w fazie wstępnej nie są naliczane opłaty.

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Places API Text Search Enterprise

Ten kod SKU jest naliczany za żądania wyszukiwania tekstowego, które zawierają dowolne pola Enterprise.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Ten SKU jest uruchamiany, gdy żądasz tych pól:

Pola usługi internetowej

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Places API Text Search Enterprise + Atmosphere

Ten SKU jest naliczany za prośby o wyszukiwanie tekstowe, które zawierają dowolne pola dotyczące atmosfery.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Ta cena SKU jest aktywowana, gdy żądasz tych pól:
  • Usługa internetowa:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Tylko w przypadku wyszukiwania tekstowego i wyszukiwania w pobliżu

  Przykłady rozliczeń za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: zdjęcia informacji o miejscu

Ten kod SKU jest rozliczany za żądania dotyczące zdjęć w Szczegółach miejsca.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Rozliczenia są uruchamiane, gdy wysyłasz żądanie zdjęcia z interfejsu API Szczegóły miejsca.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

Starsze kody SKU produktów w usłudze Places

Informacje o sesjach autouzupełniania

Sesja autouzupełniania obejmuje niektóre żądania autouzupełniania (aby pobrać sugestie dotyczące miejsca, gdy użytkownik je wpisze) oraz maksymalnie 1 żądanie szczegółów miejsca (aby pobrać szczegóły wybranego przez użytkownika miejsca). Ten sam token sesji jest przekazywany do funkcji autouzupełniania i kolejnych żądań szczegółów miejsca. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (co zwykle następuje, gdy użytkownik zacznie pisać). Gdy użytkownik wybierze jedną z sugestii autouzupełniania, wywoływana jest metoda PlacesDetails. Jeśli użytkownik nie wybierze sugestii, nie zostanie wywołana usługa Places Details.

Gdy użytkownik wybierze miejsce (czyli po wywołaniu metody PlacesDetails), musisz rozpocząć nową sesję za pomocą nowego tokena sesji.

Sesje autouzupełniania można generować za pomocą tych interfejsów API:

Token sesji jest przeznaczony do jednej sesji użytkownika i nie powinien być używany w przypadku więcej niż 1 sesji użytkownika. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a zapytania zostaną obciążone opłatą tak, jakby nie podano tokena sesji.

Żądania autouzupełniania i żądania dotyczące szczegółów miejsc korzystające z sesji są rozliczane na podstawie innych SKU.

Informacje o kodach SKU danych o miejscach

Te 3 poziomy usługi Places Data to: Basic Data (podstawowe dane), Contact Data (dane kontaktowe) i Atmosphere Data (dane o atmosferze).

W przypadku co najmniej 1 poziomu usług danych:

  • Android: każda prośba do fetchPlace() lub findCurrentPlace()
  • iOS: każde wywołanie funkcji fetchPlaceFromPlaceID: lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Usługa internetowa: każda prośba do Places w zależności od pól określonych w prośbie

Za kody SKU danych zawsze pobierana jest opłata oprócz opłaty za kod SKU podstawowy za żądanie, które je wywołało. Na przykład żądanie Szczegóły miejsca, które zawiera pola danych podstawowych, będzie obciążone opłatą zarówno w ramach SKU danych podstawowych, jak i SKU Szczegóły miejsca.

W przypadku usługi internetowej te żądania interfejsu Places API umożliwiają określenie pól danych, które mają zostać zwrócone:

W przypadku usługi internetowej wywołania interfejsów API Places NIE obsługują podawania zwracanych pól. Te wywołania zawsze zwracają wszystkie dane Places, obciążając 3 poziomy usług danych Places, oprócz opłat za każde żądanie interfejsu API:

SKU: dane podstawowe

Ten kod SKU to kod SKU danych, który obciąża za pola Podstawowe dane w prośbach o szczegóły miejsca lub znajdowanie miejsca. Ten kod SKU jest obciążany dodatkowo do kodu SKU podstawowego w przypadku żądania, które go wywołało.

Pola w kategorii Podstawowe są uwzględnione w kosztach podstawowych żądania dotyczącego usługi Places i nie powodują dodatkowych opłat.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory SKU Dane podstawowe jest aktywowane, gdy żądasz któregoś z tych pól:

Pola w pakiecie SDK na Androida

Place.Field.ACCESSIBILITY_OPTIONS*
   * Użyj zamiast Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (obsługiwane tylko w wersji 3.0)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Użyj zamiast Place.Field.NAME (obsługiwane tylko w wersji 3.0)
Place.Field.FORMATTED_ADDRESS*
   * Użyj zamiast Place.Field.ADDRESS (obsługiwane tylko w wersji 3.0)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Użyj zamiast Place.Field.ICON_URL (obsługiwane tylko w wersji 3.0)
Place.Field.ID
Place.Field.LOCATION*
   * Użyj zamiast Place.Field.LAT_LNG (obsługiwane tylko w wersji 3.0)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Formularze na iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Pola usługi internetowej

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: dane kontaktowe

Ten kod SKU to kod SKU danych, który obciąża za pola Dane kontaktowe w ramach żądania informacji o miejscu lub żądania Znajdź miejsce. Ten kod SKU jest naliczany dodatkowo do kodu SKU podstawowego w przypadku żądania, które je wywołało.

Za pomocą parametru fields w żądaniu dotyczącego szczegółów miejsca lub usługi Znajdź miejsce w przypadku usług internetowych albo tablicy wartości Place.Field w przypadku urządzeń z Androidem lub iOS możesz ograniczyć odpowiedź tylko do tych pól. Pola w kategorii Kontakt powodują dodatkową opłatę.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory SKU Dane kontaktowe jest uruchamiany, gdy zostanie przesłane żądanie dotyczące któregoś z tych pól:

Pola w pakiecie SDK na Androida

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
Place.Field.PHONE_NUMBERPlace.Field.INTERNATIONAL_PHONE_NUMBER* Użyj zamiast Place.Field.PHONE_NUMBER (wycofane).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Pola w pakiecie SDK na iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Pola usługi internetowej

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Rozliczenia za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: dane dotyczące atmosfery

Ten kod SKU jest naliczany za żądania do interfejsu Atmosphere Data API, które określają pola w tym kodzie.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory Fakturowanie jest uruchamiane, gdy poprosisz o wysłanie dowolnego z tych pól:
  Przykłady rozliczeń za maski pól

Twoje żądanie jest rozliczane na podstawie pól podanych w masce. Na przykład:

  • Jeśli maska pól zawiera tylko pola z tego SKU: prośba jest rozliczana według stawki dla tego SKU.
  • Jeśli maska pól zawiera pola z innych kodów SKU: żądanie jest rozliczane według najwyższej stawki SKU dla żądanych pól. Jeśli na przykład uwzględnisz pola zarówno z poziomu SKU Essentials, jak i z poziomu SKU Enterprise, żądanie zostanie rozliczone według stawki SKU Enterprise.
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: autouzupełnianie – na żądanie

Ta cena SKU dotyczy żądań, które nie zawierają tokenu sesji.

Jeśli wysyłasz żądanie z nieprawidłowej sesji autouzupełniania (np. sesji, która używa tokena sesji ponownie), zostanie też naliczona opłata za SKU Autouzupełnianie – za żądanie.

Za żądania autouzupełniania z widżetu autouzupełniania miejsc w interfejsie Maps JavaScript API może zostać naliczona opłata za SKU autouzupełniania – za żądanie, gdy wysyłasz żądania z nieprawidłowej sesji autouzupełniania. Może się tak zdarzyć, gdy użytkownik wpisze lub skopiuje/wklei w widżecie kilka różnych adresów i nie zawsze wybierze przewidywanego autouzupełniania.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatności są uruchamiane w przypadku:
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: automatyczne uzupełnianie bez szczegółów miejsca – na sesję

Ta wersja SKU jest naliczana, gdy sesja autouzupełniania nie obejmuje prośby o szczegóły miejsca (w ciągu kilku minut od rozpoczęcia sesji).

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Sesja
  Aktywatory Rozliczenia są uruchamiane, jeśli aplikacja wysyła te 2 żądania w ramach jednej sesji:

Gdy wyświetlasz rachunek według kodu SKU, widzisz ten kod SKU:

  • Autouzupełnianie bez szczegółów miejsca – na sesję
  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: Autouzupełnianie (w ramach Szczegółów miejsca) – na sesję

Prośby o autouzupełnianie są bezpłatne. Ten kod SKU jest obciążany, gdy żądasz kolejnych informacji o miejscu na podstawie regularnych cen informacji o miejscu.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Sesja
  Aktywatory Autouzupełnianie (w ramach usługi Szczegóły miejsca) – za sesję SKU jest naliczany za sesję autouzupełniania, która prosi o szczegóły miejsca. Konkretnie:
  • Android: wywołanie funkcji fetchPlace()
  • iOS: wywołanie funkcji fetchPlaceFromPlaceID:
  • Usługa internetowa: żądanie Szczegółów miejsca

Pola w żądaniu:

Aby uniknąć niepotrzebnych opłat, w prośbie podaj tylko te pola, których potrzebujesz. W zależności od wybranych pól żądanie informacji o miejscu generuje też te dane SKU:

Jeśli nie określisz pól w żądaniu Szczegóły miejsca, zostaną zastosowane wszystkie SKU danych.

Jeśli podczas sesji autouzupełniania żądasz tylko odświeżenia identyfikatora szczegółów miejsca (Twoje żądanie zawiera tylko pole place_id), ta sesja zostanie rozliczona jako SKU: Autouzupełnianie bez szczegółów miejsca – według sesji.

  Przykłady

Ten przykład ilustruje serię żądań według platformy, które w przypadku wyświetlenia rachunku według SKU skutkowałyby wyświetleniem na nim tych kodów SKU:

  • Autouzupełnianie (w ramach Szczegółów miejsca) – na sesję
  • Szczegóły miejsc
  • Dane podstawowe

Przykładowe żądanie na podstawie platformy:

Prośby o dostępność na Androidzie

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (z FetchPlaceRequest zawierającym identyfikator miejsca docelowego i pole ADRES)

Prośby o dostęp do danych w iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (w tym identyfikator miejsca i pole GMSPlaceFieldFormattedAddress)

Wnioski o usługi internetowe

Zapytanie autouzupełniania miejsc (input="par", session_token: XYZ)
Zapytanie autouzupełniania miejsc (input="paris", session_token: XYZ)
Szczegóły miejsc (place_id, session_token: XYZ, fields:formatted_address)

  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: autouzupełnianie zapytań – na prośbę

Ta starsza wersja SKU jest rozliczana za żądania autouzupełniania zapytań.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory

Ten kod SKU jest uruchamiany, gdy przesyłasz żądanie autouzupełniania zapytań za pomocą tych usług:

Ustalanie cen na podstawie sesji autouzupełniania nie jest obsługiwane w przypadku autouzupełniania zapytań. Kolejne żądania dotyczące szczegółów miejsca będą obciążane zgodnie z kodem SKU usługi Szczegóły miejsca Pro.

  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Szczegóły miejsca Pro

Ten kod SKU jest rozliczany w przypadku żądań informacji o miejscach z użyciem starszej wersji interfejsu API.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatności są uruchamiane w przypadku żądań z tych interfejsów API:

W przypadku interfejsu web API i usług opłata za SKU Szczegóły miejsca jest naliczana niezależnie od tego, czy podasz token sesji.

Ten kod SKU powoduje też naliczanie opłat za kody SKU danych: jeśli w prośbie uwzględnisz pola danych, może to spowodować dodatkowe naliczanie opłat za kody SKU danych: Basic, ContactAtmosphere. Określ tylko pola danych, które chcesz pominąć, aby uniknąć zbędnych kosztów. Obciążamy Cię za ten kod SKU oraz za dane, o które prosisz.

  Przykłady
  1. Wykonaj jedno z tych działań:
    • Urządzenia mobilne: wywołaj funkcję fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i określ tylko pole ADDRESS.
    • Interfejs API lub usługa internetowa: prześlij żądanie szczegółów miejsca i wskaż tylko pole adresu: getPlaceDetails(fields: formatted_address)
    Na fakturze (wyświetlanej według kodu SKU) zobaczysz te kody SKU:
    • Szczegóły miejsc
    • Dane podstawowe
  2. Wykonaj jedno z tych działań:
    • Urządzenia mobilne: wywołaj funkcję fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i określ tylko pole PHONE_NUMBER.
    • Interfejs API lub usługa internetowa: prześlij żądanie Szczegóły miejsca i wskaż pole numeru telefonu: getPlaceDetails(fields: formatted_phone_number)
    Na fakturze (wyświetlanej według kodu SKU) zobaczysz te kody SKU:
    • Szczegóły miejsc
    • Dane kontaktowe
  3. Wykonaj jedno z tych działań:
    • Urządzenie mobilne: wywołaj fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i wypełnij wszystkie pola.
    • Interfejs API internetowy lub usługa: wyślij żądanie szczegółów miejsca i wskaż wszystkie pola (jeśli nie podasz żadnych pól, żądanie będzie domyślnie wysyłane w tym formacie):getPlaceDetails().
    Na fakturze (wyświetlanej według kodu SKU) zobaczysz te kody SKU:
    • Szczegóły miejsc
    • Dane podstawowe
    • Dane kontaktowe
    • Dane o atmosferze
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: informacje o miejscu – odświeżanie identyfikatora

Ten kod SKU jest naliczany za żądania do interfejsu Place Details API, które odświeżają nieaktualne identyfikatory miejsc.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatność jest aktywowana, gdy wysyłasz żądanie szczegółów miejsca, podając tylko pole identyfikatora miejsca: getPlaceDetails(fields: place_id).
  Ceny Główna tabela cenowa
Tabela cen w Indiach

SKU: Find Place

Ta SKU obciąża za żądania usługi Find Place, które zwracają więcej pól niż tylko identyfikator miejsca.

Ten kod SKU powoduje też naliczanie opłat za kody SKU danych: jeśli w prośbie uwzględnisz pola danych, może to spowodować dodatkowe naliczanie opłat za kody SKU danych: Basic, ContactAtmosphere. Określ tylko pola danych, które chcesz pominąć, aby uniknąć zbędnych kosztów. Obciążamy Cię za ten kod SKU oraz za dane, o które prosisz.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Ten kod SKU obciąża za żądania wysyłane tymi metodami:
  • Znajdowanie bieżącego miejsca

Ten kod SKU powoduje też naliczanie opłat za kody SKU danych: jeśli w prośbie uwzględnisz pola danych, może to spowodować dodatkowe naliczanie opłat za kody SKU danych: Basic, ContactAtmosphere. Określ tylko pola danych, które chcesz pominąć, aby uniknąć zbędnych kosztów. Obciążamy Cię za ten kod SKU oraz za dane, o które prosisz.

  Przykłady

W poniższych przykładach pokazano, za które kody SKU naliczana jest opłata, gdy wysyłasz żądanie Znajdź obecne miejsce i określasz pola z kodów SKU danych podstawowych, kontaktowych i atmosferycznych. Aby zobaczyć kody SKU na rachunku, wyświetl go według kodu SKU w sposób opisany w artykule Analizacja wykorzystania i kosztów według kodu SKU.

Wysyłasz żądanie Znajdź miejsce, podając tylko pole ADDRESS:

Na Twoim rachunku widnieją te kody SKU:

  • Znajdowanie bieżącego miejsca
  • Dane podstawowe

Wysyłasz żądanie Znajdź miejsce, podając tylko pole PHONE_NUMBER:

Na rachunku widnieją te kody SKU:

  • Znajdowanie bieżącego miejsca
  • Dane kontaktowe

Wysyłasz żądanie Znajdź miejsce ze wszystkimi 3 polami typu danych:

Na rachunku widnieją te kody SKU:

  • Znajdowanie bieżącego miejsca
  • Dane podstawowe
  • Dane kontaktowe
  • Dane o atmosferze

  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: znajdowanie miejsca – tylko identyfikator

Ten kod SKU jest naliczany za żądania do usługi Find Place, które zwracają tylko identyfikator miejsca. Jeśli w zapytaniu FindPlace nie określisz żadnych pól, domyślnie zwrócony zostanie tylko identyfikator miejsca.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory wysyłasz żądanie Znajdź miejsce bez podania żadnych pól lub tylko pole place_id: FindPlace(fields: place_id).
  Ceny Główna tabela cen
Tabela cen w Indiach

SKU: Miejsca – wyszukiwanie w pobliżu

Ten kod SKU jest rozliczany za żądania wyszukiwania w pobliżu.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Ten kod SKU jest uruchamiany, gdy wysyłasz żądanie wyszukiwania w pobliżu za pomocą jednego z tych interfejsów API:

To żądanie nie obsługuje określania, które pola mają zostać zwrócone. Odpowiedź zwraca listę miejsc i podzbioru obsługiwanych pól danych.

Ten kod SKU powoduje też naliczanie opłat za kody SKU danych: jeśli w prośbie uwzględnisz pola danych, może to spowodować dodatkowe naliczanie opłat za kody SKU danych: Basic, ContactAtmosphere. Określ tylko pola danych, które chcesz pominąć, aby uniknąć zbędnych kosztów. Obciążamy Cię za ten kod SKU oraz za dane, o które prosisz.

  Przykłady

wysyłasz żądanie wyszukiwania w pobliżu, np. NearbySearch (San Francisco, 100 meters). Na fakturze widoczne są te kody SKU, gdy wyświetlasz ją według kodu SKU:

  • Miejsce
  • Dane podstawowe
  • Dane kontaktowe
  • Dane o atmosferze
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Miejsca – wyszukiwanie tekstowe

Ta SKU obciąża za żądania wysyłane do usługi wyszukiwania tekstowego w usłudze Places.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatności są pobierane za żądania dotyczące tych usług:

Żądania wyszukiwania tekstowego zwracają listę miejsc, ale nie obsługują określania, które pola mają być zwracane. Żądania wyszukiwania tekstowego zwracają podzbiór obsługiwanych pól danych. Obciążamy Cię za żądanie wyszukiwania tekstowego oraz wszystkie SKU typu danych: Basic Data, Contact Data i Atmosphere Data.

SKU Miejsce – wyszukiwanie tekstowe jest również wywoływane przez widżet Map JavaScript API Place SearchBox: getPlaces(), gdy użytkownik wybierze zapytanie o miejsce (ikona: szkło powiększające), nie wynik (ikona: pinezka), jak pokazano na ilustracji:

Wybór zapytania w widżecie pola wyszukiwania w widżecie szczegółów miejsc
Po wpisaniu w polu wyszukiwania słowa „pizza” w wynikach widżetu pola wyszukiwania zauważysz, że obok dostawy pizzy znajduje się ikona lupy, która wskazuje, że jest to zapytanie o miejsce (a nie wynik).
  Przykład

Jeśli wyślesz żądanie wyszukiwania tekstowego, np. TextSearch(123 Main Street), na fakturze zobaczysz te kody SKU, gdy wyświetlisz ją według kodu SKU:

  • Miejsce – wyszukiwanie tekstu
  • Dane podstawowe
  • Dane kontaktowe
  • Dane o atmosferze
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: zdjęcia informacji o miejscu w interfejsie Places API

Ten kod SKU jest rozliczany za starszą usługę Zdjęcie w Miejscach.

  Kategoria Enterprise
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatności są uruchamiane w przypadku:
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

Inne limity wykorzystania

Chociaż nie ma maksymalnej liczby żądań dziennie, nadal obowiązują te limity wykorzystania:

  • Places API (nowy): limit szybkości to 600 zapytań na minutę (zapytań na minutę) na metodę interfejsu API w danym projekcie. Oznacza to, że każda metoda interfejsu API ma osobny limit.

  • Places API: limit szybkości to 6000 zapytań na minutę (zapytań na minutę). Jest to suma żądań po stronie klienta i po stronie serwera dla wszystkich aplikacji korzystających z danych logowania tego samego projektu.

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 w Warunkach korzystania z usługi Google Maps Platform.