Pakiet Miejsca SDK do wykorzystania i rozliczeń iOS

Błąd: kGMSPlacesRateLimitExceeded

Pakiet SDK Miejsc na iOS korzysta z modelu płatności „pay-as-you-go”. Żądania wysyłane przez Places SDK na iOS do interfejsu Places API są rozliczane według kodu SKU. Oprócz ogólnych Warunków korzystania z usługi Google istnieją limity korzystania dotyczące pakietu SDK Miejsc na iOS. Zarządzaj kosztami i wykorzystaniem za pomocą narzędzi dostępnych w konsoli Google Cloud.

Jak naliczane są opłaty za Places SDK na iOS

Pakiet SDK Miejsc na iOS (nowy) i pakiet SDK Miejsc na iOS korzystają z modelu płatności „użyj i zapłać”. Interfejsy API i pakiety SDK Google Maps Platform są rozliczane według SKU. Korzystanie jest śledzone w przypadku każdego kodu SKU, a każdy interfejs API lub pakiet SDK może mieć więcej niż 1 kod SKU produktu. Koszt jest obliczany według wzoru:
Użycie kodu SKU × cena za użycie

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

Ceny pakietu Places SDK na iOS (nowy)

Informacje o maskach pól

Aby określić listę pól, które mają być zwracane w odpowiedzi, używaj w żądaniach masek pól, zwanych też listami pól. Następnie zostaniesz obciążony najwyższym SKU, które jest odpowiednie dla Twojego żądania. Oznacza to, że jeśli wybierzesz pola w obu SKU (Basic) i SKU (Advanced), zostaniesz obciążony zgodnie z SKU (Advanced).

Korzystanie z maski pola to dobra praktyka projektowania, która pozwala uniknąć przesyłania niepotrzebnych danych, co z kolei pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.

Sesje autouzupełniania (Nowe)

Sesja Autouzupełnianie (nowa) zawiera co najmniej 1 żądanie Autouzupełnianie (nowe) oraz żądanie Szczegóły miejsca (nowe) lub żądanie Weryfikacja 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 żądania Autouzupełnianie (Nowe). Gdy użytkownik wybierze jedną z sugestii autouzupełniania (nowej), wysyłane jest żądanie szczegółów miejsca docelowego (nowego) lub żądanie weryfikacji adresu. Jeśli sesja zostanie przerwana, co oznacza, że nie wysłano żądania Szczegóły miejsca (Nowe) ani żądania weryfikacji adresu, żądania autouzupełniania (Nowe) są obciążane tak, jakby nie podano tokenu sesji.

Gdy użytkownik wybierze miejsce (czyli wyśle żądanie Szczegóły miejsca (Nowe) lub żądanie weryfikacji adresu), musisz rozpocząć nową sesję za pomocą nowego tokena sesji.

Token sesji jest ważny w ramach jednej sesji i nie można go użyć w innej. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a zapytania zostaną obciążone opłatą tak, jakby nie podano tokena sesji.

SKU: żądania autouzupełniania

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

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

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

SKU: wykorzystanie sesji autouzupełniania

Za każde żądanie wysłane do interfejsu Autocomplete API (New) z tokenem sesji pobierana jest opłata za korzystanie z sesji Autocomplete.

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

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

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

  • Sesja autouzupełniania została zakończona wywołaniem SKU: Szczegóły miejsca (podstawowe, zaawansowane lub preferowane).

    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 znajdziesz w artykule Autouzupełnianie (nowa wersja) i cena 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 sztukę
(0,00 USD za 1000 sztuk)		 0,00 USD za sztukę
(0,00 USD za 1000 sztuk)		 0,00 USD za sztukę
(0,00 USD za 1000 sztuk)

SKU: informacje o miejscu (tylko identyfikatory)

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

iOS GMSPlacePropertyPlaceID, GMSPlacePropertyName, GMSPlacePropertyPhotos

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

SKU: szczegóły miejsca (tylko lokalizacja)

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

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyFormattedAddress, GMSPlacePropertyCoordinate, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyViewport

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

SKU: informacje o miejscu (podstawowe)

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

iOS: GMSPlacePropertyBusinessStatus, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyWheelchairAccessibleEntrance

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

SKU: informacje o miejscu (zaawansowane)

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

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

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

SKU: informacje o miejscu (preferowane)

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

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

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

