Pakiet Miejsca SDK do wykorzystania i rozliczeń w systemie Android

Aby wyświetlić spis treści tej strony, kliknij ikonę informacje.

Płatności i ceny pakietu SDK Miejsc na Androida

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

Szczegóły SKU produktu w pakiecie SDK Miejsc na Androida

Informacje o maskach pól

Aby określić listę pól, które mają być zwracane w odpowiedzi, używaj w żądaniach masek pól, zwanych też listami pól. Następnie zostaniesz obciążony opłatą za najwyższy kod SKU odpowiedni dla Twojej prośby. Oznacza to, że jeśli wybierzesz pola w obu SKU (Basic) i SKU (Advanced), zostaniesz obciążony zgodnie z SKU (Advanced).

Korzystanie z maski pola to dobra praktyka projektowania, która pozwala uniknąć przesyłania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Sesje autouzupełniania (Nowe)

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 docelowego (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 Weryfikacja adresu, żądania Autouzupełnianie (Nowe) są obciążane tak, jakby nie podano tokenu 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ć więcej niż raz. Jeśli ponownie użyjesz tokena sesji, sesja zostanie uznana za nieprawidłową, a za żądania zostanie pobrana 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 w celu ograniczenia liczby żądań, za które naliczane są opłaty podczas pojedynczej sesji autouzupełniania, znajdziesz w artykule Tokeny sesji lub SKU: wykorzystanie 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 opuszczasz sesję.
  • Twoje żądanie zawiera token sesji, ale sesję kończysz pod pewnymi warunkami. Informacje o użyciu sesji autouzupełniania znajdziesz w artykułach Tokeny sesjiUżycie sesji autouzupełniania.
  Ceny Główna tabela cenowa
Tabela cenowa 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 identyfikator SKU żądań Autouzupełnianie (nowe), który umożliwia ograniczenie liczby żądań, za które naliczane są opłaty w ramach pojedynczej sesji autouzupełniania. Informacje o używaniu sesji autouzupełniania znajdziesz w sekcji Tokeny sesji.

Uwaga: jeśli nie korzystasz z sesji z usługą Autouzupełnianie (nowa), naliczenia są naliczane za każdą prośbę wysłaną do usługi Autouzupełnianie za pomocą SKU: Autouzupełnianie.

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

  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

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

Ten SKU obciąża 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:

  • Android:
    Place.Field.DISPLAY_NAME
    Place.Field.ID
    Place.Field.PHOTO_METADATAS
    Place.Field.RESOURCE_NAME

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy 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:

  • Android
    Place.Field.ADDRESS_COMPONENTS
    ADR_FORMAT_ADDRESS
    Place.Field.FORMATTED_ADDRESS
    Place.Field.LOCATION
    Place.Field.PLUS_CODE
    Place.Field.SHORT_FORMATTED_ADDRESS
    Place.Field.TYPES
    Place.Field.VIEWPORT

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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ą:
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.BUSINESS_STATUS
    Place.Field.GOOGLE_MAPS_URI
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.SUB_DESTINATIONS
    Place.Field.UTC_OFFSET

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

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

Ta SKU jest rozliczana 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 cena SKU jest aktywowana, gdy żądasz tych pól:
  • Android Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

Jeśli zakończysz sesję autouzupełniania wywołaniem szczegółów miejsca, które prosi o dowolne poleSKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), wywołanie zostanie naliczone zgodnie z SKU: Szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: wykorzystanie sesji autouzupełniania.

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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:

  • Android:
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.TAKEOUT

