Wykorzystanie i rozliczenia interfejsu API Miejsc Google

Komponent Places API (nowość) i Places API używa płatności według wykorzystania. Żądania do interfejsu Places API (nowość) i Places API generują wywołania wielu kodów SKU. Oprócz ogólnych Warunków korzystania z usług Google obowiązują limity wykorzystania związane z interfejsem Places API. Zarządzaj kosztami i wykorzystaniem za pomocą narzędzi dostępnych w Konsola Google Cloud.

Rozliczenia interfejsu Places API

W interfejsach Places API (nowość) i Places API stosuje model cenowy płatności według wykorzystania. Interfejsy API Google Maps Platform a pakiety SDK są rozliczane według kodów 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 według wzoru:

Wykorzystanie SKU × Cena za wykorzystanie

Aby oszacować koszty korzystania z interfejsu API lub pakietu SDK, skorzystaj z naszego kalkulatora cen i kosztów użytkowania. Kwalifikujące się Kody SKU Google Maps Platform to środki w wysokości 200 USD do wykorzystania w Google Maps Platform co miesiąc dla każdego konta rozliczeniowego. Ten zwrot środków jest automatycznie stosowany do kwalifikujących się kodów SKU.

Cennik interfejsu Places API (nowy)

Informacje o maskach pól

W przypadku szczegółów miejsca (nowego) Wyszukiwanie w pobliżu (nowość) i Wyszukiwanie tekstowe (nowość), użyj nagłówka FieldMask w: Żądania do interfejsu API określające listę pól, które mają zwrócić odpowiedź. Jesteś a następnie rozliczany według najwyższej jednostki SKU odpowiedniej dla Twojego żądania. Oznacza to, że jeśli wybierz pola w kodzie SKU (podstawowej) i (zaawansowanej), według kodu SKU (Zaawansowane).

Używanie maskowania pól jest dobrą praktyką projektowania, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Sesje autouzupełniania (nowe) – informacje

Sesja autouzupełniania (nowa) obejmuje co najmniej jedno żądanie autouzupełniania oraz Prośba o informacje dotyczące miejsca (nowe) lub prośba o weryfikację adresu. Ten sam token sesji jest przekazywany do żądania Autouzupełnianie (nowe) oraz do kolejnych żądań Szczegóły miejsca (nowe) lub Weryfikacja adresu.

Sesja rozpoczyna się od pierwszego (nowego) żądania autouzupełniania. prośby o szczegóły (nowe) miejsca lub Gdy użytkownik wybierze jedną z opcji autouzupełniania, zostanie wysłana prośba o weryfikację adresu. sugestie. jeśli sesja zostanie porzucona, czyli nie będzie prośby o informacje o miejscu (nowych) lub Przysłano prośbę o weryfikację adresu, a za żądania autouzupełniania (nowe) są naliczane opłaty, jak gdyby nie było tokena sesji został podany.

Po wybraniu przez użytkownika miejsca (co oznacza przesłanie prośby o dostęp do informacji o miejscu (Nowe) lub potwierdzenie adresu). żądania), musisz rozpocząć nową sesję przy użyciu nowego tokena sesji.

Token sesji jest odpowiedni dla jednej sesji i nie może być używany przez więcej niż jedną sesję . Jeśli używasz ponownie tokena sesji, sesja jest uznawana za nieprawidłową, a zapytania są obciążane tak, jakby nie podano tokena sesji.

SKU: żądania autouzupełniania

Za każde żądanie do interfejsu Autocomplete API (New) bez tokena sesji naliczane jest żądanie Autocomplete Requests.

Opłaty są też naliczane, jeśli używasz tokenów sesji i występuje co najmniej 1 z tych sytuacji:

  • Kończenie sesji za pomocą pojedynczej prośby o umieszczenie szczegółów (Nowe), które żąda pól określonych w atrybucie SKU: szczegóły miejsca (tylko lokalizacja).
    • Każde żądanie autouzupełniania (nowe), maksymalnie 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.
  • porzucenie sesji lub zakończenie sesji przez wywołanie funkcji 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Ń W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00283 USD za sztukę
