Jak jest rozliczany interfejs Places API
W interfejsach Places API (nowość) i Places API stosuje model cenowy płatności według wykorzystania. Interfejsy API i pakiety SDK Google Maps Platform są rozliczane według kodów SKU. Wykorzystanie 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 usługi. Koszt jest obliczany według wzoru:
Aby oszacować koszt wykorzystania na interfejs API lub pakiet SDK, użyj naszego kalkulatora cen i użytkowania. W przypadku kwalifikujących się kodów SKU Google Maps Platform co miesiąc na każdym koncie rozliczeniowym dostępne jest środki na Google Maps Platform w wysokości 200 USD. Te środki są automatycznie dodawane do kwalifikujących się kodów SKU.
Ceny interfejsu Places API (nowość)
Informacje o maskach pól
W przypadku informacji o miejscach (nowość), wyszukiwania w pobliżu (nowość) i wyszukiwania tekstowego (nowego) użyj nagłówka FieldMask
w żądaniach interfejsu API, aby określić listę pól, które mają zwrócić odpowiedź. Następnie naliczymy opłatę w wysokości najwyższej jednostki SKU odpowiedniej dla Twojego żądania. Oznacza to, że jeśli wybierzesz pola zarówno w kodzie SKU (Podstawowy), jak i SKU (Zaawansowane), opłaty będą naliczane na podstawie kodu SKU (Zaawansowane).
Maskowanie pól to sprawdzona metoda projektowania, dzięki której nie żądasz zbędnych danych. Pozwala to uniknąć niepotrzebnego czasu przetwarzania i opłat.
Sesje autouzupełniania (nowe) – informacje
Sesja autouzupełniania (nowa) obejmuje co najmniej jedno nowe żądanie autouzupełniania oraz prośbę o szczegóły miejsca (nowe) lub weryfikację adresu. Ten sam token sesji jest przekazywany do żądania autouzupełniania (nowego) i kolejnego żądania szczegółów miejsca (nowe) albo prośby o weryfikację adresu.
Sesja rozpoczyna się od pierwszego (nowego) żądania autouzupełniania. Żądanie przesłania informacji o miejscu (nowe) lub prośby o weryfikację adresu jest wysyłane, gdy użytkownik wybierze jedną z sugestii autouzupełniania (nowych). Jeśli sesja zostanie porzucona, czyli nie zostanie przesłane żądanie dotyczące informacji o miejscu (nowe) ani prośby o weryfikację adresu, za żądania autouzupełniania (nowe) będą naliczane opłaty tak, jakby nie podano tokena sesji.
Po wybraniu miejsca przez użytkownika (czyli zgłoszeniu prośby o dostęp do informacji o miejscu (nowego) lub weryfikacji adresu, trzeba rozpocząć nową sesję przy użyciu nowego tokena sesji.
Token sesji jest odpowiedni dla jednej sesji i nie można go użyć na więcej niż 1 sesję. Jeśli użyjesz tego samego tokena sesji, sesja zostanie uznana za nieprawidłową, a za żądania będą naliczane opłaty, jakby żaden token sesji nie został udostępniony.
SKU: żądania autouzupełniania
Za każde żądanie wysyłane do interfejsu API autouzupełniania (nowe) bez tokena sesji naliczana jest opłata SKU żądania autouzupełniania.
Opłata jest naliczana również wtedy, gdy używasz tokenów sesji oraz:
- Zakończ sesje pojedynczym żądaniem wyświetlenia szczegółów (nowe), które obejmuje pola zdefiniowane w ustawieniu SKU: informacje o miejscu (tylko lokalizacja).
- Każde nowe żądanie autouzupełniania (maksymalnie 12 żądań) jest rozliczane z wykorzystaniem SKU: żądania autouzupełniania.
- Każde kolejne żądanie autouzupełniania (nowe) jest rozliczane z wykorzystaniem modelu SKU: autouzupełnianie sesji.
- Porzuć sesję lub zakończ ją, wywołując SKU: informacje o miejscu (tylko identyfikatory). Wszystkie nowe (nowe) żądania autouzupełniania są rozliczane za pomocą SKU: żądania autouzupełniania.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,00283 USD za sztukę (2,83 USD za 1000) |
0,00227 USD za sztukę (2,27 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: wykorzystanie sesji autouzupełniania
Za każde żądanie wysłane do (nowego) interfejsu API autouzupełniania, które zawiera token sesji, naliczana jest opłata SKU autouzupełniania sesji.
Ten kod SKU jest obciążany w tych sytuacjach:
Sesja autouzupełniania zakończyła się wywołaniem kodu SKU: informacje o miejscu (tylko lokalizacja):
- Każde nowe żądanie autouzupełniania (maksymalnie 12 żądań) jest rozliczane z wykorzystaniem SKU: żądania autouzupełniania.
- Każde kolejne żądanie autouzupełniania (nowe) jest rozliczane z wykorzystaniem modelu SKU: autouzupełnianie sesji.
Sesja autouzupełniania zakończyła się wywołaniem kodu SKU: Informacje o miejscu (podstawowe, zaawansowane lub preferowane).
Wywołanie dotyczące informacji o miejscu, które wymaga podania dowolnego pola z pola SKU: Place Details (podstawowe, zaawansowane lub preferowane) jest rozliczane na podstawie SKU: szczegóły miejsca (preferowane).
Sesja autouzupełniania zakończyła się wywołaniem SKU: preferowana weryfikacja adresu.
Więcej informacji znajdziesz w artykule o autouzupełnianiu (nowym) i cenach sesji.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,00 USD za każde (0,00 USD za 1000) |
0,00 USD za każde (0,00 USD za 1000) |
0,00 USD za każde (0,00 USD za 1000) |
SKU: szczegóły miejsca (tylko identyfikatory)
Przy użyciu maski pola lub listy pól w żądaniu informacji o miejscu (nowych) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest aktywowany tylko wtedy, gdy wysyłasz żądanie tylko tych pól:
Usługa internetowa:
attributions
,
id
,
name
*,
photos
*
Pole name
zawiera nazwę zasobu
w formacie: places/PLACE_ID
. Użyj displayName
, aby uzyskać dostęp do tekstowej nazwy miejsca.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,0 USD za każde (0,00 USD za 1000) |
0,0 USD za każde (0,00 USD za 1000) |
0,0 USD za każde (0,00 USD za 1000) |
SKU: szczegóły miejsca (tylko lokalizacja)
Przy użyciu maski pola lub listy pól w żądaniu informacji o miejscu (nowych) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko tych pól:
Usługa internetowa: addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, shortFormattedAddress
, types
, viewport
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,005 USD za każde (5,00 USD za 1000) |
0,004 USD za każde (4,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: Szczegóły miejsca (podstawowe)
Przy użyciu maski pola lub listy pól w żądaniu informacji o miejscu (nowych) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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 zażąda dowolnego pola z poziomu SKU: Informacje o miejscu (podstawowe, zaawansowane lub preferowane), połączenie będzie rozliczane na podstawie SKU: szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: autouzupełnianie: wykorzystanie sesji.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,0170 USD za sztukę (17,00 USD za 1000) |
0,0136 USD za sztukę (13,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: szczegóły miejsca (zaawansowane)
Przy użyciu maski pola lub listy pól w żądaniu informacji o miejscu (nowych) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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 zażąda dowolnego pola z poziomu SKU: Informacje o miejscu (podstawowe, zaawansowane lub preferowane), połączenie będzie rozliczane na podstawie SKU: szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: autouzupełnianie: wykorzystanie sesji.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,020 USD za każde (20,00 USD za 1000) |
0,016 USD za każde (16,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: informacje o miejscu (preferowane)
Przy użyciu maski pola lub listy pól w żądaniu informacji o miejscu (nowych) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko tych pól:
Usługa internetowa:
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
, restroom
, , reviews
, restroom
, {19servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Jeśli sesja autouzupełniania zostanie zakończona przez wywołanie informacji o miejscu, które zażąda dowolnego pola z poziomu SKU: Informacje o miejscu (podstawowe, zaawansowane lub preferowane), połączenie będzie rozliczane na podstawie SKU: szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: autouzupełnianie: wykorzystanie sesji.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,025 USD za każde (25,00 USD za 1000) |
0,020 USD za każde (20,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: Wyszukiwanie w pobliżu (podstawowe)
Przy użyciu maski pól lub listy pól w żądaniu funkcji Wyszukiwanie w pobliżu (nowe) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko tych pól:
Usługa internetowa:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
/ , , places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
, {/19/},
places.plusCode
, places.primaryType
,{/2.}
places.primaryTypeDisplayName
, places.primaryType
,{/2.places.formattedAddress
places.googleMapsUri
places.name
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
Użyj places.displayName
, aby uzyskać dostęp do tekstowej nazwy miejsca.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,032 USD za każde (32,00 USD za 1000) |
0,0256 USD za sztukę (25,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: Wyszukiwanie w pobliżu (zaawansowane)
Przy użyciu maski pól lub listy pól w żądaniu funkcji Wyszukiwanie w pobliżu (nowe) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,035 USD za każde (35,00 USD za 1000) |
0,028 USD za każde (28,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: Wyszukiwanie w pobliżu (preferowane)
Przy użyciu maski pól lub listy pól w żądaniu funkcji Wyszukiwanie w pobliżu (nowe) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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.restroom
, {19places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,040 USD za każde (40,00 USD za 1000) |
0,032 USD za każde (32,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: wyszukiwanie tekstowe (tylko identyfikator)
Przy użyciu maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko tych pól:
Usługa internetowa:
places.attributions
,
places.id
,
places.name
*,
nextPageToken
*
Pole places.name
zawiera nazwę zasobu
w formacie: places/PLACE_ID
. Użyj places.displayName
, aby uzyskać dostęp do tekstowej nazwy miejsca.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,0 USD za każde (0,00 USD za 1000) |
0,0 USD za każde (0,00 USD za 1000) |
0,0 USD za każde (0,00 USD za 1000) |
SKU: wyszukiwanie tekstowe (podstawowe)
Przy użyciu maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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
, {20places.utcOffsetMinutes
places.viewport
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,032 USD za każde (32,00 USD za 1000) |
0,0256 USD za sztukę (25,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: wyszukiwanie tekstowe (zaawansowane)
Przy użyciu maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,035 USD za każde (35,00 USD za 1000) |
0,028 USD za każde (28,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: wyszukiwanie tekstowe (preferowane)
Przy użyciu maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowego) możesz ograniczyć odpowiedź tylko do określonych pól. Kod SKU jest wyzwalany tylko wtedy, gdy wysyłasz żądanie tylko 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.restroom
, {19places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,040 USD za każde (40,00 USD za 1000) |
0,032 USD za każde (32,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: zdjęcie miejsca
Za każde żądanie wysyłane do interfejsu API naliczana jest opłata SKU Place Photo.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,007 USD za każde (7,00 USD za 1000) |
0,0056 USD za sztukę (5,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Cennik interfejsu Places API
Informacje o sesjach autouzupełniania
Sesja autouzupełniania obejmuje niektóre żądania autouzupełniania (które pobierają sugestie dotyczące miejsca w miarę wpisywania przez użytkownika) i maksymalnie jedno żądanie szczegółów miejsca (do pobrania szczegółowych informacji o miejscu wybranym przez użytkownika). Ten sam token sesji jest przekazywany do autouzupełniania i kolejnego żądania szczegółów miejsca. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (zwykle ma to miejsce, gdy użytkownik zaczyna pisać). Połączenie ze szczegółami miejsc jest nawiązywane, gdy użytkownik wybierze jedną z sugestii autouzupełniania. Jeśli użytkownik nie wybierze sugestii, nie zostanie nawiązane połączenie z informacjami o miejscach.
Po wybraniu miejsca przez użytkownika (tj. wywołaniem informacji o miejscach) trzeba rozpocząć nową sesję przy użyciu nowego tokena sesji.
Sesje autouzupełniania można generować za pomocą tych interfejsów API:
- Usługa autouzupełniania miejsc interfejsu Places API lub usługa autouzupełniania miejsc w interfejsie Maps JavaScript API. Musisz zaprojektować swoją aplikację tak, aby dostarczała tokeny sesji (może być konieczna zmiana istniejącego kodu).
- Widżet autouzupełniania interfejsu Maps JavaScript API. Płatności na podstawie sesji są automatycznie włączone w tych widżetach, bez konieczności zmiany kodu.
Token sesji jest odpowiedni dla jednej sesji użytkownika i nie należy go używać dla więcej niż jednej sesji użytkownika. Jeśli użyjesz tego samego tokena sesji, sesja zostanie uznana za nieprawidłową, a za żądania będą naliczane opłaty, jakby żaden token sesji nie został udostępniony.
Żądania autouzupełniania i żądania szczegółów miejsc w ramach sesji są rozliczane według różnych kodów SKU.
Informacje o kodach 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 wysłane do
fetchPlace()
lubfindCurrentPlace()
- iOS: każde połączenie z numerem
fetchPlaceFromPlaceID:
lubfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Usługa internetowa: każde żądanie Miejsc w zależności od pól określonych w żądaniu.
Kody SKU danych są zawsze naliczane dodatkowo do podstawowego kodu SKU żądania, które je aktywuje. Na przykład żądanie dotyczące informacji o miejscu, które obejmuje pola danych podstawowych, zostanie obciążone zarówno w ramach kodu SKU danych podstawowych, jak i kodu SKU szczegółów miejsca.
W przypadku usługi internetowej te wywołania interfejsów API Miejsc obsługują określanie pól danych do zwrócenia:
W przypadku usługi internetowej te wywołania interfejsów API Miejsc NIE obsługują określania zwróconych pól. Te wywołania zawsze zwracają wszystkie dane z Miejsc, naliczając przy tym opłatę za każde żądanie do interfejsu API, dodając 3 kody SKU danych o miejscach:
SKU: dane podstawowe
Korzystając z parametru pól w żądaniu informacji o miejscu lub funkcji Znajdź miejsce, możesz ograniczyć odpowiedź tylko do określonych pól. Pola z kategorii Podstawowe są uwzględniane w podstawowym koszcie żądania Miejsc i nie wiążą się z żadnymi dodatkowymi opłatami. Kod SKU danych podstawowych jest wyzwalany po zażądaniu dowolnego 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
lubPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
lubGMSPlaceFieldViewport
-
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
lubwheelchair_accessible_entrance
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
Koszt zapytania dotyczącego Miejsc + 0,00 USD |
Koszt zapytania dotyczącego Miejsc + 0,00 USD |
Koszt zapytania dotyczącego Miejsc + 0,00 USD |
SKU: dane kontaktowe
Korzystając z parametru pól w żądaniu informacji o miejscu lub w żądaniu Znajdź miejsce w przypadku usług internetowych albo tablicy Place.Field
w Androidzie lub iOS, możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Kontakt skutkują dodatkową opłatą. Kod SKU danych kontaktowych jest wywoływany, 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
lubPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
lubGMSPlaceFieldWebsite
-
Usługa internetowa:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
lubwebsite
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
Koszt żądania związanego z miejscami + 0,003 USD za sztukę (+3,00 USD za 1000) |
Koszt żądania związanego z miejscami + 0,0024 USD za sztukę (+2,40 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: Dane atmosfery
Za pomocą parametru pól w żądaniu dotyczącym miejsca lub funkcji Znajdź miejsce możesz ograniczyć odpowiedź tylko do określonych pól. W przypadku pól w kategorii Atmosfera naliczana jest dodatkowa opłata. Kod SKU danych atmosfery jest wyzwalany po zażądaniu dowolnego z tych pól:
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
lubPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
lubGMSPlaceFieldServesVegetarianFood
. - 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
lubuser_ratings_total
.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
Koszt prośby o miejsca + 0,005 USD za sztukę (+ 5,00 USD za 1000) |
Koszt żądania związanego z miejscami + 0,004 USD za sztukę (+4,00 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: autouzupełnianie – według żądania
Kod SKU Autouzupełnianie – według żądania jest obciążany płatnością za każde z tych połączeń lub żądań, które nie zawierają tokena sesji:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: usługa autouzupełniania miejsc w interfejsie Maps JavaScript API.
- Usługa internetowa: usługa autouzupełniania miejsc interfejsu Places API.
Za połączenia nawiązane z nieprawidłowej sesji autouzupełniania (np. gdy sesja wykorzystuje token sesji) też jest naliczana opłata za autouzupełnianie według kodu SKU.
Żądania autouzupełniania pochodzące z widżetu autouzupełniania miejsc interfejsu Maps JavaScript API mogą powodować naliczanie opłaty za funkcję autouzupełniania zgodnie z kodem SKU na żądanie w przypadku połączeń pochodzących z nieprawidłowej sesji autouzupełniania. Może się tak zdarzyć, gdy użytkownik wpisuje wiele różnych adresów lub kopiuje i wkleja różne adresy w widżecie i nie zawsze wybiera podpowiedź autouzupełniania.
ZAKRES MIESIĘCZNY (cena za ŻĄDANIE) |
||
---|---|---|
0,00283 USD za sztukę (2,83 USD za 1000) |
0,00227 USD za sztukę (2,27 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
SKU: autouzupełnianie bez informacji o miejscu – według sesji
Kod SKU Autouzupełnianie bez informacji o miejscu – za sesję jest obciążany płatnością za sesję autouzupełniania, która nie zawiera prośby o informacje o miejscu (w ciągu kilku minut przed jej rozpoczęciem).
ZAKRES MIESIĘCZNY (cena za SESJĘ) |
||
---|---|---|
0,017 USD za każde (17,00 USD za 1000) |
0,0136 USD za sztukę (13,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Przykład
Jeśli Twoja aplikacja wywoła te 2 wywołania w ramach jednej sesji:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Usługa sieciowa
- Żądanie autouzupełniania miejsca (input=”par”, session_token: XYZ)
- Żądanie autouzupełniania miejsca (input=”paris”, session_token: XYZ)
Na rachunku będzie widoczny ten kod SKU (podczas wyświetlania rachunku według kodu SKU):
- Autouzupełnianie bez informacji o miejscu – za sesję (cena od 0,017 USD za sesję)
SKU: autouzupełnianie (w tym ze szczegółami miejsca) – według sesji
Autouzupełnianie (wraz ze szczegółami miejsca) – za sesję Kod SKU jest obciążany za sesję autouzupełniania, w której występują:
- Android: połączenie z numerem
fetchPlace()
- iOS: połączenie z numerem
fetchPlaceFromPlaceID:
- Usługa internetowa: prośba o szczegóły miejsca.
Żądanie autouzupełniania jest dostępne bez opłat, a za kolejne połączenie ze szczegółami miejsca naliczana jest opłata na podstawie standardowych cen dotyczących szczegółów miejsca.
Żądanie dotyczące 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, zostaną aktywowane wszystkie kody SKU danych (podstawowe, kontaktowe i atmosfera).
Żądania odświeżenia identyfikatora szczegółów miejsca (żądania, które zawierają tylko pole place_id
) podczas sesji autouzupełniania są rozliczane jako SKU: autouzupełnianie bez szczegółów miejsca – według sesji.
ZAKRES MIESIĘCZNY (cena za SESJĘ) |
||
---|---|---|
0.00 PLN | 0.00 PLN | 0.00 PLN |
Przykład
Jeśli Twoja aplikacja wywoła te 3 wywołania w ramach jednej sesji:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (z wartością
FetchPlaceRequest
zawierającą identyfikator miejsca i pole ADRES),
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(zawiera identyfikator miejsca i pole
GMSPlaceFieldFormattedAddress
)
Usługa sieciowa
- Żądanie autouzupełniania miejsc (input=”par”, session_token: XYZ)
- Żądanie autouzupełniania miejsc (input=”paris”, session_token: XYZ)
- Szczegóły miejsc (place_id, session_token: XYZ, pola:formatted_address)
Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku według kodu SKU):
- Autouzupełnianie (uwzględnione 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 (rozliczana w wysokości 0,00 USD)
SKU: autouzupełnianie zapytań – według żądania
Opłata SKU autouzupełniania zapytań – na żądanie jest naliczana za każde żądanie, które pozwala:
- JavaScript:
usługa autouzupełniania miejsc w interfejsie Maps JavaScript API (
getQueryPredictions()
) i korzystanie z widżetu SearchBox interfejsu Maps JavaScript API (żądania autouzupełniania zapytań są generowane na podstawie wpisywania przez użytkownika). - Usługa internetowa: usługa autouzupełniania zapytań interfejsu Places API.
ZAKRES MIESIĘCZNY (cena za ŻĄDANIE) |
||
---|---|---|
0,00283 USD za sztukę (2,83 USD za 1000) |
0,00227 USD za sztukę (2,27 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Model cenowy sesji autouzupełniania nie jest obsługiwany w przypadku autouzupełniania zapytań. Kolejne połączenia związane z danymi miejsc są naliczane zgodnie ze standardowymi cenami szczegółów Miejsc.
SKU: Szczegóły miejsca
Opłaty za połączenia dostępne w ramach szczegółów miejsca są naliczane w następujący sposób:
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,017 USD za każde (17,00 USD za 1000) |
0,0136 USD za sztukę (13,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Kod SKU Place Details jest generowany z tych interfejsów API:
- Android: SDK Miejsc na Androida (
fetchPlace()
) - iOS: SDK Miejsc na iOS (
fetchPlaceFromPlaceID:
) - JavaScript:
usługa Maps JavaScript API obsługi informacji o miejscu (
getDetails
) - JavaScript:
widżet autouzupełniania interfejsu Maps JavaScript API (
getPlace
) - JavaScript:
Widżet Place SearchBox interfejsu Maps JavaScript API:
getPlaces()
metodagetPlaces()
po wybraniu przez użytkownika wyniku miejsca (ikona: pinezka), *nie* zapytania (ikona: lupa), na przykład: - Usługa internetowa: usługa Places API Place Details
W przypadku internetowego interfejsu API i usług kod SKU szczegółów miejsca jest obciążany niezależnie od tego, czy token sesji zostanie udostępniony.
Wywołanie lub żądanie dotyczące 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 połączeniu lub żądaniu dotyczącym informacji o miejscu podasz NO, zostaną aktywowane NO kody SKU danych i zostaną naliczone opłaty za połączenie lub żądanie dotyczące Miejsc Google oraz koszt wszystkich danych.
Przykłady
- Wykonaj jedną z tych czynności:
- Komórka: wywołaj
fetchPlace()
w Androidzie lubfetchPlaceFromPlaceID:
w iOS i podaj tylko poleADDRESS
- Web API lub usługa: wyślij żądanie informacji o miejscu i podaj tylko pole adresu:
getPlaceDetails(fields: formatted_address)
- Szczegóły miejsca (cena od 0,017 USD za sesję)
- Basic Data (rozliczana w wysokości 0,00 USD)
- Komórka: wywołaj
- Wykonaj jedną z tych czynności:
- Komórka: wywołaj
fetchPlace()
w Androidzie lubfetchPlaceFromPlaceID:
w iOS i podaj tylko polePHONE_NUMBER
- Web API lub usługa: wyślij żądanie dotyczące informacji o miejscu i określ pole numeru telefonu:
getPlaceDetails(fields: formatted_phone_number)
- Szczegóły miejsca (cena od 0,017 USD za sesję)
- Dane kontaktowe (cena od 0,003 USD za żądanie)
- Komórka: wywołaj
- Wykonaj jedną z tych czynności:
- Urządzenie mobilne: wywołaj
fetchPlace()
w Androidzie lubfetchPlaceFromPlaceID:
w iOS i wypełnij wszystkie pola - Web API lub usługa: wyślij żądanie dotyczące informacji o miejscu i określ wszystkie pola (ten typ żądania jest domyślny, jeśli nie określisz żadnych pól):
getPlaceDetails()
.
- Szczegóły miejsca (cena od 0,017 USD za sesję)
- Basic Data (rozliczana w wysokości 0,00 USD)
- Dane kontaktowe (cena od 0,003 USD za żądanie)
- Dane atmosfery (cena od 0,005 USD za żądanie)
- Urządzenie mobilne: wywołaj
SKU: Informacje o miejscu – odświeżenie identyfikatora
W żądaniu informacji o miejscu odśwież nieaktualne identyfikatory miejsc. Prośby tego typu są dostępne bezpłatnie.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0.00 PLN | 0.00 PLN | 0.00 PLN |
Przykład
Wyślij żądanie dotyczące informacji o miejscu, podając tylko pole identyfikatora miejsca:
getPlaceDetails(fields: place_id)
.
Na rachunku będzie widoczny 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 obciążana opłatą za zapytanie Znajdź miejsce.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,017 USD za każde (17,00 USD za 1000) |
0,0136 USD za sztukę (13,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Żądania funkcji Znajdź miejsce 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ń informacji o miejscu, możesz użyć parametru pól w żądaniu Znajdź miejsce, aby ograniczyć odpowiedź tylko do określonych pól. Opłaty są naliczane za żądanie Znajdź miejsce i za żądane dane. Domyślnie, jeśli wymagane są pola NO, zwracany jest tylko identyfikator miejsca, więc nie są naliczane dodatkowe opłaty za dane.
Przykłady
- Po wysłaniu żądania Znajdź miejsce podajesz 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 (rozliczana w wysokości 0,00 USD)
- Wypełniasz żądanie usługi Znajdź miejsce i podajesz 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)
- Wysyłasz żądanie Znajdź miejsce i określasz pola ze wszystkich trzech 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 (rozliczana 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
Opłata Znajdź miejsce – tylko identyfikator jest naliczana za żądania Znajdź miejsce, w których podano tylko identyfikator miejsca, który ma zostać zwrócony. Jeśli w żądaniu Znajdź miejsce nie określono żadnych pól, domyślnie zwracany jest tylko identyfikator miejsca.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0.00 PLN | 0.00 PLN | 0.00 PLN |
Przykład
Po zgłoszeniu żądania Znajdź miejsce należy podać tylko pole place_id
: FindPlace(fields: place_id)
.
Na rachunku będzie widoczny ten kod SKU (podczas wyświetlania rachunku według kodu SKU):
- Find Place – ID only (opłata 0.00 USD)
SKU: Miejsce – Wyszukiwanie w pobliżu
Opłata za usługę Miejsce – wyszukiwanie w pobliżu jest obciążana opłatami za żądania wysyłane do
usługi wyszukiwania miejsc w pobliżu dostępnej w interfejsie Maps JavaScript API (nearbySearch()
) lub do
usługi wyszukiwania w pobliżu interfejsu Places API
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,032 USD za każde (32,00 USD za 1000) |
0,0256 USD za sztukę (25,60 USD za 1000) |
Aby poznać ceny hurtowe, 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ą być zwracane. Żądania wyszukiwania w pobliżu zwracają podzbiór obsługiwanych pól danych. Opłaty są naliczane za żądanie Wyszukiwania w pobliżu od 0,032 USD za każde zapytanie oraz za wszystkie kody SKU danych typu danych (Dane podstawowe, Dane kontaktowe i Dane atmosfery).
Przykład
Urządzenie wysyła do Ciebie prośbę o wyszukiwanie 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 (rozliczana 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: Miejsce – Wyszukiwanie tekstowe
Opłata za Place – Text Search jest naliczana za żądania wysyłane do
usługi Place Text API interfejsu Maps JavaScript API (textSearch()
) lub do
usługi wyszukiwania tekstu interfejsu Places API.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,032 USD za każde (32,00 USD za 1000) |
0,0256 USD za sztukę (25,60 USD za 1000) |
Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży |
Żądania wyszukiwania tekstowego zwracają listę miejsc, ale nie obsługują określania, które pola mają być zwracane. Żądania wyszukiwania tekstowego zwracają podzbiór obsługiwanych pól danych. Opłaty za żądanie wyszukiwania tekstowego zaczynają się od 0,032 USD za każde żądanie oraz za wszystkie kody SKU typów danych (Dane podstawowe, Dane kontaktowe i Dane atmosfery).
Kod SKU Place – SearchBoxgetPlaces()
Przykład
Wysyłamy żądanie wyszukiwania tekstowego, takie jak TextSearch(123 Main Street)
. Na rachunku będą widoczne te kody SKU (podczas wyświetlania rachunku według kodu SKU):
- Miejsce – wyszukiwanie tekstowe (cena od 0,032 USD za połączenie)
- Basic Data (rozliczana 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 obciążany płatnością za:
- Android: połączenia z numerem
fetchPhoto()
- iOS: połączenia z numerem
loadPlacePhoto:
- JavaScript:do biblioteki Miejsc Google usługi Place Photos (Place Photos) interfejsu Maps JavaScript API w przypadku wysyłania żądań danych z adresów URL zwróconych przez
PlacePhoto.getUrl()
w celu wczytania danych pikseli obrazów - Usługa internetowa: żądania wysyłane do usługi Place Photos API.
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 pikseli.
ZAKRES MIESIĘCZNY (cena za połączenie) |
||
---|---|---|
0,007 USD za każde (7,00 USD za 1000) |
0,0056 USD za sztukę (5,60 USD za 1000) |
Aby poznać ceny hurtowe, 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 liczby żądań na minutę to 600 QPM (żądań na minutę) na metodę API na projekt. Oznacza to, że każda metoda API ma oddzielny limit.
Places API: limit żądań to 6000 QPM (żądań na minutę). Wartość ta jest obliczana jako suma żądań po stronie klienta i po stronie serwera dla wszystkich aplikacji wykorzystujących dane logowania z tego samego projektu.
Ograniczenia Warunków korzystania z usługi
Informacje na temat warunków korzystania z usługi znajdziesz w zasadach dotyczących interfejsu Places API oraz w sekcji Ograniczenia licencji w Warunkach korzystania z Google Maps Platform.
Zarządzanie kosztami korzystania
Aby zarządzać kosztami korzystania z interfejsu Places API lub spełnić wymagania związane z ruchem produkcyjnym, ustaw dzienny limit wszystkich żądań wysyłanych do dowolnego interfejsu API. Limity dzienne są resetowane o północy czasu pacyficznego.
Aby wyświetlić lub zmienić limity miejsca dla interfejsu Places API:
- W konsoli Cloud otwórz stronę Limity Google Maps Platform.
- Kliknij menu Interfejsy API i wybierz Places API.
- Aby wyświetlić limity, przewiń w dół do karty Żądania.
W tabeli znajdziesz nazwy i limity. - 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, jeśli jest określony przez Google) i wybierz Zapisz.
Jeśli wykorzystanie interfejsu API osiągnie w danym dniu limit podlegający rozliczeniu, aplikacja nie będzie mogła uzyskać dostępu do interfejsu API do końca tego dnia.