Jeśli sesja autouzupełniania zostanie zakończona wywołaniem szczegółów miejsca, które wysyła dowolne polepoziomu SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), wywołanie zostanie naliczone zgodnie z poziomem SKU: Szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie – wykorzystanie sesji.

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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ą:
  • Android
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_URL
    Place.Field.LAT_LNG
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.ID
    Place.Field.NAME
    Place.Field.TYPES
    Place.Field.UTC_OFFSET
    Place.Field.VIEWPORT
    Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy 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:

  • Android:
    Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy 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:

  • Android:
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.TAKEOUT

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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:

  • Android:
    Place.Field.DISPLAY_NAME
    Place.Field.ID
    Place.Field.RESOURCE_NAME

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cen 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 wysyłasz te pola lub pola z niższą stawką:
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.ADR_FORMAT_ADDRESS
    Place.Field.BUSINESS_STATUS
    Place.Field.FORMATTED_ADDRESS
    Place.Field.GOOGLE_MAPS_URI
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.PRIMARY_TYPE
    Place.Field.PRIMARY_TYPE_DISPLAY_NAME
    Place.Field.SHORT_FORMATTED_ADDRESS
    Place.Field.SUB_DESTINATIONS
    Place.Field.TYPES
    Place.Field.UTC_OFFSET
    Place.Field.VIEWPORT

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy 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 Ta cena SKU jest aktywowana, gdy żądasz tych pól:
  • Android:
    Place.Field.CURRENT_OPENING_HOURS
    Place.Field.CURRENT_SECONDARY_OPENING_HOURS
    Place.Field.INTERNATIONAL_PHONE_NUMBER
    Place.Field.NATIONAL_PHONE_NUMBER
    Place.Field.OPENING_HOURS
    Place.Field.PRICE_LEVEL
    Place.Field.RATING
    Place.Field.SECONDARY_OPENING_HOURS
    Place.Field.USER_RATING_COUNT
    Place.Field.WEBSITE_URI

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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:
  • Android:
    Place.Field.ALLOWS_DOGS
    Place.Field.CURBSIDE_PICKUP
    Place.Field.DELIVERY
    Place.Field.DINE_IN
    Place.Field.EDITORIAL_SUMMARY
    Place.Field.EV_CHARGE_OPTIONS
    Place.Field.FUEL_OPTIONS
    Place.Field.GOOD_FOR_CHILDREN
    Place.Field.GOOD_FOR_GROUPS
    Place.Field.GOOD_FOR_WATCHING_SPORTS
    Place.Field.LIVE_MUSIC
    Place.Field.MENU_FOR_CHILDREN
    Place.Field.OUTDOOR_SEATING
    Place.Field.PARKING_OPTIONS
    Place.Field.PAYMENT_OPTIONS
    Place.Field.RESERVABLE
    Place.Field.RESTROOM
    Place.Field.REVIEWS
    Place.Field.SERVES_BEER
    Place.Field.SERVES_BREAKFAST
    Place.Field.SERVES_BRUNCH
    Place.Field.SERVES_COCKTAILS
    Place.Field.SERVES_COFFEE
    Place.Field.SERVES_DESSERT
    Place.Field.SERVES_DINNER
    Place.Field.SERVES_LUNCH
    Place.Field.SERVES_VEGETARIAN_FOOD
    Place.Field.SERVES_WINE
    Place.Field.TAKEOUT

  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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 cenowa w Indiach

Szczegóły starszych wersji kodu SKU pakietu SDK Miejsc na Androida

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 został podany żaden token sesji.

Żądania autouzupełniania i żądania dotyczące szczegółów miejsc korzystające z sesji są rozliczane za pomocą 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.

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. Za ten kod SKU naliczane są opłaty dodatkowe do kodu podstawowego w przypadku żądania, które je wywołało.

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

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie z określonymi maskami pól.
  Aktywatory SKU Dane podstawowe jest uruchamiany, gdy żądasz któregokolwiek z tych pól:
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.TYPES
    Place.Field.VIEWPORT
    Place.Field.UTC_OFFSET.
  • iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    GMSPlaceFieldViewport
  • Usługa internetowa:
    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
  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: dane kontaktowe

Ten kod SKU to kod SKU danych, który obciąża za pola Dane kontaktowe w ramach żądania dotyczącego szczegółów miejsca lub znajdowania miejsca. Za ten kod SKU naliczane są opłaty dodatkowe do kodu podstawowego w przypadku żądania, które je wywołało.