SKU: Wyszukiwanie w pobliżu (podstawowe)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania w pobliżu (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ten SKU jest uruchamiany, gdy tylko wysyłasz te pola:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyCoordinate, GMSPlacePropertyFormattedAddress, GMSPlacePropertyName, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyPhotos, GMSPlacePropertyPlaceID, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

SKU: wyszukiwanie w pobliżu (zaawansowane)

Za pomocą maski pola lub listy pól w prośbie wyszukiwania w pobliżu (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ten SKU jest uruchamiany, gdy tylko wysyłasz te pola:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,035 USD za każdą
(35 USD za 1000 jednostek)		 0,028 USD za sztukę
(28 USD za 1000 sztuk)		 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 prośbie wyszukiwania w pobliżu (nowej) możesz ograniczyć odpowiedź tylko do określonych pól. Ta SKU jest uruchamiany, gdy tylko wysyłasz te pola:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

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

SKU: wyszukiwanie tekstowe (tylko identyfikator)

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

iOS GMSPlacePropertyPlaceID, GMSPlacePropertyName

LICZBA POŁĄCZEŃ W MIESIĄCU
(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 sztuk)

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:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyFormattedAddress, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyCoordinate, GMSPlacePropertyPhotos, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

SKU: wyszukiwanie tekstowe (zaawansowane)

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

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

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

SKU: wyszukiwanie tekstu (preferowane)

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

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

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

SKU: umieszczanie zdjęcia

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

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

Ceny pakietu SDK Miejsc na iOS

Informacje o sesjach autouzupełniania

Sesja autouzupełniania obejmuje kilka żądań autouzupełniania (aby pobrać sugestie dotyczące miejsca, gdy użytkownik je wpisze) oraz co najwięcej 1 żądania szczegółów miejsca (aby pobrać szczegóły wybranego przez użytkownika miejsca). Ten sam token sesji jest przekazywany do funkcji autouzupełniania i kolejnych żądań dotyczących szczegółów miejsca. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (co zwykle następuje, gdy użytkownik zacznie pisać). Gdy użytkownik wybierze jedną z sugestii autouzupełniania, wywoływana jest funkcja PlacesDetails. Jeśli użytkownik nie wybierze sugestii, nie zostanie wywołana usługa Places Details.

Gdy użytkownik wybierze miejsce (czyli po wywołaniu metody PlacesDetails), musisz rozpocząć nową sesję za pomocą nowego tokena sesji.

Sesje autouzupełniania można generować za pomocą tych interfejsów API:

Token sesji jest ważny w przypadku jednej sesji użytkownika i nie powinien być używany w przypadku więcej niż 1 sesji użytkownika. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a zapytania zostaną obciążone opłatą tak, jakby nie podano tokena sesji.

Żądania dotyczące autouzupełniania i żądania dotyczące szczegółów miejsc korzystające z sesji są rozliczane za pomocą różnych kodów SKU.

Informacje o kodach SKU danych o miejscach

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

W przypadku co najmniej 1 poziomu usług danych:

  • Android: każda prośba do fetchPlace() lub findCurrentPlace()
  • iOS: każde wywołanie funkcji fetchPlaceFromPlaceID: lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Usługa internetowa: każda prośba do Places w zależności od pól określonych w prośbie

Za kody SKU danych zawsze pobierana jest opłata oprócz opłaty za kod SKU podstawowy dla żądania, które je wywołało. Na przykład żądanie informacji o miejscu, które zawiera pola danych podstawowych, będzie obciążone opłatą zarówno w ramach SKU danych podstawowych, jak i SKU informacji o miejscu.

SKU: dane podstawowe

Za pomocą parametru fields w żądaniu informacji o miejscu lub znajdowania miejsca możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Podstawowe są uwzględnione w kosztach podstawowych prośby o dane o miejscach i nie powodują dodatkowych opłat. 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.
  • 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 prośby o utworzenie miejsca docelowego
+ 0,00 USD		 Koszt prośby o utworzenie miejsca docelowego
+ 0,00 USD		 Koszt prośby o utworzenie miejsca docelowego
+ 0,00 USD

SKU: dane kontaktowe

Za pomocą parametru fields w żądaniu dotyczącego szczegółów miejsca lub znajdowania miejsca w przypadku usług internetowych albo tablicy wartości Place.Field w przypadku Androida lub iOS możesz ograniczyć odpowiedź tylko do tych pól. Pola w kategorii Kontakt powodują dodatkowe opłaty. SKU Dane kontaktowe jest uruchamiany, gdy wymagane są dowolne z tych pól:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS lub Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours,GMSPlaceFieldPhoneNumber lub GMSPlaceFieldWebsite
  • Usługa internetowa: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours lub website
LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt wysłania żądania do Places
+ 0,003 USD za każdą
(+ 3,00 USD za 1000)		 Koszt wysłania żądania do Places
+ 0,0024 USD za każdą prośbę
(+ 2,40 USD za 1000 żądań)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: dane dotyczące atmosfery

Za pomocą parametru fields w żądaniu dotyczącym szczegółów miejsca lub znajdowania miejsca możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Atmosfera powodują dodatkową opłatę. Kod SKU Dane o atmosferze jest uruchamiany, gdy wymagane jest jedno z tych pól:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.RESERVABLE, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE,Place.Field.TAKEOUT lub Place.Field.USER_RATING_COUNT,
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch lub GMSPlaceFieldServesVegetarianFood.
  • JavaScript zobacz Pola (szczegóły miejsca).
  • Usługa internetowa: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout lub user_ratings_total.
LICZBA POŁĄCZEŃ W MIESIĄCU
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt żądania w usłudze Places
+ 0,005 USD za każdą
(+ 5,00 USD za 1000)		 Koszt żądania dotyczącego miejsc
+ 0,004 USD za każdą prośbę
(+ 4,00 USD za 1000 żądań)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: autouzupełnianie – według prośby

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

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

Za żądania autouzupełniania z interfejsu Maps JavaScript API – widżet autouzupełniania adresu może zostać naliczona opłata za SKU Autouzupełnianie – za żądanie, jeśli wywołania pochodzą z nieprawidłowej sesji autouzupełniania. Może się tak zdarzyć, gdy użytkownik wpisze kilka różnych adresów lub skopiuje i wklei różne adresy do widgeta i nie zawsze wybierze podpowiedzi autouzupełniania.

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

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

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

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

Przykład

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

Android

iOS

Usługa internetowa

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

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

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

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

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

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

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

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

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

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

Przykład

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

Android

iOS

Usługa internetowa

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

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

SKU: informacje o miejscach

Połączenia z Infolinią dotyczącą miejsc są rozliczane w ten 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 sztukę
(17 USD za 1000 sztuk)		 0,0136 USD za sztukę
(13,60 USD za 1000 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Identyfikator SKU w interfejsie Places Details jest generowany z tych interfejsów API:

W przypadku interfejsu API i usług internetowych opłata za SKU Szczegóły miejsca jest naliczana niezależnie od tego, czy podano token sesji.

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

Przykłady

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

SKU: Znajdź bieżące miejsce

Znajdowanie bieżącej lokalizacji jest płatne w przypadku wywołań do findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

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

Wywołania funkcji findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) generują też SKU danych (Basic, Contact lub Atmosphere), w zależności od pól określonych w wywołaniu. Określ pola danych, aby ograniczyć odpowiedź tylko do tych pól. Obciążamy Cię za wywołanie FindCurrentPlace oraz za żądane dane.

Przykłady

  1. Wywołujesz metodę findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) i określasz tylko pole ADDRESS. Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Znajdowanie bieżącego miejsca (cena od 0,030 USD za prośbę)
    • Dane podstawowe (obciążenie 0,00 USD)
  2. Wywołujesz funkcję findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) i określasz pole PHONE_NUMBER. Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Znajdowanie bieżącej lokalizacji (cena od 0,030 USD za każde żądanie)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  3. Używasz funkcji findCurrentPlace() (Android) lub findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) i wyznaczasz pola ze wszystkich 3 typów zbiorów danych. Na rachunku zobaczysz te kody SKU (wyświetlając rachunek według kodu SKU):
    • Znajdowanie bieżącej lokalizacji (cena od 0,030 USD za każde żądanie)
    • Dane podstawowe (obciążenie 0,00 USD)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
    • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: Zdjęcie miejsc

Kod SKU Zdjęcie Miejsca jest naliczany za:

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

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

Inne limity wykorzystania

Chociaż nie ma maksymalnej liczby żądań dziennie, podczas korzystania z pakietu Places SDK na iOS obowiązuje ten limit:

  • Limit szybkości to 6000 QPM (żądań na minutę). Jest ona obliczana jako suma żądań po stronie klienta i 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 sekcji Ograniczenia licencji w Warunkach korzystania z Google Maps Platform.

Zarządzanie kosztem użytkowania

Aby zarządzać kosztami używania pakietu Places SDK na iOS lub sprostać wymaganiom związanemu z ruchem produkcyjnym, ustaw dzienne limity kwoty na wszystkie żądania wysyłane do dowolnego interfejsu API. Dzienne limity są resetowane o północy czasu pacyficznego.

Aby wyświetlić lub zmienić limity dotyczące pakietu SDK Miejsc na iOS:

  1. W konsoli Google Cloud otwórz stronę Limity platformy Mapy Google.
  2. Kliknij menu interfejsów API i wybierz Places SDK na iOS.
  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 rozliczeniowej (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.