Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Nowy interfejs Places API (nowość) i Place API korzystają z modelu płatności według wykorzystania. Żądania do interfejsu Places API (nowość) i żądania do interfejsu Places API generują wywołania dowolnego z wielu kodów SKU. Oprócz ogólnych Warunków korzystania z usług Google obowiązują limity wykorzystania dotyczące interfejsu Places API. Zarządzaj kosztami i użytkowaniem za pomocą narzędzi dostępnych w konsoli Google Cloud.

Jak naliczane są opłaty za interfejs Places API

Interfejs Places API (nowość) i Place API korzystają z modelu płatności według wykorzystania. Interfejsy API i pakiety SDK Google Maps Platform są rozliczane według kodów SKU. Wykorzystanie jest śledzone dla każdego kodu SKU, a każdy interfejs API lub pakiet SDK może mieć więcej niż 1 kod SKU produktu. Sposób obliczania kosztów:

wykorzystanie kodu SKU × cena za wykorzystanie

Skorzystaj z naszego kalkulatora cen i wykorzystania, aby oszacować koszt wykorzystania interfejsu API lub pakietu SDK. W przypadku kwalifikujących się kodów SKU Google Maps Platform dostępne są co miesiąc środki w Google Maps Platform w wysokości 200 USD dla każdego konta rozliczeniowego. Te środki są automatycznie przyznawane1 w przypadku kwalifikujących się kodów SKU.

Cennik interfejsu Places API (nowość)

Informacje o maskach pól

W przypadku szczegółów miejsca (nowość), wyszukiwania w pobliżu (nowość) i wyszukiwania tekstowego (nowość) użyj nagłówka FieldMask w żądaniach interfejsu API, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Opłaty są naliczane według kodów SKU o najwyższej wartości, których dotyczy Twoje żądanie. Oznacza to, że jeśli wybierzesz pola zarówno w kodach SKU (podstawowe), jak i SKU (zaawansowane), opłaty będą naliczane na podstawie tego kodu SKU (zaawansowane).

Użycie maskowania pól to dobra praktyka projektowa, aby uniknąć żądania zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat rozliczanych.

Informacje o sesjach autouzupełniania (nowych)

Sesja autouzupełniania (nowa) obejmuje co najmniej 1 żądanie autouzupełniania (nowe) i maksymalnie 1 żądanie informacji o miejscu (Nowe) lub prośbę o weryfikację adresu. Ten sam token sesji jest przekazywany do żądania autouzupełniania (nowego) i późniejszego żądania szczegółów miejsca (nowych) lub weryfikacji adresu.

Sesja rozpoczyna się od pierwszego żądania autouzupełniania (nowego). Gdy użytkownik wybierze jedną z sugestii autouzupełniania, wysyła prośbę o szczegóły miejsca (nowe) lub weryfikację adresu. Jeśli sesja zostanie porzucona, czyli nie zostanie przesłane nowe informacje o miejscu ani prośba o weryfikację adresu, żądania autouzupełniania (nowe) są rozliczane tak, jakby nie zostały dostarczone żadne tokeny sesji.

Po wybraniu miejsca przez użytkownika (co oznacza wysłanie prośby o szczegóły miejsca (nowego) lub weryfikacji adresu) musisz rozpocząć nową sesję, korzystając z nowego tokena sesji.

Token sesji jest odpowiedni na jedną sesję i nie można go używać przez więcej niż jedną sesję. Jeśli ponownie użyjesz tokena sesji, sesja zostanie uznana za nieprawidłową, a żądania będą rozliczane tak, jakby nie podano żadnego tokena sesji.

SKU: żądania autouzupełniania

Kod SKU żądań autouzupełniania jest naliczany za każde żądanie wysyłane do nowego interfejsu API autouzupełniania, które nie zawiera tokena sesji.

