Korzystanie z Maps JavaScript API i rozliczanie

Interfejs Maps JavaScript API korzysta z modelu płatności według wykorzystania. Żądania Maps JavaScript API generują wywołania do 2 różnych SKU w zależności od typu żądania: wczytywania 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 jednego z tych pakietów: Maps SDK na Androida lub 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 szt.)		 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 pobierane są teraz osobne opłaty. 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 TRANSAKCJI(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łaty są też naliczane, jeśli używasz tokenów sesji i występuje co najmniej jeden z tych warunków:

  • Zakończ sesje za pomocą pojedynczego żądania informacji o miejscu docelowym (nowej wersji), które zawiera żądanie wszystkich pól zdefiniowanych przez SKU: informacje o miejscu docelowym (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 automatyczne uzupełnianie (nowe) są następnie obciążane 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 szt.)		 0,00227 USD za sztukę
(2,27 USD za 1000 sztuk)		 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.

Za ten kod SKU naliczane są opłaty w tych sytuacjach:

  • Sesja autouzupełniania została zakończona wywołaniem 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 usługi 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: weryfikacja adresu Preferred.

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 sztuk)		 0,004 USD za sztukę
(4,00 USD za 1000 sztuk)		 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 sztuk)		 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 sztuk)		 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 sztuk)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie w pobliżu (podstawowe)

Za pomocą maski pól lub listy pól w prośbie wyszukiwania w pobliżu (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, 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 sztuk)		 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 pól lub listy pól w prośbie wyszukiwania w pobliżu (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 w pobliżu (preferowane)

Za pomocą maski pól lub listy pól w prośbie wyszukiwania w pobliżu (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 sztuk)		 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 sztuk)		 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 sztuk)		 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 szt.)		 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, które użytkownik wpisze), a maksymalnie jedno żą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 sugestii 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 wykona wywołanie 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ż jednej sesji użytkownika. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a zapytania zostaną obciążone opłatą tak, jakby nie podano tokena sesji.

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

Informacje o kodach SKU danych o miejscach

Te 3 poziomy SKU 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ącego 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 wartości 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 wysłania żądania do Places
+ 0,0024 USD za każdą
(+ 2,40 USD za 1000)		 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 zapytania 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

Autouzupełnianie – na żądanie SKU jest naliczany za wszystkie te wywołania lub żądania, które nie zawierają tokenu sesji:

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.

Za żądania autouzupełniania z widżetu Autocomplete Widget w interfejsie Maps JavaScript API może zostać naliczona opłata za SKU Autocomplete – Per Request, 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 szt.)		 0,00227 USD za sztukę
(2,27 USD za 1000 sztuk)		 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 wywołania 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 – 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 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 wywołania 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.

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 szt.)		 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 działań:
    • 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 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 podstawowe (obciążenie 0,00 USD)
  2. Wykonaj jedno z tych działań:
    • 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 działań:
    • Urządzenie mobilne: wywołaj fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i wypełnij wszystkie pola.
    • Interfejs API internetowy lub usługa: wyślij żądanie Szczegóły miejsca i wskaż wszystkie pola (jeśli nie podasz żadnych pól, żądanie tego typu jest domyślne): getPlaceDetails().
    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 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 informacji o miejscu, 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 i wskazujesz 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 określasz pola ze wszystkich zasobników z danymi: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 interfejsie Maps JavaScript API (nearbySearch()) lub do usługi wyszukiwania miejsc w pobliżu w interfejsie 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 sztuk)		 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 dotyczące wyszukiwania w pobliżu zwracają podzbiór obsługiwanych pól danych. Zapytanie dotyczące wyszukiwania w pobliżu jest płatne. Cena za każde takie zapytanie zaczyna się od 0,032 USD. Opłata jest naliczana również za wszystkie SKU typu danych (Dane podstawowe, Dane kontaktowe i Dane o atmosferze).

Przykład

wysyłasz prośbę o wyszukiwanie 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 jest naliczane za żądania wysyłane do usługi wyszukiwania tekstu w miejscach w interfejsie Maps JavaScript API (textSearch()) lub do usługi wyszukiwania tekstu w miejscach w interfejsie 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 sztuk)		 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 tekstowe jest też generowane przez widżet Pole wyszukiwania miejsc interfejsu Maps JavaScript API: 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
W wynikach wyszukiwania w polu wyszukiwania widać, że obok 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: Miejsca na zdjęciu

Kod SKU Zdjęcie w miejscu 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 szt.)		 0,0056 USD za sztukę
(5,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Cennik usług związanych z JavaScriptem

Usługi związane z JavaScriptem są rozliczane osobno. Więcej informacji znajdziesz na stronie poświęconej korzystaniu z usługi i rozliczeniom:

Inne limity wykorzystania

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

  • 30 tys. żą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 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.

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 kwoty na wszystkie żądania 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 Google Maps Platform.
  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 kwoty do rozliczenia (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.