Korzystanie z Maps JavaScript API i rozliczanie

Interfejs Maps JavaScript API korzysta z modelu płatności według wykorzystania. Żądania interfejsu Maps JavaScript API generują wywołania 2 różnych SKU w zależności od typu żądania: wczytania mapy lub panoram. Wywołania interfejsów Biblioteki Miejsc, Maps JavaScript API i innych usług JavaScript są rozliczane osobno od kodu SKU natywnego JavaScript. Oprócz ogólnych Warunków korzystania z usługi Google istnieją limity korzystania dotyczące wyłącznie interfejsu Maps JavaScript API. Zarządzaj kosztami i wykorzystaniem za pomocą narzędzi dostępnych w konsoli Google Cloud.

Jak naliczane są opłaty za Maps JavaScript API

Interfejs Maps JavaScript API korzysta z modelu płatności według wykorzystania. Interfejsy API i pakiety SDK Google Maps Platform są rozliczane według SKU. Korzystanie jest śledzone w przypadku każdego kodu SKU, a każdy interfejs API lub pakiet SDK może mieć więcej niż 1 kod SKU produktu. Koszt jest obliczany na podstawie

Korzystanie z kodu SKU × cena za każde użycie

Aby oszacować koszty korzystania z interfejsu API lub pakietu SDK, skorzystaj z naszego kalkulatora cen i kosztów użytkowania. W przypadku kwalifikujących się kodów SKU Google Maps Platform w każdym miesiącu na każde konto rozliczeniowe jest dostępne 200 USD do wykorzystania w Google Maps Platform. Ten zwrot środków jest automatycznie stosowany do kwalifikujących się kodów SKU.

Cennik interfejsu Maps JavaScript API

SKU: Mapy dynamiczne

Aplikacja, która wyświetla mapę wczytaną za pomocą identyfikatora mapy za pomocą interfejsu Maps JavaScript API lub mapę wczytaną za pomocą identyfikatora mapy i za pomocą pakietu Maps SDK na Androida lub pakietu Maps SDK na iOS.