Opłata będzie też naliczana, jeśli używasz tokenów sesji oraz:

  • Zakończ sesje za pomocą pojedynczego żądania przesłania szczegółów miejsca (nowego), które wysyła żądanie informacji o dowolnych polach zdefiniowanych przez kod SKU: Place Details (Location only).
    • Każde żądanie autouzupełniania (nowe) (maksymalnie 12) jest rozliczane według SKU: żądania autouzupełniania.
    • Każde kolejne żądanie autouzupełniania (nowe) jest rozliczane na podstawie kodu SKU: wykorzystanie sesji autouzupełniania.
  • Zakończ sesję lub zakończ ją, wywołując metodę SKU: Miejsce Szczegóły (tylko identyfikatory). Wszystkie żądania autouzupełniania (nowe) są następnie rozliczane za pomocą SKU: żądania autouzupełniania.
MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,00283 USD za każdą
(2,83 USD za 1000)
0,00227 USD za każdą
(2,27 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: wykorzystanie sesji autouzupełniania

Kod SKU wykorzystania autouzupełniania sesji jest naliczany za każde żądanie wysyłane do interfejsu API Autocomplete (nowego) interfejsu API, który zawiera token sesji.

Opłaty za ten kod SKU są naliczane w dwóch sytuacjach:

  • Sesja autouzupełniania zakończona przez połączenie z SKU: Szczegóły miejsca (tylko lokalizacja):

    • Każde żądanie autouzupełniania (nowe) (maksymalnie 12) jest rozliczane według SKU: żądania autouzupełniania.
    • Każde kolejne żądanie autouzupełniania (nowe) jest rozliczane na podstawie kodu SKU: wykorzystanie sesji autouzupełniania.
  • Sesja autouzupełniania zakończona wywołaniem funkcji SKU: Informacje o miejscu (podstawowe, zaawansowane lub preferowane) albo z odpowiedzią na kod SKU: preferowana weryfikacja adresu.

    Wywołanie informacji o miejscu, które wysyła żądanie dowolnego pola z kodu SKU: szczegóły miejsca (podstawowe, zaawansowane lub preferowane), jest rozliczane na podstawie kodu SKU: szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule o autouzupełnianiu (nowym) i cenach sesji.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,00 USD za każdą
(0,00 USD za 1000)
0,00 USD za każdą
(0,00 USD za 1000)
0,00 USD za każdą
(0,00 USD za 1000)

SKU: szczegóły miejsca (tylko identyfikatory)

Za pomocą maski lub listy pól w żądaniu szczegółów miejsca (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: id, name*, photos

* Pole name zawiera nazwę zasobu miejsca w formie: places/PLACE_ID. Użyj opcji displayName, by uzyskać dostęp do tekstowej nazwy miejsca.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,0 USD za każdą
(0,00 USD za 1000)
0,0 USD za każdą
(0,00 USD za 1000)
0,0 USD za każdą
(0,00 USD za 1000)

SKU: szczegóły miejsca (tylko lokalizacja)

Za pomocą maski lub listy pól w żądaniu szczegółów miejsca (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,005 USD za każdą
(5.00 USD za 1000)
0,004 USD za każdą
(4,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: Szczegóły miejsca (podstawowe)

Za pomocą maski lub listy pól w żądaniu szczegółów miejsca (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

Jeśli sesja autouzupełniania zostanie zakończona przez wywołanie informacji o miejscu, które wysyła żądanie dowolnego pola z kodu SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), opłata za połączenie jest naliczana według stawki SKU: Szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie sesji – wykorzystanie.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,0170 USD za każdą
(17,00 USD za 1000)
0,0136 USD za każdą
(13,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: Szczegóły miejsca (zaawansowane)

Za pomocą maski lub listy pól w żądaniu szczegółów miejsca (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

Jeśli sesja autouzupełniania zostanie zakończona przez wywołanie informacji o miejscu, które wysyła żądanie dowolnego pola z kodu SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), opłata za połączenie jest naliczana według stawki SKU: Szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie sesji – wykorzystanie.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,020 USD za każde
(20,00 USD za 1000)
0,016 USD za każdą
(16,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: szczegóły miejsca (preferowane)

Za pomocą maski lub listy pól w żądaniu szczegółów miejsca (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, allowsDogs, allowsDogs, reviews, reviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Jeśli sesja autouzupełniania zostanie zakończona przez wywołanie informacji o miejscu, które wysyła żądanie dowolnego pola z kodu SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane), opłata za połączenie jest naliczana według stawki SKU: Szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie sesji – wykorzystanie.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,025 USD za każde
(25,00 USD za 1000)
0,020 USD za każde
(20,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: Wyszukiwanie w pobliżu (podstawowe)

Używając maski lub listy pól w żądaniu Wyszukiwanie w pobliżu (nowe), możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name*, places.photos, places.plusCode, places.primaryType, {19/5, w tabeli places.accessibilityOptions w formie .places.nameplaces.primaryTypeDisplayNameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

places/PLACE_ID Użyj opcji places.displayName, by uzyskać dostęp do tekstowej nazwy miejsca.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,032 USD za każdą
(32,00 USD za 1000)
0,0256 USD za każdą
(25,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: Wyszukiwanie w pobliżu (zaawansowane)

Używając maski lub listy pól w żądaniu Wyszukiwanie w pobliżu (nowe), możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,035 USD za każdą
(35,00 USD za 1000)
0,028 USD za każde
(28,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: Wyszukiwanie w pobliżu (preferowane)

Używając maski lub listy pól w żądaniu Wyszukiwanie w pobliżu (nowe), możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.allowsDogs, places.allowsDogs, places.reviews, places.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,040 USD za każdą
(40,00 USD za 1000)
0,032 USD za każdą
(32,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstowe (tylko identyfikator)

Za pomocą maski lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.id, places.name*

* Pole places.name zawiera nazwę zasobu miejsca w formacie: places/PLACE_ID. Użyj opcji places.displayName, by uzyskać dostęp do tekstowej nazwy miejsca.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,0 USD za każdą
(0,00 USD za 1000)
0,0 USD za każdą
(0,00 USD za 1000)
0,0 USD za każdą
(0,00 USD za 1000)

SKU: wyszukiwanie tekstowe (podstawowe)

Za pomocą maski lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.utcOffsetMinutesplaces.viewport

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,032 USD za każdą
(32,00 USD za 1000)
0,0256 USD za każdą
(25,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstowe (zaawansowane)

Za pomocą maski lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,035 USD za każdą
(35,00 USD za 1000)
0,028 USD za każde
(28,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: wyszukiwanie tekstowe (preferowane)

Za pomocą maski lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do wskazanych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie dotyczące tych pól:

Usługa internetowa: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.allowsDogs, places.allowsDogs, places.reviews, places.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,040 USD za każdą
(40,00 USD za 1000)
0,032 USD za każdą
(32,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: zdjęcie miejsca

Kod SKU Place Photo jest naliczany za każde żądanie do interfejsu API.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,007 USD za każdą
(7,00 USD za 1000)
0,0056 USD za każdą
(5,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Cennik Places API

Sesje autouzupełniania

Sesja autouzupełniania może obejmować niektóre żądania autouzupełniania (pobiera sugestie dotyczące miejsca według typów użytkowników) i maksymalnie jedno żądanie szczegółów miejsca (służące do pobrania szczegółowych informacji o miejscu wybranym przez użytkownika). Ten sam token sesji jest przekazywany do autouzupełniania oraz kolejne żądanie szczegółów miejsca. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (co zwykle dzieje się, gdy użytkownik zaczyna pisać). Wywołanie informacji o miejscach następuje wtedy, gdy użytkownik wybierze jedną z sugestii autouzupełniania. Jeśli użytkownik nie wybierze sugestii, nie wykonywane jest żadne wywołanie Szczegóły miejsca.

Gdy użytkownik wybierze miejsce (tzn. wywoła wywołanie szczegółów Miejsc), musisz rozpocząć nową sesję z użyciem nowego tokena sesji.

Sesje autouzupełniania mogą być generowane za pomocą tych interfejsów API:

Token sesji jest odpowiedni na jedną sesję użytkownika i nie należy go używać na więcej niż 1 sesję użytkownika. Jeśli ponownie użyjesz tokena sesji, sesja zostanie uznana za nieprawidłową, a żądania będą rozliczane tak, jakby nie podano żadnego tokena sesji.

Żądania autouzupełniania i żądania informacji o miejscach korzystające z sesji są rozliczane według różnych kodów SKU.

Kody SKU danych o miejscach

Trzy kody SKU danych o miejscach to: dane podstawowe, dane kontaktowe i dane atmosfery.

Co najmniej 1 kod SKU danych został aktywowany dla:

  • Android: każde żądanie do fetchPlace() lub findCurrentPlace()
  • iOS: każde połączenie z numerem fetchPlaceFromPlaceID: lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Usługa internetowa: każde żądanie Miejsc, w zależności od pól określonych w żądaniu

Za kody SKU danych są zawsze naliczane opłaty oprócz podstawowego kodu SKU w przypadku żądania, które je uruchamia. Na przykład opłaty za żądanie informacji o miejscu uwzględniające pola podstawowych danych będą naliczane zarówno w ramach SKU danych podstawowych, jak i dotyczących informacji o miejscu.

W przypadku usługi internetowej te interfejsy Places API obsługują określanie pól danych do zwrócenia:

W przypadku usługi internetowej te wywołania interfejsów Places API NIE obsługują określania zwróconych pól. Te wywołania zawsze zwracają wszystkie dane Miejsc, dodając do opłaty za każde żądanie API 3 kody SKU danych Miejsc:


SKU: dane podstawowe

Za pomocą parametru pól w żądaniu „Szczegóły miejsca” lub „Znajdź miejsce” możesz ograniczyć odpowiedź tylko do podanych pól. Pola w kategorii Podstawowe są uwzględnione w kosztie podstawowym żądania Miejsca i nie powodują naliczania dodatkowych opłat. Kod SKU podstawowych danych jest wyzwalany, gdy wymagane jest dowolne z tych pól:

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET lub Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • 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
MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
Koszt żądania Miejsc
+ 0,00 USD
Koszt żądania Miejsc
+ 0,00 USD
Koszt żądania Miejsc
+ 0,00 USD

SKU: dane kontaktowe

Za pomocą parametru pól w żądaniu „Szczegóły miejsca” lub „Znajdź miejsce” w przypadku usług internetowych albo tablicy Place.Field w przypadku Androida lub iOS, możesz ograniczyć odpowiedź tylko do wskazanych pól. Pola w kategorii Kontakt wiążą się z dodatkową opłatą. Kod SKU danych kontaktowych jest wyzwalany, gdy wymagane jest dowolne z tych pól:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, 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
MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
Koszt żądania Miejsc
+ 0,003 USD za każde
(+ 3,00 USD za 1000)
Koszt żądania Miejsc
+ 0,0024 USD za każdą sztukę
(+ 2,40 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: dane dotyczące atmosfery

Za pomocą parametru pól w żądaniu „Szczegóły miejsca” lub „Znajdź miejsce” możesz ograniczyć odpowiedź tylko do wskazanych pól. Pola w kategorii Atmosfera wiążą się z dodatkową opłatą. Kod SKU atmosfery jest wywoływany, gdy wymagane jest dowolne 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_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch lub GMSPlaceFieldServesVegetarianFood.
  • JavaScript: patrz 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.
MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
Koszt żądania Miejsc
+ 0,005 USD za każde
(+ 5,00 USD za 1000)
Koszt żądania Miejsc
+ 0,004 USD za każdą sztukę
(+ 4,00 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

SKU: autouzupełnianie – na żądanie

Kod SKU autouzupełniania – na żądanie jest obciążany za każde z tych wywołań lub żądań niezawierających tokena sesji:

Za połączenia nawiązane w wyniku nieprawidłowej sesji autouzupełniania (np. sesji, w której został użyty token sesji) też pobierana jest opłata za autouzupełnianie (kod SKU według żądania).

Żądania autouzupełniania pochodzące z widżet autouzupełniania interfejsu Maps JavaScript API mogą podlegać opłatom SKU według żądania autouzupełniania, w przypadku gdy wywołania są wysyłane z nieprawidłowej sesji autouzupełniania. Może się tak zdarzyć, gdy użytkownik wpisuje wiele adresów lub kopiuje i wkleja różne adresy do widżetu i nie zawsze wybierze podpowiedź autouzupełniania.

MIESIĘCZNY ZAKRES LICZBY
(cena za ŻĄDANIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,00283 USD za każdą
(2,83 USD za 1000)
0,00227 USD za każdą
(2,27 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

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

Kod SKU autouzupełniania bez szczegółów miejsca jest naliczany za sesję autouzupełniania, która nie zawiera prośby o szczegóły miejsca (w ciągu kilku minut przed jej rozpoczęciem).

MIESIĘCZNY ZAKRES
(cena za SESJĘ)
0–100 000 100 001–500 000 Ponad 500 tys.
0,017 USD za każdą
(17,00 USD za 1000)
0,0136 USD za każdą
(13,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Przykład

Jeśli Twoja aplikacja wysyła te 2 wywołania w ramach jednej sesji:

Android

iOS

Usługa sieciowa

Na rachunku zobaczysz ten kod SKU (podczas wyświetlania rachunku według kodu SKU):

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

SKU: autouzupełnianie (wraz ze szczegółami miejsca) – na sesję

Kod SKU Autouzupełnianie (wraz ze szczegółami miejsca) jest naliczany za sesję autouzupełniania, która obejmuje:

  • Android: połączenie z numerem fetchPlace()
  • iOS: połączenie z numerem fetchPlaceFromPlaceID:
  • Usługa internetowa: żądanie dotyczące informacji o miejscu.

Żądanie autouzupełniania jest dostępne bezpłatnie, a kolejne połączenie z informacjami o miejscu jest rozliczane według standardowego cennika Szczegółów miejsca.

Żądanie informacji o miejscu generuje kody SKU danych (Podstawowe, Kontakt lub Atmosfera) w zależności od pól określonych w żądaniu.

Jeśli nie określisz pól w żądaniu informacji o miejscu, uruchamiane zostaną wszystkie kody SKU danych (podstawowe, kontaktowe i atmosferyczne).

Żądania odświeżenia identyfikatora miejsca (prośby, które określają tylko pole place_id) podczas sesji autouzupełniania są rozliczane jako SKU: Autocomplete bez informacji o miejscu – na sesję.

MIESIĘCZNY ZAKRES
(cena za SESJĘ)
0–100 000 100 001–500 000 Ponad 500 tys.
0.00 PLN 0.00 PLN 0.00 PLN

Przykład

Jeśli Twoja aplikacja wysyła te 3 wywołania w ramach jednej sesji:

Android

iOS

Usługa sieciowa

Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):

  • Autouzupełnianie (wraz ze szczegółami miejsca) – za sesję (opłata w wysokości 0,00 USD)
  • Szczegóły miejsca (cena od 0,017 USD za sesję)
  • Basic Data (opłata w wysokości 0,00 USD)

SKU: autouzupełnianie zapytania – według żądania

Kod SKU autouzupełniania zapytań – na żądanie jest naliczany za każde żądanie w celu:

MIESIĘCZNY ZAKRES LICZBY
(cena za ŻĄDANIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,00283 USD za każdą
(2,83 USD za 1000)
0,00227 USD za każdą
(2,27 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Ceny na podstawie sesji autouzupełniania nie są obsługiwane w przypadku autouzupełniania zapytań. Opłaty za kolejne połączenia w usłudze Szczegóły miejsca są naliczane według standardowego cennika Szczegóły miejsca.


SKU: szczegóły dotyczące miejsca

Opłaty za połączenia w funkcji Szczegóły miejsca są naliczane w następujący sposób:

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,017 USD za każdą
(17,00 USD za 1000)
0,0136 USD za każdą
(13,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Kod SKU informacji o miejscu jest generowany przy użyciu tych interfejsów API:

W przypadku internetowego interfejsu API i usług opłaty za SKU Szczegóły miejsca są naliczane niezależnie od tego, czy token sesji zostanie udostępniony, czy nie.

Wywołanie lub żądanie informacji o miejscu generuje też kody SKU danych (Podstawowe, Kontakt lub Atmosfera), w zależności od pól określonych w rozmowie lub żądaniu. Jeśli w wywołaniu lub żądaniu informacji o miejscu określono pola NO, uruchamiane są WSZYSTKIE kody SKU danych. Opłaty zostaną naliczone za wywołanie lub żądanie Szczegóły miejsca powiększone o koszt wszystkich danych.

Przykłady

  1. Wykonaj jedno z tych połączeń lub próśb:
    • Urządzenie mobilne: wywołaj fetchPlace() na urządzeniu z Androidem lub fetchPlaceFromPlaceID: na urządzeniu z iOS i podaj tylko pole ADDRESS
    • Internetowy interfejs API lub usługa: wyślij żądanie informacji o miejscu i podaj tylko pole adresu: getPlaceDetails(fields: formatted_address)
    Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):
    • Szczegóły miejsca (cena od 0,017 USD za sesję)
    • Basic Data (opłata w wysokości 0,00 USD)
  2. Wykonaj jedno z tych połączeń lub próśb:
    • Urządzenie mobilne: wywołaj fetchPlace() na urządzeniu z Androidem lub fetchPlaceFromPlaceID: na urządzeniu z iOS i podaj tylko pole PHONE_NUMBER
    • Internetowy interfejs API lub usługa: wyślij żądanie informacji o miejscu i podaj w nim pole numeru telefonu: getPlaceDetails(fields: formatted_phone_number)
    Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):
    • Szczegóły miejsca (cena od 0,017 USD za sesję)
    • Dane kontaktowe (cena od 0,003 USD za żądanie)
  3. Wykonaj jedno z tych połączeń lub próśb:
    • Urządzenie mobilne: wywołaj fetchPlace() na urządzeniu z Androidem lub fetchPlaceFromPlaceID: na urządzeniu z iOS i podaj wszystkie pola
    • Internetowy interfejs API lub usługa: wyślij żądanie informacji o miejscu i określ wszystkie pola (jeśli nie określisz żadnych pól, ten typ żądania jest domyślny): getPlaceDetails().
    Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):
    • Szczegóły miejsca (cena od 0,017 USD za sesję)
    • Basic Data (opłata w wysokości 0,00 USD)
    • Dane kontaktowe (cena od 0,003 USD za żądanie)
    • Dane atmosfery (cena od 0,005 USD za żądanie)

SKU: szczegóły miejsca – odświeżanie identyfikatora

Użyj żądania Szczegóły miejsca, aby odświeżyć nieaktualne identyfikatory miejsc. Tego typu prośby są dostępne bezpłatnie.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0.00 PLN 0.00 PLN 0.00 PLN

Przykład

Utwórz żądanie informacji o miejscu, podając tylko pole identyfikatora miejsca: getPlaceDetails(fields: place_id). Na rachunku zobaczysz ten kod SKU (podczas wyświetlania rachunku według kodu SKU):

  • Szczegóły miejsca – odświeżenie identyfikatora (opłata 0,00 USD)

SKU: Znajdź miejsce

Usługa Znajdź miejsce jest naliczana za żądanie Znajdź miejsce.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,017 USD za każdą
(17,00 USD za 1000)
0,0136 USD za każdą
(13,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Prośby o znalezienie miejsca generują też kody SKU danych (podstawowe, kontakt lub atmosfera), w zależności od pól określonych w żądaniu. Podobnie jak w przypadku żądań szczegółów miejsca, możesz użyć parametru Pola w żądaniu Znajdź miejsce, aby ograniczyć odpowiedź tylko do wskazanych pól. Opłaty są naliczane za żądanie Znajdź miejsce oraz za żądane dane. Domyślnie, jeśli wymagane jest podanie pól NIE, zwracany jest tylko identyfikator miejsca, więc nie są pobierane żadne dodatkowe opłaty za dane.

Przykłady

  1. Wysyłasz żądanie Znajdź miejsce i określasz 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)
    • Basic Data (opłata w wysokości 0,00 USD)
  2. Wysyłasz prośbę o znajdowanie miejsca i określasz 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 od 0,003 USD za żądanie)
  3. Tworzysz żądanie Znajdź miejsce i określasz pola ze wszystkich 3 zasobników typów danych: FindPlace(fields: formatted_address, opening_hours, price_level). Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):
    • Znajdź miejsce (cena od 0,017 USD za połączenie)
    • Basic Data (opłata w wysokości 0,00 USD)
    • Dane kontaktowe (cena od 0,003 USD za żądanie)
    • Dane atmosfery (cena od 0,005 USD za żądanie)

SKU: Znajdź miejsce – tylko identyfikator

Usługa Znajdź miejsce – tylko identyfikator jest naliczana za żądania Znajdź miejsce, które zawierają jedynie identyfikator miejsca do zwrócenia. Jeśli w żądaniu Znajdź miejsce nie określono żadnych pól, domyślnie zwracany jest tylko identyfikator miejsca.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0.00 PLN 0.00 PLN 0.00 PLN

Przykład

Wysyłasz żądanie Znajdź miejsce i określasz tylko pole place_id: FindPlace(fields: place_id). Na rachunku zobaczysz ten kod SKU (podczas wyświetlania rachunku według kodu SKU):

  • Znajdź miejsce – tylko dokument tożsamości (opłata 0,00 USD)

Miejsce – wyszukiwanie w pobliżu jest obciążane opłatami za żądania wysyłane do usługi wyszukiwania miejsc w pobliżu dostępnej w interfejsie Maps JavaScript API (nearbySearch()) lub usługi wyszukiwania w pobliżu w interfejsie Places API.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,032 USD za każdą
(32,00 USD za 1000)
0,0256 USD za każdą
(25,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Żądania wyszukiwania w pobliżu zwracają listę miejsc, ale nie obsługują określania, które pola mają zostać zwrócone. Żądania wyszukiwania w pobliżu zwracają podzbiór obsługiwanych pól danych. Opłaty za wyszukiwanie w pobliżu zaczynają się od 0,032 USD za każde wyszukiwanie oraz wszystkie kody SKU danych (Dane podstawowe, Dane kontaktowe i Dane atmosfery).

Przykład

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

  • Miejsce – Wyszukiwanie w pobliżu (cena od 0,032 USD za połączenie)
  • Basic Data (opłata w wysokości 0,00 USD)
  • Dane kontaktowe (cena od 0,003 USD za żądanie)
  • Dane atmosfery (cena od 0,005 USD za żądanie)

Usługa Place – wyszukiwanie tekstowe jest obciążana opłatami za żądania wysyłane do usługi Place Text Search API (textSearch()) lub usługi wyszukiwania tekstu w interfejsie Places API.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,032 USD za każdą
(32,00 USD za 1000)
0,0256 USD za każdą
(25,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Żądania wyszukiwania tekstowego zwracają listę miejsc, ale nie umożliwiają określania, które pola mają zostać zwrócone. Żądania wyszukiwania tekstowego zwracają podzbiór obsługiwanych pól danych. Opłaty za żądanie wyszukiwania tekstowego wynoszą już 0,032 PLN za każde żądanie oraz wszystkie kody SKU typu danych (Dane podstawowe, Dane kontaktowe i Dane atmosfery).

Kod SKU Place – Text Search także jest generowany przez widżet Place SearchBox interfejsu Maps JavaScript API: getPlaces() po wybraniu przez użytkownika zapytania o miejsce (ikona: lupa), a nie wyniku (ikona: pinezka), jak widać tutaj:

Wybór zapytania widżetu w polu wyszukiwania szczegółów miejsca
Po wpisaniu „pizza” w wynikach wyświetlonego w polu wyszukiwania w polu wyszukiwania pojawi się ikona lupy, która oznacza zapytanie o miejsce (a nie wynik).

Przykład

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

  • Miejsce – wyszukiwanie tekstowe (cena od 0,032 PLN za połączenie)
  • Basic Data (opłata w wysokości 0,00 USD)
  • Dane kontaktowe (cena od 0,003 USD za żądanie)
  • Dane atmosfery (cena od 0,005 USD za żądanie)

SKU: zdjęcie miejsca

Kod SKU Place Photo jest płatny:

  • Android: połączenia z numerem fetchPhoto()
  • iOS: połączenia z numerem loadPlacePhoto:
  • JavaScript:do biblioteki Miejsc, usługi Place Photos API Map Google, gdy wysyłasz żądanie danych z adresów URL zwróconych przez PlacePhoto.getUrl() w celu wczytania danych pikseli obrazu.
  • Usługa internetowa: żądania wysyłane do usługi Places API Place Photos

W przypadku usługi JavaScript wywołanie metody PlacePhoto.getUrl() nie powoduje naliczania opłat, dopóki adres URL nie zostanie faktycznie użyty do pozyskania danych piksela.

MIESIĘCZNY ZAKRES
(cena za POŁĄCZENIE)
0–100 000 100 001–500 000 Ponad 500 tys.
0,007 USD za każdą
(7,00 USD za 1000)
0,0056 USD za każdą
(5,60 USD za 1000)
Aby dowiedzieć się więcej o cenach hurtowych, skontaktuj się z zespołem sprzedaży.

Inne limity wykorzystania

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

  • Places API (nowość): limit żądań wynosi 600 QPM (żądania na minutę) na metodę interfejsu API w projekcie. Oznacza to, że każda metoda interfejsu API ma osobny limit.

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

Ograniczenia w Warunkach korzystania z usługi

Informacje o warunkach korzystania z usługi znajdziesz w zasadach dotyczących interfejsu Places API i w sekcji z ograniczeniami licencji w Warunkach korzystania z Google Maps Platform.

Zarządzanie kosztami korzystania

Aby zarządzać kosztami korzystania z interfejsu Places API lub zaspokoić potrzeby ruchu produkcyjnego, określ limity dzienne dla wszystkich żądań wysyłanych do dowolnego interfejsu API. Dzienne limity są resetowane o północy czasu pacyficznego.

Aby wyświetlić lub zmienić limity dla interfejsu Places API:

  1. W konsoli Cloud otwórz stronę Limity Google Maps Platform.
  2. Kliknij menu interfejsów API i wybierz Places API.
  3. Aby wyświetlić limity, przewiń w dół do karty Żądania.
    W tabeli znajdziesz nazwy i limity limitów.
  4. Aby zmienić limit, kliknij obok niego ikonę Edytuj.
    W wyświetlonym oknie w polu Limit limitu wpisz preferowany dzienny limit podlegający rozliczeniu (do osiągnięcia limitu określonego przez Google, jeśli taki istnieje) i kliknij Zapisz.

Jeśli w danym dniu wykorzystanie interfejsu API osiągnie limit rozliczany, aplikacja nie będzie mogła uzyskać do niego dostępu do końca tego dnia.


  1. Aby otrzymać środki na Maps Platform, użytkownicy z Indii muszą utworzyć konto rozliczeniowe Google Cloud Platform, zanim utworzą konto rozliczeniowe Google Maps Platform.