Za pomocą parametru fields w żądaniu dotyczącym szczegółów miejsca lub znajdowania miejsca w przypadku usług internetowych albo tablicy Place.Field w przypadku Androida 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 wymagane jest jedno z tych pól:
  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS lub Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours,GMSPlaceFieldPhoneNumber lub GMSPlaceFieldWebsite
  • Usługa internetowa: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours lub website
  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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:
Android
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT
  Przykłady rozliczeń za maski pól

Oto przykłady sposobu naliczania opłat za żądanie na podstawie pól wybranych w masce.

  • Jeśli maska pola żądania zawiera tylko pola z tego kodu SKU: żądanie jest rozliczane według stawki tego kodu SKU. Możesz na przykład poprosić o jeden lub więcej pól z tego kodu SKU i zostaniesz obciążony opłatą według stawki tego kodu.
  • Jeśli maska pól żądania 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 z kilku kodów SKU, np. Essentials i Enterprise, żądanie zostanie obciążone stawką taryfy Enterprise.
  Ceny Główna tabela cenowa
Tabela cenowa 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 tokenu sesji ponownie), zostanie też naliczona opłata za SKU Autouzupełnianie – za żądanie.

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

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Żądanie
  Aktywatory Płatności są naliczane za:
  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 cenowa
Tabela cenowa 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 miejscach na podstawie standardowych cen informacji o miejscach.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Sesja
  Aktywatory SKU Autouzupełnianie (w ramach usługi Szczegóły miejsca docelowego) – za sesję jest naliczane za sesję autouzupełniania, która obejmuje dowolne z tych żądań:
  • Android: wywołanie funkcji fetchPlace()
  • iOS: wywołanie funkcji fetchPlaceFromPlaceID:
  • Usługa internetowa: żądanie Szczegółów miejsca

Prośba o szczegółowe informacje o miejscu generuje SKU danych (Basic, Contact lub Atmosphere) w zależności od pól określonych w prośbie.

Jeśli w żądaniu informacji o miejscu nie podasz konkretnych pól, zostaną uruchomione wszystkie opcje SKU (Essentials, Pro, Enterprise i Enterprise + Atmosphere). Aby uniknąć niepotrzebnych opłat, podawaj tylko pola, których potrzebujesz.

Jeśli podczas sesji autouzupełniania żądasz tylko odświeżenia identyfikatora szczegółów miejsca (Twoja prośba określa tylko pole place_id), sesja zostanie rozliczona jako SKU: Autouzupełnianie bez szczegółów miejsca – za sesję.

  Przykłady

Jeśli aplikacja wysyła te 3 wyzwania w ramach jednej sesji:

Usługa internetowa

Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):

  • Autouzupełnianie (w ramach Szczegółów miejsca) – na sesję
  • Szczegóły miejsc
  • Dane podstawowe
  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 API i usług internetowych 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 wskaż tylko pole ADDRESS.
    • Interfejs API lub usługa internetowa: prześlij żądanie Szczegóły 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 wskaż 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ądzenia 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: Znajdź bieżące miejsce

Ta SKU obciąża za żądania dotyczące funkcji Znajdź obecne miejsce.

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 kosztami żądania wysyłane za pomocą tych metod:

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 podanych niżej przykładach pokazano, za które SKU jest naliczana opłata, gdy wysyłasz żądanie Znajdź obecne miejsce i określasz pola z poziomu 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 kosztu według kodu SKU.

  1. Wysyłasz żądanie findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) i wypełniasz tylko pole ADDRESS. Na rachunku widać te numery SKU:
    • Znajdowanie bieżącego miejsca
    • Dane podstawowe
  2. Wysyłasz żądanie findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) i określasz pole PHONE_NUMBER. Na rachunku widać te numery SKU:
    • Znajdowanie bieżącego miejsca
    • Dane kontaktowe
  3. Wysyłasz żądanie findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:(iOS) i określasz pola ze wszystkich 3 zasobników z danymi. Na rachunku widać te numery SKU:
    • Znajdowanie bieżącego miejsca
    • 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

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

Informacje o warunkach korzystania znajdziesz w sekcji Ograniczenia licencji w Warunkach korzystania z Google Maps Platform.