LICZBA MIESIĘCZNYCH POBIERANYCH DANYCH
(cena za wczytanie MAP)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,007 USD za sztukę
(7,00 USD za 1000 sztuk)		 0,0056 USD za sztukę
(5,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

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

SKU: Dynamiczny widok ulicy

Za wczytywanie panoram Street View i map pobierana jest teraz opłata osobno. Za każdą instancję obiektu panoramy w aplikacji Maps JavaScript API, Maps SDK na Androida i Maps SDK na iOS pobierana jest opłata za dynamiczną panoramę Street View.

LICZBA MIESIĘCZNYCH WYMIAN(CENA ZA PANORAMĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,014 USD za sztukę
(14 USD za 1000 sztuk)		 0,0112 USD za sztukę
(11,20 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Tworzenie instancji obiektu panorama:

Cennik usługi Biblioteka miejsc, Maps JavaScript API

SKU: żądania autouzupełniania

Za każde żądanie wysłane do interfejsu Autocomplete API (New) bez tokena sesji naliczana jest opłata za żądania autouzupełniania.

Opłata jest też naliczana, jeśli używasz tokenów sesji i występuje co najmniej 1 z tych sytuacji:

  • Zakończ sesje, wysyłając jedno żądanie do usługi Szczegóły miejsca (nowa wersja), które zawiera żądanie dotyczące dowolnych pól zdefiniowanych przez SKU: Szczegóły miejsca (tylko lokalizacja).
    • Każde żądanie autouzupełniania (nowe), do 12 żądań, jest rozliczane za pomocą kodu SKU: żądania autouzupełniania.
    • Każde kolejne żądanie Autocomplete (New) jest rozliczane za pomocą SKU: Autocomplete Session Usage.
  • Aby przerwać sesję lub ją zakończyć, wywołaj funkcję SKU: Szczegóły miejsca (tylko identyfikatory). Wszystkie prośby o usługę Autocomplete (Nowa) są następnie rozliczane za pomocą SKU: Autocomplete Requests.
LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00283 USD za sztukę
(2,83 USD za 1000 sztuk)		 0,00227 USD za sztukę
(2,27 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wykorzystanie sesji autouzupełniania

Za każde żądanie wysłane do interfejsu Autocomplete API (New) z tokenem sesji pobierana jest opłata zgodnie z kodem SKU Autocomplete Session Usage.

Ta subskrypcja SKU jest opłacana w tych sytuacjach:

  • Sesja autouzupełniania została zakończona przez wywołanie SKU: Szczegóły miejsca (tylko lokalizacja):

    • Każde żądanie autouzupełniania (nowe), do 12 żądań, jest rozliczane za pomocą kodu SKU: żądania autouzupełniania.
    • Każde kolejne żądanie Autocomplete (New) jest rozliczane za pomocą SKU: Autocomplete Session Usage.

  • Sesja autouzupełniania została zakończona wywołaniem SKU: Szczegóły miejsca (poziom podstawowy, zaawansowany lub preferowany).

    Wywołanie funkcji Szczegóły miejsca, które wymaga podania dowolnego pola z SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), jest rozliczane zgodnie z opcją SKU: Szczegóły miejsca (preferowane).

  • Sesja autouzupełniania została zakończona wywołaniem SKU: Adres weryfikacji preferowany.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD za sztukę
(0,00 USD za 1000 sztuk)		 0,00 USD za sztukę
(0,00 USD za 1000 sztuk)		 0,00 USD za sztukę
(0,00 USD za 1000 sztuk)

SKU: informacje o miejscu (tylko identyfikatory)

Za pomocą maski pola lub listy pól w prośbie o szczegóły miejsca (nowa) możesz ograniczyć odpowiedź tylko do określonych pól. Ten SKU jest uruchamiany, gdy tylko żądasz tych pól:

Biblioteka miejsc, Maps JavaScript API: id
photos

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD za sztukę
(0,00 USD za 1000 szt.)		 0,00 USD za sztukę
(0,00 USD za 1000 szt.)		 0,00 USD za sztukę
(0,00 USD za 1000 szt.)

SKU: szczegóły miejsca (tylko lokalizacja)

Za pomocą maski pola lub listy pól w prośbie o szczegóły miejsca (nowa) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Biblioteka miejsc, Maps JavaScript API: addressComponents
adrFormatAddress
formattedAddress
location
plusCode
types
viewport

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,005 USD za sztukę
(5,00 USD za 1000 szt.)		 0,004 USD za sztukę
(4,00 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: informacje o miejscu (podstawowe)

Za pomocą maski pola lub listy pól w prośbie o szczegóły miejsca (nowa) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Biblioteka miejsc, Maps JavaScript API: accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,0170 USD za sztukę
(17 USD za 1000 szt.)		 0,0136 USD za sztukę
(13,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: informacje o miejscu (zaawansowane)

Za pomocą maski pola lub listy pól w prośbie o szczegóły miejsca (nowa) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,020 USD za sztukę
(20,00 USD za 1000 szt.)		 0,016 USD za sztukę
(16 USD za 1000 sztuk)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: informacje o miejscu (preferowane)

Za pomocą maski pola lub listy pól w prośbie o szczegóły miejsca (nowa) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko 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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,025 USD za sztukę
(25 USD za 1000 sztuk)		 0,020 USD za sztukę
(20,00 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie w pobliżu (podstawowe)

Za pomocą maski pola lub listy pól w żądaniu wyszukiwania w pobliżu (nowa wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Biblioteka Miejsc, Maps JavaScript API: accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,032 USD za sztukę
(32 USD za 1000 szt.)		 0,0256 USD za sztukę
(25,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie w pobliżu (zaawansowane)

Za pomocą maski pola lub listy pól w żądaniu wyszukiwania w pobliżu (nowa wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,035 USD za sztukę
(35,00 USD za 1000 szt.)		 0,028 USD za sztukę
(28 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie w pobliżu (preferowane)

Za pomocą maski pola lub listy pól w żądaniu wyszukiwania w pobliżu (nowa wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko 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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,040 USD za sztukę
(40,00 USD za 1000 szt.)		 0,032 USD za sztukę
(32 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstowe (tylko identyfikator)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania tekstowego (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Biblioteka miejsc, Maps JavaScript API:id

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD za sztukę
(0,00 USD za 1000 szt.)		 0,00 USD za sztukę
(0,00 USD za 1000 szt.)		 0,00 USD za sztukę
(0,00 USD za 1000 szt.)

SKU: wyszukiwanie tekstowe (podstawowe)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania tekstowego (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Biblioteka Miejsc, Maps JavaScript API: accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,032 USD za sztukę
(32 USD za 1000 szt.)		 0,0256 USD za sztukę
(25,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstowe (zaawansowane)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania tekstowego (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,035 USD za sztukę
(35,00 USD za 1000 szt.)		 0,028 USD za sztukę
(28 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstu (preferowane)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania tekstowego (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko 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

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,040 USD za sztukę
(40,00 USD za 1000 szt.)		 0,032 USD za sztukę
(32 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: umieszczanie zdjęcia

Za każde żądanie wysłane do interfejsu API pobierana jest opłata za SKU Zdjęcie miejsca.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,007 USD za sztukę
(7,00 USD za 1000 sztuk)		 0,0056 USD za sztukę
(5,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Informacje o sesjach autouzupełniania

Sesja autouzupełniania obejmuje kilka żądań autouzupełniania (aby pobrać sugestie dotyczące miejsca, gdy użytkownik je wpisze) oraz co najwyżej 1 żądanie szczegółów miejsc (aby pobrać szczegóły miejsca wybranego przez użytkownika). 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 propozycji autouzupełniania, wywoływana jest funkcja 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 za pomocą innych SKU.

Informacje o kodach SKU danych o miejscach

Te 3 poziomy pakietu danych Places to: Dane podstawowe, Dane kontaktów i 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 wywołania interfejsów API Places obsługują określanie pól danych do zwrócenia:

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

Za pomocą parametru fields w żądaniu dotyczącej szczegółów miejsca lub znajdowania miejsca możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Podstawowe są uwzględnione w kosztach podstawowych prośby o dane o miejscach i nie powodują dodatkowych opłat. Kod SKU Dane podstawowe jest uruchamiany, gdy zostanie przesłane żądanie dotyczące 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 lub Place.Field.UTC_OFFSET.
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes lub 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 lub wheelchair_accessible_entrance
LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt prośby o utworzenie miejsca
+ 0,00 USD		 Koszt prośby o utworzenie miejsca
+ 0,00 USD		 Koszt prośby o utworzenie miejsca
+ 0,00 USD

SKU: dane kontaktowe

Za pomocą parametru fields w żądaniu dotyczącego 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ę. SKU Dane kontaktowe jest uruchamiany, gdy wymagane są dowolne 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
LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt wysłania żądania do Places
+ 0,003 USD za każdą
(+ 3,00 USD za 1000)		 Koszt zgłoszenia do Google Places
+ 0,0024 USD za każdą pozycję
(+ 2,40 USD za 1000 pozycji)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: dane dotyczące atmosfery

Za pomocą parametru fields w żądaniu dotyczącego szczegółów miejsca lub znajdowania miejsca możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Atmosfera powodują dodatkową opłatę. Kod SKU Dane o atmosferze jest uruchamiany, gdy wymagane jest jedno 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 lub Place.Field.USER_RATING_COUNT,
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch lub GMSPlaceFieldServesVegetarianFood.
  • JavaScript zobacz Pola (szczegóły miejsca).
  • Usługa internetowa: 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 lub user_ratings_total.
LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt wysłania żądania do Places
+ 0,005 USD za każdą
(+ 5,00 USD za 1000)		 Koszt prośby o utworzenie miejsca
+ 0,004 USD za każdą
(+ 4,00 USD za 1000)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: Autouzupełnianie – na żądanie

Za te wywołania lub żądania, które nie zawierają tokenu sesji, pobierana jest opłata za Autouzupełnianie – za żądanie:

Za wywołania z nieprawidłowej sesji autouzupełniania (np. sesji, która używa tokenu sesji) również naliczamy opłatę SKU Autouzupełnianie – na żądanie.

Żądania autouzupełniania z interfejsu Maps JavaScript API – widżet autouzupełniania miejsca mogą być obciążone stawką autouzupełniania na żądanie, jeśli wywołania pochodzą z nieprawidłowej sesji autouzupełniania. Może się tak zdarzyć, gdy użytkownik wpisze kilka różnych adresów lub skopiuje i wklei różne adresy do widżetu i nie zawsze wybierze przewidywanego uzupełnienia.

LICZBA MIESIĘCZNYCH PROŚB
(CENA ZA PROŚBĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00283 USD za sztukę
(2,83 USD za 1000 sztuk)		 0,00227 USD za sztukę
(2,27 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

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

SKU Autouzupełnianie bez szczegółów miejsca docelowego – za sesję jest naliczane za sesję autouzupełniania, która nie obejmuje żądania szczegółów miejsca docelowego (w ciągu kilku minut od rozpoczęcia sesji).

LICZBA MIESIĘCZNYCH POZYCZEŃ
(cena za SESJĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,017 USD za sztukę
(17 USD za 1000 szt.)		 0,0136 USD za sztukę
(13,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Przykład

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

Android

iOS

Usługa internetowa

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

  • Autouzupełnianie bez szczegółów miejsca docelowego – za sesję (cena zaczyna się od 0,017 USD za sesję)

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

SKU Automatyczne uzupełnianie (w ramach usługi Szczegóły miejsca docelowego) – za sesję jest naliczana za sesję automatycznego uzupełniania, która obejmuje co najmniej 1 z tych elementów:

  • Android: wywołanie funkcji fetchPlace()
  • iOS: wywołanie funkcji fetchPlaceFromPlaceID:
  • Usługa internetowa: żądanie Szczegółów miejsca

Żądanie autouzupełniania jest bezpłatne, a kolejne wywołanie funkcji Dane o miejscu jest płatne zgodnie z normalnymi stawkami za dane o miejscu.

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

Jeśli nie określisz pól w żądaniu dotyczącym szczegółów miejsca, zostaną uruchomione wszystkie SKU danych (podstawowe, kontaktowe i atmosferyczne).

Prośby o odświeżenie identyfikatora szczegółów miejsca (zapytania, które określają tylko pole place_id) podczas sesji autouzupełniania są rozliczane jako SKU: Autouzupełnianie bez szczegółów miejsca – za sesję.

LICZBA MIESIĘCZNYCH POZYCZEŃ
(cena za SESJĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD 0,00 USD 0,00 USD

Przykład

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

Android

iOS

Usługa internetowa

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

  • Autouzupełnianie (w ramach usługi Szczegóły miejsca docelowego) – za sesję (obciążenie na poziomie 0,00 USD).
  • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
  • Dane podstawowe (obciążenie 0,00 USD)

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

Za każdą prośbę do automatycznego uzupełniania zapytań naliczane są opłaty zgodnie z jednostką SKU Zapytanie – automatyczne uzupełnianie zapytań.

LICZBA MIESIĘCZNYCH PROŚB
(CENA ZA PROŚBA)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00283 USD za sztukę
(2,83 USD za 1000 sztuk)		 0,00227 USD za sztukę
(2,27 USD za 1000 sztuk)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Ustalanie cen na podstawie sesji autouzupełniania nie jest obsługiwane w przypadku autouzupełniania zapytań. Kolejne wywołania Places Details są rozliczane zgodnie z normalnymi opłatami za Places Details.

SKU: informacje o miejscach

Połączenia z serwisem Places Details są naliczane w ten sposób:

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,017 USD za sztukę
(17 USD za 1000 szt.)		 0,0136 USD za sztukę
(13,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Kod SKU Places Details jest generowany 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 podano token sesji.

Wywołanie lub żądanie danych o miejscu generuje też SKU danych (Basic, Contact lub Atmosphere), w zależności od pól określonych w wywołaniu lub żądaniu. Jeśli w wywołaniu lub żądaniu dotyczącego szczegółów miejsca nie ma określonych pól, NIE zostanie wywołane WSZYSTKIE SKU danych, a Ty zostaniesz obciążony kosztem wywołania lub żądania dotyczącego szczegółów miejsca oraz kosztem wszystkich danych.

Przykłady

  1. Wykonaj jedno z tych połączeń lub prześlij jedną z tych próśb:
    • Urządzenia mobilne: wywołaj funkcję fetchPlace() w Androidzie lub fetchPlaceFromPlaceID: w 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 rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane podstawowe (obciążenie 0,00 USD)
  2. Wykonaj jedno z tych połączeń lub prześlij jedną z tych próśb:
    • Urządzenia mobilne: wywołaj funkcję fetchPlace() w Androidzie lub fetchPlaceFromPlaceID: w iOS i wskaż tylko pole PHONE_NUMBER.
    • Interfejs API lub usługa internetowa: prześlij żądanie szczegółów miejsca i wskaż pole numeru telefonu:getPlaceDetails(fields: formatted_phone_number)
    Na fakturze zobaczysz te kody SKU (wyświetlając fakturę według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  3. Wykonaj jedno z tych połączeń lub prześlij jedną z tych próśb:
    • Urządzenie mobilne: wywołaj fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i wypełnij wszystkie pola.
    • Interfejs API lub usługa internetowa: wyślij żądanie Szczegóły miejsca i wskaż wszystkie pola (jeśli nie podasz żadnych pól, żądanie tego typu jest domyślne): getPlaceDetails().
    Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane podstawowe (obciążenie 0,00 USD)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
    • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: informacje o miejscach – odświeżanie identyfikatorów

Użyj żądania Szczegóły miejsca, aby odświeżyć nieaktualne identyfikatory miejsc. Takie żądania są bezpłatne.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD 0,00 USD 0,00 USD

Przykład

Prześlij żądanie szczegółów miejsca, podając tylko pole identyfikatora miejsca: getPlaceDetails(fields: place_id). Na rachunku zobaczysz ten kod SKU (wyświetlając rachunek według kodu SKU):

  • Szczegóły miejsc – odświeżanie identyfikatora (obciążenie 0,00 USD)

SKU: Find Place

Znajdź miejsce: opłata za prośbę o znalezienie miejsca.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,017 USD za sztukę
(17 USD za 1000 szt.)		 0,0136 USD za sztukę
(13,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Prośby o znalezienie miejsca generują też dane SKU (podstawowe, kontaktowe lub atmosferyczne), w zależności od pól określonych w prośbie. Podobnie jak w przypadku żądań szczegółów miejsca możesz użyć parametru fields w żądaniu FindPlace, aby ograniczyć odpowiedź tylko do określonych pól. Opłaty są naliczane za żądanie „Znajdź miejsce” oraz za żądane dane. Domyślnie, jeśli żądane są pola NO, zwracany jest tylko identyfikator miejsca, więc nie są naliczane dodatkowe opłaty za dane.

Przykłady

  1. Wysyłasz żądanie Znajdź miejsce, podając tylko pole adresu: FindPlace(fields: formatted_address). Na rachunku zobaczysz te kody SKU ( podczas wyświetlania rachunku według kodu SKU):
    • Znajdź miejsce (cena od 0,017 USD za połączenie)
    • Dane podstawowe (obciążenie 0,00 USD)
  2. Wysyłasz żądanie Znajdź miejsce i wypełniasz pole numeru telefonu:FindPlace(fields: formatted_phone_number). Na rachunku zobaczysz te kody SKU ( podczas wyświetlania rachunku według kodu SKU):
    • Znajdź miejsce (cena od 0,017 USD za połączenie)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  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 ( wyświetlanym według kodu SKU) zobaczysz te kody SKU:
    • Znajdź miejsce (cena od 0,017 USD za połączenie)
    • Dane podstawowe (obciążenie 0,00 USD)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
    • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: znajdowanie miejsca – tylko identyfikator

Znajdź miejsce – tylko identyfikator jest naliczany w przypadku żądań usługi Znajdź miejsce, które podają tylko zwracany identyfikator miejsca. Domyślnie, jeśli w żądaniu znajdowania miejsca nie zostaną określone żadne pola, zwrócony zostanie tylko identyfikator miejsca.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD 0,00 USD 0,00 USD

Przykład

Wysyłasz żądanie Znajdź miejsce, podając tylko pole place_id: FindPlace(fields: place_id). Na rachunku zobaczysz ten kod SKU (wyświetlając rachunek według kodu SKU):

  • Znajdź miejsce – tylko identyfikator (obciążenie 0,00 USD)

Miejsca – wyszukiwanie w pobliżu: opłata jest naliczana za żądania wysyłane do usługi wyszukiwania miejsc w pobliżu w Maps JavaScript API (nearbySearch()) lub do usługi wyszukiwania miejsc w pobliżu w Places API.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,032 USD za sztukę
(32 USD za 1000 szt.)		 0,0256 USD za sztukę
(25,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Żądania dotyczące wyszukiwania w pobliżu zwracają listę miejsc, ale nie obsługują określania, które pola mają być zwracane. Żądania wyszukiwania w pobliżu zwracają podzbiór obsługiwanych pól danych. Zapytanie dotyczące wyszukiwania w pobliżu jest płatne od 0, 032 USD za każde zapytanie, a także za wszystkie SKU typu danych (Dane podstawowe, Dane kontaktowe i Dane o atmosferze).

Przykład

wysyłasz żądanie wyszukiwania w pobliżu, np. NearbySearch (San Francisco, 100 meters). Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):

  • Miejsce – wyszukiwanie w pobliżu (cena od 0,032 USD za wywołanie)
  • Dane podstawowe (obciążenie 0,00 USD)
  • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: Miejsca – wyszukiwanie tekstowe

Miejsca – wyszukiwanie tekstu: opłata jest naliczana za żądania wysyłane do interfejsu Maps JavaScript API usługi wyszukiwania tekstu w miejscach (textSearch()) lub do interfejsu Places API usługi wyszukiwania tekstu.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,032 USD za sztukę
(32 USD za 1000 szt.)		 0,0256 USD za sztukę
(25,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Żądania dotyczące 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. Za żądanie wyszukiwania tekstowego pobierana jest opłata w wysokości od 0, 032 USD za każde żądanie, a także za wszystkie SKU typu „dane” (dane podstawowe, dane kontaktowe i dane o atmosferze).

SKU Miejsce – wyszukiwanie tekstu jest też generowane przez widżet Place SearchBox w interfejsie Maps JavaScript API: getPlaces()metodę po wybraniu przez użytkownika zapytania o miejsce (ikona: szkło powiększające), nie wyniku (ikona: pinezka), jak pokazano na ilustracji:

Wybór zapytania w widżecie pola wyszukiwania w widżecie szczegółów miejsc
W wynikach widżetu pola wyszukiwania po wpisaniu w polu wyszukiwania hasła „pizza” zwróć uwagę, że obok opcji pizza delivery znajduje się ikona lupy, która wskazuje, że jest to zapytanie o miejsce (a nie wynik).

Przykład

wysyłasz żądanie wyszukiwania tekstowego, np. TextSearch(123 Main Street). Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):

  • Miejsce – wyszukiwanie tekstu (cena od 0,032 USD za wywołanie)
  • Dane podstawowe (obciążenie 0,00 USD)
  • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: Zdjęcie miejsc

Kod SKU Zdjęcie Miejsca jest naliczany za:

W przypadku usługi JavaScript wywołanie metody PlacePhoto.getUrl() nie powoduje obciążenia, dopóki adres URL nie zostanie faktycznie użyty do uzyskania danych z pliku obrazu.

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,007 USD za sztukę
(7,00 USD za 1000 sztuk)		 0,0056 USD za sztukę
(5,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

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 Wczytywanie mapy na użytkownika na minutę.

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

W przypadku fotorealistycznych map 3D 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.

Zarządzanie kosztem użytkowania

Aby zarządzać kosztami korzystania z interfejsu Maps JavaScript API lub sprostać wymaganiom związanemu z ruchem produkcyjnym, ustaw dzienne limity kwotowe dla wszystkich żądań do dowolnego interfejsu API. Dzienne limity są resetowane o północy czasu pacyficznego.

Aby wyświetlić lub zmienić limity dotyczące interfejsu Maps JavaScript API:

  1. W konsoli Google Cloud otwórz stronę Limity platformy Mapy Google.
  2. Kliknij menu interfejsów API i wybierz Maps JavaScript API.
  3. Aby wyświetlić limity kwoty, przewiń w dół do karty Prośby.
    Tabela z nazwami i limitami limitów.
  4. Aby zmienić limit, kliknij ikonę Edytuj.
    W wyświetlonym oknie w polu Limit kontyngentu wpisz preferowany limit dziennej płatnej puli (do limitu kontyngentu, jeśli został określony przez Google) i kliknij Zapisz.

Jeśli w danym dniu wykorzystanie interfejsu API osiągnie limit naliczalny, aplikacja nie będzie mieć do niego dostępu do końca dnia.