(2,83 USD za 1000)		 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

Opłata za wykorzystanie sesji autouzupełniania jest naliczana za każde żądanie wysyłane do Nowy (nowy) interfejs API autouzupełniania zawierający token 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):

    • Za każde (nowe) żądanie autouzupełniania (maksymalnie 12) jest rozliczane za pomocą SKU: żądania autouzupełniania.
    • Każde kolejne żądanie Autocomplete (New) jest rozliczane za pomocą SKU: Autocomplete Session Usage.

  • Sesja autouzupełniania zakończyła się wywołaniem kodu SKU: szczegóły miejsca (Podstawowy, Zaawansowany lub Preferowany).

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

  • Sesja autouzupełniania została zakończona wywołaniem SKU: weryfikacja adresu Preferred.

Więcej informacji: Autouzupełnianie (nowość) i ceny sesji.

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,00 USD za każde
(0,00 USD za 1000)		 0,00 USD za sztukę
(0,00 USD za 1000 sztuk)		 0,00 USD za każde
(0,00 USD za 1000)

SKU: informacje o miejscu (tylko identyfikatory)

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

Usługa internetowa: attributions id, name*, photos

* Pole name zawiera nazwę zasobu. w formacie: places/PLACE_ID. Użyj displayName, aby wyświetlić nazwę tekstową miejsca.

ZAKRES MIESIĘCZNY
(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 wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

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

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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)

Za pomocą maski pola lub listy pól w żądaniu szczegółów miejsca (nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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 żąda dowolnego pola z metody SKU: szczegóły miejsca (podstawowe, zaawansowane, preferowane), wtedy połączenie jest rozliczane według SKU: szczegóły miejsca (preferowane). Więcej informacji: SKU: autouzupełnianie danych o wykorzystaniu sesji.

ZAKRES MIESIĘCZNY
(cena za połączenie)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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)

