Pakiet Miejsca SDK do wykorzystania i rozliczeń w systemie Android

Błąd: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

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

Jak naliczane są opłaty za pakiet SDK Miejsc na Androida

Pakiet SDK Miejsc na Androida (nowy) i pakiet SDK Miejsc na Androida korzystają z modelu płatności „pay-as-you-go”. 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:

Użycie 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 Androida (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 opłatą za najwyższy kod SKU odpowiedni dla Twojej prośby. 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 pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Informacje o sesjach autouzupełniania (nowej wersji)

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 docelowego (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 tokena 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 tokenu sesji.

Token sesji jest ważny przez jedną sesję i nie można go użyć w więcej niż jednej sesji. Jeśli ponownie użyjesz tokena sesji, sesja zostanie uznana za nieprawidłową, a za żądania zostanie pobrana opłata, jakby token sesji nie został podany.

SKU: żądania autouzupełniania

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

Opłata jest też naliczana, jeśli używasz tokenów sesji i występuje co najmniej 1 z tych sytuacji:

  • Zakończ sesje, wysyłając jedno żądanie do usługi Szczegóły miejsca (nowa wersja), 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 przerwać sesję lub ją zakończyć, wywołaj funkcję SKU: Szczegóły miejsca (tylko identyfikatory). Wszystkie prośby o usługę Autocomplete (Nowa) 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 sztuk)		 0,00227 USD za sztukę
(2,27 USD za 1000 sztuk)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

SKU: wykorzystanie sesji autouzupełniania

Za każde żądanie wysłane do interfejsu Autocomplete API (New) z tokenem sesji pobierana jest opłata zgodnie z kodem SKU Autocomplete Session Usage.

Ta subskrypcja SKU jest opłacana 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 (poziom 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: Adres weryfikacji preferowany.

Więcej informacji znajdziesz w artykule Autouzupełnianie (nowa wersja) i cena sesji.

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

SKU: informacje o miejscu (tylko identyfikatory)

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

Android: Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME

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:

Android: Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS
Place.Field.LOCATION
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,005 USD za sztukę
(5,00 USD za 1000 szt.)		 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:

Android: Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.BUSINESS_STATUS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

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:

Android Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI

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:

Android Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,025 USD za sztukę
(25 USD za 1000 sztuk)		 0,020 USD za sztukę
(20,00 USD za 1000 szt.)		 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. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Android: Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_URL
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.ID
Place.Field.NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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 w pobliżu (zaawansowane)

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. Ta SKU jest uruchamiany, gdy żądasz tylko tych pól:

Android Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI

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

SKU: wyszukiwanie w pobliżu (preferowane)

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

Android Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,040 USD za sztukę
(40,00 USD za 1000 szt.)		 0,032 USD za sztukę
(32 USD za 1000 szt.)		 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:

Android: Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.RESOURCE_NAME

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

SKU: wyszukiwanie tekstowe (podstawowe)

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

Android: Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.LOCATION
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.SUB_DESTINATIONS
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,032 USD za sztukę
(32 USD za 1000 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:

Android Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI

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

SKU: wyszukiwanie tekstu (preferowane)

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

Android Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
0,040 USD za sztukę
(40,00 USD za 1000 szt.)		 0,032 USD za sztukę
(32 USD za 1000 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 Androida

Informacje o sesjach autouzupełniania

Sesja autouzupełniania obejmuje niektóre żądania autouzupełniania (aby pobrać sugestie dotyczące miejsca, gdy użytkownik je wpisze) oraz maksymalnie 1 żądanie szczegółów miejsc (aby pobrać szczegóły miejsca wybranego przez użytkownika). Ten sam token sesji jest przekazywany do funkcji autouzupełniania i kolejnych żądań szczegółów miejsca. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (co zwykle następuje, gdy użytkownik zacznie pisać). Gdy użytkownik wybierze jedną z sugestii autouzupełniania, wywoływana jest metoda 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 przeznaczony do 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 autouzupełniania i żądania dotyczące szczegółów miejsc korzystające z sesji są rozliczane za pomocą innych SKU.

Informacje o kodach SKU danych o miejscach

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

W przypadku co najmniej 1 poziomu usług danych:

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

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

SKU: dane podstawowe

Za pomocą parametru fields w żądaniu dotyczącej szczegółów miejsca lub znajdowania miejsca możesz ograniczyć odpowiedź tylko do określonych pól. Pola w kategorii Podstawowe są uwzględnione w kosztach podstawowych prośby o dane o miejscach i nie powodują dodatkowych opłat. Kod SKU Dane podstawowe jest uruchamiany, gdy zostanie przesłane żądanie dotyczące któregokolwiek z tych pól:

  • Android: Place.Field.ACCESSIBILITY_OPTIONS,Place.Field.ADDRESS_COMPONENTS,Place.Field.BUSINESS_STATUS,Place.Field.DISPLAY_NAME,Place.Field.FORMATTED_ADDRESS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_MASK_URL,Place.Field.ID,Place.Field.LOCATION,Place.Field.PHOTO_METADATAS,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORT lub Place.Field.UTC_OFFSET.
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes lub GMSPlaceFieldViewport
  • Usługa internetowa: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity lub wheelchair_accessible_entrance
LICZBA POŁĄCZEŃ MIESIĘCZNIE
(cena za POŁĄCZENIE)
0–100 tys. 100 001–500 000 Ponad 500 tys.
Koszt prośby o utworzenie miejsca
+ 0,00 USD		 Koszt prośby o utworzenie miejsca
+ 0,00 USD		 Koszt prośby o utworzenie miejsca
+ 0,00 USD

SKU: dane kontaktowe

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

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

SKU: dane dotyczące atmosfery

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

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

SKU: Autouzupełnianie – na żądanie

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 tokenu sesji) również naliczamy opłatę za SKU Autouzupełnianie – na żądanie.

Żądania autouzupełniania z interfejsu Maps JavaScript API – widżet autouzupełniania miejsca mogą być obciążone stawką autouzupełniania na żą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 widżetu i nie zawsze wybierze przewidywanego uzupełnienia.

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

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

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

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

Przykład

Jeśli aplikacja wysyła te 2 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 docelowego – 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 dotyczącym szczegółów miejsca, zostaną uruchomione wszystkie SKU danych (podstawowe, kontaktowe i atmosferyczne).

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

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

Przykład

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

Android

iOS

Usługa internetowa

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

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

SKU: informacje o miejscach

Połączenia z serwisem Places Details są naliczane w ten sposób:

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

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

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

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

Przykłady

  1. Wykonaj jedno z tych 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 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 PHONE_NUMBER.
    • Interfejs API lub usługa internetowa: prześlij żądanie szczegółów miejsca i wskaż pole numeru telefonu:getPlaceDetails(fields: formatted_phone_number)
    Na fakturze zobaczysz te kody SKU (wyświetlając fakturę według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
  3. Wykonaj jedno z tych 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 fakturze zobaczysz te kody SKU (wyświetlając fakturę według kodu SKU):
    • Szczegóły miejsca (cena zaczyna się od 0,017 USD za sesję)
    • Dane podstawowe (obciążenie 0,00 USD)
    • Dane kontaktowe (cena zaczyna się od 0,003 USD za prośbę)
    • Dane o atmosferze (cena zaczyna się od 0,005 USD za żądanie)

SKU: 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 szt.)		 Aby poznać ceny hurtowe, skontaktuj się z zespołem sprzedaży.

Wywołania do 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żącej lokalizacji (cena od 0,030 USD za każde żądanie)
    • 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.

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 SDK Places na Androida lub spełniać wymagania związane z ruchem produkcyjnym, ustaw dzienne limity kwotowe na wszystkie żądania do dowolnego interfejsu API. Dzienne limity są resetowane o północy czasu pacyficznego.

Aby wyświetlić lub zmienić limity pakietu SDK Miejsc na Androida:

  1. W konsoli Google Cloud otwórz stronę Limity platformy Mapy Google.
  2. Kliknij menu interfejsów API i wybierz Pakiet SDK Miejsc na Androida.
  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 płatnej puli (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.