Korzystanie z Maps JavaScript API i rozliczanie

Zgodnie z typem żądania żądania interfejsu Maps JavaScript API generują wywołania do 2 różnych SKU: wczytywania map lub panoram. Wywołania interfejsów Biblioteki Miejsc, Maps JavaScript APIinnych usług JavaScript są rozliczane osobno od kodu SKU natywnego JavaScript. Aby wyświetlić spis treści tej strony, kliknij ikonę informacje.

Płatności i ceny w Maps JavaScript API

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

SKU: Mapy dynamiczne

Ten kod SKU jest naliczany za wczytywanie mapy, gdy aplikacja wyświetla mapę.

  Kategoria Essentials
  Zdarzenie podlegające rozliczeniu Ładowanie mapy
  Aktywatory

Ten kod SKU jest naliczany za wczytywanie mapy, gdy aplikacja wyświetla mapę wczytaną w jeden z tych sposobów:

Interakcje użytkownika z mapą, takie jak przesuwanie, powiększanie lub przełączanie warstw mapy, nie powodują dodatkowego wczytywania mapy.

  Ceny Główna tabela cenowa
Tabela cenowa w Indiach

SKU: Dynamiczny widok ulicy

Ta SKU obciąża za żądania do interfejsu Street View Static API, które zwracają dynamiczną panoramę Street View.

  Kategoria Pro
  Zdarzenie podlegające rozliczeniu Panorama
  Aktywatory

Ta wersja jest uruchamiany, gdy utworzysz instancję obiektu Panorama za pomocą jednej z tych klas lub metod:

  Ceny Główna tabela cenowa
Tabela cen w Indiach

Cennik usługi Biblioteka miejsc, Maps JavaScript API

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.

  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:

  • Biblioteka Miejsc, Maps JavaScript API:
    id
    photos

  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:

  • Biblioteka Miejsc, Maps JavaScript API:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    types
    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ą:
  • Biblioteka Miejsc, Maps JavaScript API:
    accessibilityOptions
    businessStatus
    displayName
    googleMapsUri
    iconBackgroundColor
    primaryTypeDisplayName
    svgIconMaskURI
    types
    utcOffsetMinutes

  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:
  • Biblioteka Miejsc, Maps JavaScript API: internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    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.

  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:

  • Biblioteka Miejsc, Maps JavaScript API:
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

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

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ą:
  • Biblioteka Miejsc, Maps JavaScript API:
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    id
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    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 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:

  • Biblioteka Miejsc, Maps JavaScript API:
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  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:

  • Biblioteka Miejsc, Maps JavaScript API:
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  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:

  • Biblioteka miejsc, Maps JavaScript API:
    id

  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ą:
  • Biblioteka Miejsc, Maps JavaScript API:
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    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:
  • Biblioteka Miejsc, Maps JavaScript API:
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  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:
  • Biblioteka Miejsc, Maps JavaScript API:
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  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

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.

W przypadku usługi internetowej te żądania interfejsów Places API umożliwiają określenie pól danych, które mają być zwracane:

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. 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 Płatności są aktywowane, gdy poprosisz o wypełnienie dowolnego z tych pól:
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
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.
Zobacz Pola (szczegóły miejsca)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total.
  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: 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 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: informacje o miejscu – odświeżanie identyfikatora

Ten kod SKU obciąża koszty żądań 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 cenowa 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 kosztami żądania wysyłane za pomocą tych metod:
  • 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 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 Znajdź miejsce, podając tylko pole adresu: FindPlace(fields: formatted_address). Na rachunku widać te numery SKU:
    • Znajdź miejsce
    • Dane podstawowe
  2. Wysyłasz żądanie Znajdź miejsce i wypełniasz pole numeru telefonu:FindPlace(fields: formatted_phone_number). Na rachunku widać te kody SKU:
    • Znajdź miejsce
    • Dane kontaktowe
  3. Wysyłasz żądanie Znajdź miejsce i wyznaczasz pola ze wszystkich 3 typów zasobników danych: FindPlace(fields: formatted_address, opening_hours, price_level). Na rachunku widać te numery SKU:
    • Znajdź miejsce
    • Dane podstawowe
    • Dane kontaktowe
    • Dane o atmosferze
  Ceny Główna tabela cenowa
Tabela cenowa 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 żądaniu znajdowania miejsca 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 cenowa
Tabela cenowa 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

Ceny usług związanych z JavaScriptem

Usługi związane z JavaScriptem są rozliczane osobno. Więcej informacji znajdziesz na stronie dotyczącej korzystania z usługi i rozliczeń:

Inne limity wykorzystania

Chociaż nie ma maksymalnej liczby żądań dziennie, w przypadku interfejsu Maps JavaScript API obowiązują te limity użycia:

  • 30 000 żądań na minutę.
  • 300 żądań na minutę na adres IP. W konsoli Google Cloud ten limit jest określany jako wczytania mapy na minutę na użytkownika.

Limity dotyczące korzystania z fotorealistycznych map 3D w Maps JavaScript

W przypadku map 3D o fotorealistycznej jakości w Maps JavaScript obowiązują te limity użycia:

  • 100 QPM (żądań na minutę) .
  • 10 żądań na minutę na adres IP .

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

Szczegółowe informacje o dozwolonym sposobie korzystania z usługi znajdziesz w sekcji Ograniczenia licencji w Warunkach korzystania z usługi Google Maps Platform.