Za pomocą maski pola lub listy pól w żądaniu szczegółów miejsca (nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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 żąda dowolnego pola z metody SKU: szczegóły miejsca (podstawowe, zaawansowane, preferowane), wtedy połączenie jest rozliczane według SKU: szczegóły miejsca (preferowane). Więcej informacji znajdziesz w artykule SKU: Autouzupełnianie – wykorzystanie sesji.

LICZBA POŁĄCZEŃ W MIESIĄCU
(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 każde
(16,00 USD za 1000)		 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 żądaniu szczegółów miejsca (nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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, routingSummaries,* servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

* Tylko wyszukiwanie tekstowe i wyszukiwanie w pobliżu

Jeśli sesja autouzupełniania zostanie zakończona przez wywołanie informacji o miejscu, które żąda dowolnego pola z metody SKU: szczegóły miejsca (podstawowe, zaawansowane, preferowane), wtedy połączenie jest rozliczane według SKU: szczegóły miejsca (preferowane). Więcej informacji: SKU: autouzupełnianie danych o wykorzystaniu sesji.

ZAKRES MIESIĘCZNY
(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 każde
(20,00 USD za 1000)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: Wyszukiwanie w pobliżu (podstawowe)

Za pomocą maski pola lub listy pól w żądaniu wyszukiwania w pobliżu (nowa wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ten 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.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name*, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Pole places.name zawiera miejsce nazwa zasobu w formie: places/PLACE_ID. Użyj places.displayName, aby wyświetlić nazwę tekstową miejsca.

ZAKRES MIESIĘCZNY
(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 pola lub listy pól w żądaniu Wyszukiwanie w pobliżu (Nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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)

Za pomocą maski pola lub listy pól w żądaniu wyszukiwania w pobliżu (nowa wersja) możesz ograniczyć odpowiedź tylko do określonych pól. Ten 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.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* tylko w przypadku wyszukiwania tekstowego i wyszukiwania w pobliżu

LICZBA POŁĄCZEŃ W MIESIĄCU
(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 każde
(32,00 USD za 1000)		 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. Ten 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 formatu: places.displayName aby uzyskać dostęp do tekstowej nazwy miejsca.

ZAKRES MIESIĘCZNY
(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,0 USD za każde
(0,00 USD za 1000)

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:

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.viewport

ZAKRES MIESIĘCZNY
(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)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży

SKU: wyszukiwanie tekstowe (zaawansowane)

Za pomocą maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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)

Za pomocą maski pól lub listy pól w żądaniu wyszukiwania tekstowego (nowe) możesz ograniczyć odpowiedzi tylko na te określone pola. Ten 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.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* tylko w przypadku wyszukiwania tekstowego i wyszukiwania w pobliżu

LICZBA POŁĄCZEŃ W MIESIĄCU
(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: zdjęcie miejsca

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

ZAKRES MIESIĘCZNY
(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 interfejsu Places API

Informacje o sesjach autouzupełniania

Sesja autouzupełniania obejmuje kilka żądań autouzupełniania (aby pobrać sugestie dotyczące miejsca, gdy użytkownik je wpisze) oraz maksymalnie 1 żądanie szczegółów miejsca (aby pobrać szczegóły miejsca wybranego przez użytkownika). Ten sam token sesji jest przekazywany do autouzupełniania oraz o dodatkowe informacje o miejscu. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (co zwykle następuje, gdy użytkownik zacznie pisać). Połączenie ze szczegółami miejsc jest nawiązywane, gdy użytkownik zaznaczył(a) jedną z sugestii autouzupełniania. Jeśli użytkownik nie wybierze sugestii, nie nawiązano połączenia ze szczegółami dotyczącymi miejsc.

Po wybraniu przez użytkownika miejsca (tj. wykonaniu połączenia z informacjami o miejscach), trzeba utworzyć nowe przy użyciu nowego tokena sesji.

Sesje autouzupełniania mogą być generowane z 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żywasz ponownie tokena sesji, sesja jest uznawana za nieprawidłową, a zapytania są obciążane tak, jakby nie podano tokena sesji.

Żądania autouzupełniania i żądania szczegółów miejsca korzystające z sesji są rozliczane w dniu różnych kodów SKU.

Informacje o kodach SKU danych o miejscach

Te 3 poziomy pakietu danych Places to: Dane podstawowe, Dane kontaktów i Dane o atmosferze.

Co najmniej 1 kod SKU danych został aktywowany dla:

  • Android: każde żądanie wysłane do fetchPlace() lub findCurrentPlace()
  • iOS: każde wywołanie funkcji fetchPlaceFromPlaceID: lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Usługa internetowa: każde żądanie Miejsc w zależności od pól określonych w żądaniu.

Kody SKU danych są zawsze naliczane oprócz podstawowego kodu SKU za wywołanie żądania . 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 Miejsc 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 Miejsc, obciążając 3 kody SKU danych Miejsc jako uzupełnienie opłaty za każde żądanie do 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 z kategorii Podstawowe są uwzględnione w: podstawowy koszt zapytania dotyczącego Miejsc i nie wiążą się z żadnymi dodatkowymi opłatami. Kod SKU Dane podstawowe jest uruchamiany, gdy zostanie przesłane żądanie dotyczące któregoś 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.
  • Urządzenia z 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Ń W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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

używając parametru pola w żądaniu informacji o miejscu lub w żądaniu Znajdź miejsce na potrzeby usług internetowych, tablicę Place.Field w przypadku Androida lub iOS, można ogranicz odpowiedź tylko do tych określonych pól. Pola w Kontaktu kategoria skutkuje dodatkową opłatą. SKU Dane kontaktowe jest uruchamiany, gdy wymagane są te pola:

  • 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
  • Urządzenia z 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Ń W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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 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 atmosfery kategoria skutkuje 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
  • Urządzenia z 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Ń W MIESIĄCU
(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 żą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

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

wywołania pochodzące z nieprawidłowej sesji autouzupełniania (np. sesji, która wykorzystuje token sesji); również są objęte autouzupełnianiem według kodu SKU 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 widgeta i nie zawsze wybierze przewidywane uzupełnienie.

ZAKRES MIESIĘCZNY
(cena za ŻĄDANIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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

Opłaty za kod SKU Autouzupełnianie bez informacji o miejscu – za sesję są naliczane za sesja autouzupełniania, która nie zawiera prośby o informacje o miejscu (w ciągu kilku minut przed jej rozpoczęciem, sesji).

LICZBA MIESIĘCZNYCH POZYCZEŃ
(cena za SESJĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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 aplikacja wysyła te 2 wyzwania w ramach jednej sesji:

Android

iOS

Usługa internetowa

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

  • Autouzupełnianie bez informacji o miejscu – za sesję (cena 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: 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 według Ceny miejsc.

Żądanie dotyczące szczegółów miejsca powoduje wygenerowanie kodów SKU danych (Podstawowe, Kontakt lub Atmosfera) – w zależności od pól wskazanych w żądaniu.

Jeśli nie określisz pól w żądaniu dotyczącym informacji o miejscu, zostaną aktywowane wszystkie kody SKU danych. (Podstawowe, Contact i Atmosphere).

Żądania odświeżenia identyfikatora szczegółów miejsca (żądania, które określają tylko pole place_id) podczas sesji autouzupełniania są rozliczane jako SKU: autouzupełnianie bez informacji o miejscu – według sesji.

LICZBA MIESIĘCZNYCH POZYCZEŃ
(cena za SESJĘ)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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

iOS

Usługa internetowa

Na rachunku zobaczysz te kody SKU (wyświetlając rachunek 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 zaczyna się od 0,017 USD za sesję)
  • Basic Data (rozliczana w wysokości 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)		 0,00227 USD za sztukę
(2,27 USD za 1000)		 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: Szczegóły miejsca

Opłaty za połączenia dostępne w ramach szczegółów miejsca są naliczane w następujący sposób:

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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 Szczegóły miejsca jest generowany z tych interfejsów API:

W przypadku internetowego interfejsu API i usług kod SKU szczegółów miejsca jest obciążany niezależnie od tego, czy token sesji lub nie.

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 określono pola NO, w rozmowie lub żądaniu w informacjach o miejscu zostaną aktywowane WSZYSTKIE kody SKU danych; zostanie naliczona opłata za połączenie lub żądanie dotyczące Miejsc Google plus koszt wszystkich danych.

Przykłady

  1. Wykonaj jedno z tych połączeń lub prośby:
    • Komórka: zadzwoń do: fetchPlace() w Androidzie lub fetchPlaceFromPlaceID: w iOS i podaj tylko pole ADDRESS
    • Interfejs API lub usługa internetowa: prześlij żądanie Szczegóły miejsca i wskaż tylko pole adresu:getPlaceDetails(fields: formatted_address)
    Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku 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 rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane kontaktowe (cena od 0,003 USD za żądanie)
  3. Wykonaj jedno z tych działań:
    • Urządzenie mobilne: wywołaj fetchPlace() na Androidzie lub fetchPlaceFromPlaceID: na iOS i wypełnij wszystkie pola.
    • Web API lub Service: wyślij żądanie informacji o miejscu i określ wszystkie pola (ten typ żądanie jest domyślne, jeśli nie określisz żadnych pól): getPlaceDetails().
    Na rachunku zobaczysz te kody SKU (podczas wyświetlania rachunku 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 od 0,003 USD za żądanie)
    • Dane atmosfery (cena od 0,005 USD za żądanie)

SKU: Informacje o miejscu – odświeżenie identyfikatora

Skorzystaj z prośby o informacje dotyczące miejsca, aby odświeżyć nieaktualne identyfikatory miejsc. Prośby tego typu są dostępne bezpłatnie.

ZAKRES MIESIĘCZNY
(cena za połączenie)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0.00 PLN 0.00 PLN 0.00 PLN

Przykład

Prześlij żądanie dotyczące 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 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–100 tys. 100 001–500 000 Ponad 500 tys.
0,017 USD za każde
(17,00 USD za 1000)		 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. Polub szczegóły miejsca żądań, możesz użyć parametru pól w żądaniu Znajdź miejsce, aby ograniczyć odpowiedź tylko do tych określonych pól. Opłaty są naliczane za żądanie Znajdź miejsce oraz za dane poproszono o dostęp. 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). Te kody SKU będą widoczne na rachunku (gdy wyświetlanie rachunku według kodu SKU):
    • Znajdź miejsce (cena od 0,017 USD za połączenie)
    • Basic Data (rozliczana w wysokości 0,00 USD)
  2. Po zgłoszeniu żądania Znajdź miejsce należy wprowadzić następujące 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)
    • 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

Usługa Znajdź miejsce – tylko dokument tożsamości jest obciążana opłatami tylko za zapytania typu Znajdź miejsce, które określ identyfikator miejsca, który ma zostać zwrócony. Domyślnie, jeśli w żądaniu znajdowania miejsca nie zostaną określone żadne pola, zwrócony zostanie tylko identyfikator miejsca.

LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
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). Kod SKU będzie widoczny na rachunku (gdy wyświetlenie rachunku według kodu SKU):

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

Miejsce – 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.

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

Przykład

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

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

SKU: Miejsce – wyszukiwanie tekstowe

Miejsce – wyszukiwanie tekstu jest płatne w przypadku żądań wysyłanych do usługi wyszukiwania tekstu w miejscu w Maps JavaScript API (textSearch()) lub do usługi wyszukiwania tekstu w miejscu w interfejsie Places API.

ZAKRES MIESIĘCZNY
(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)		 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. Zapytanie dotyczące wyszukiwania tekstowego jest płatne od 0,032 USD za każde zapytanie, a także za wszystkie SKU typu „dane” (dane podstawowe, dane kontaktowe i dane atmosferyczne).

Kod SKU wyszukiwania tekstowego miejsca jest również generowany przez Widżet Place SearchBox interfejsu Maps JavaScript API: getPlaces() po tym, jak użytkownik wybierze zapytanie o miejsce (ikona: lupa), nie. wyniku (ikona: pinezka), tak jak na ilustracji:

Wybór zapytania w widżecie pola wyszukiwania szczegółów miejsc
W wynikach wyszukiwania w polu wyszukiwania widać, że pizza delivery ma obok ikonę lupy, co oznacza, ż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 połączenie)
  • Dane podstawowe (obciążenie 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:

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.

ZAKRES MIESIĘCZNY
(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.

Inne limity wykorzystania

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

  • Places API (nowość): limit liczby żądań na minutę to 600 QPM (żądania na minutę) na metodę API na projekt. Znaczenie poszczególnych metod interfejsu API ma osobny limit.

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

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

Informacje o warunkach korzystania znajdziesz w zasadach dotyczących interfejsu Places API oraz 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 Places API lub sprostać wymaganiom w zakresie produkcji ustaw dzienny limit dla wszystkich żądań wysyłanych do dowolnego interfejsu API. Dzienne limity są resetowane o o północy czasu pacyficznego.

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

  1. W konsoli Google Cloud otwórz stronę Limity Google Maps Platform.
  2. Kliknij menu Interfejsy API i wybierz Places 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 naliczonej kwoty dziennej (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.