iOS'te Kullanım ve Faturalandırma İçin Yerler SDK'sı

Hata: kGMSPlacesRateLimitExceeded

iOS için Yerler SDK'sı, kullandıkça öde fiyatlandırma modelini kullanır. Yerler API'sine yönelik iOS istekleri için Yerler SDK'sı SKU'ya göre faturalandırılır. Genel Google Kullanım Şartları'nın yanı sıra, iOS için Yerler SDK'sına özgü kullanım sınırları vardır. Google Cloud Console'da sunulan araçlarla maliyetlerinizi ve kullanımınızı yönetin.

iOS için Yerler SDK'sı nasıl faturalandırılır?

iOS için Yerler SDK'sı, kullandıkça öde fiyatlandırma modelini kullanır. Google Haritalar Platformu API'leri ve SDK'ları SKU'ya göre faturalandırılır. Kullanım her SKU için izlenir ve herhangi bir API veya SDK birden fazla ürün SKU'suna sahip olabilir. Maliyet şu şekilde hesaplanır:

SKU kullanımı × Her bir kullanımın fiyatı

API veya SDK başına kullanım maliyetinizi tahmin etmek için Fiyat ve Kullanım hesaplayıcımızı kullanın. Koşulları karşılayan Google Haritalar Platformu SKU'larında, her faturalandırma hesabı için her ay 200 ABD doları değerinde Google Haritalar Platformu kredisi kullanılabilir. Bu kredi, uygun SKU'lara1 otomatik olarak uygulanır.

iOS için Yerler SDK'sının fiyatlandırması

Otomatik tamamlama oturumları hakkında

Otomatik tamamlama oturumu, bazı otomatik tamamlama isteklerini (kullanıcı türü olarak bir yer hakkındaki önerileri almak için) ve en fazla bir Yer Ayrıntıları isteği (kullanıcı tarafından seçilen yer hakkındaki ayrıntıları almak için) içerir. Aynı oturum jetonu, Otomatik Tamamlama ve sonraki Yer Ayrıntısı isteklerine iletilir. Bir oturum, ilk otomatik tamamlama isteğiyle başlar (genellikle kullanıcı yazmaya başladığında gerçekleşir). Kullanıcı Otomatik tamamlama önerilerinden birini seçtiğinde bir Yer Ayrıntıları çağrısı yapılır. Kullanıcı bir öneri seçmezse Yer Ayrıntıları çağrısı yapılmaz.

Kullanıcı bir yer seçtikten sonra (Yer Ayrıntıları çağrısı yapıldıktan sonra) yeni bir oturum jetonu kullanarak yeni bir oturum başlatmanız gerekir.

Otomatik tamamlama oturumları aşağıdaki API'lerden oluşturulabilir:

Oturum jetonu bir kullanıcı oturumu için uygundur ve birden fazla kullanıcı oturumu için kullanılmamalıdır. Bir oturum jetonunu yeniden kullanırsanız oturum geçersiz sayılır ve istekler, hiçbir oturum jetonu sağlanmamış gibi ücretlendirilir.

Oturumları kullanan Yer Tamamlama istekleri ve Yer Ayrıntıları istekleri farklı SKU'lara faturalandırılır.

Yerler Veri SKU'ları hakkında

Üç Yer Verisi SKU'su vardır: Temel Veriler, İletişim Verileri ve Atmosfer Verileri.

Aşağıdakiler için bir veya daha fazla Veri SKU'su tetiklenir:

  • Android: fetchPlace() veya findCurrentPlace() istekleri
  • iOS: fetchPlaceFromPlaceID: veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: çağrıları
  • Web hizmeti: İstekte belirtilen alanlara bağlı olarak her bir Yer isteği

Veri SKU'ları, onları tetikleyen istek için temel SKU'ya ek olarak her zaman ücretlendirilir. Örneğin, Temel Veri alanlarını içeren Yer Ayrıntıları istekleri hem Temel Veri SKU'su ve Yer Ayrıntıları SKU'su altında ücretlendirilir.

SKU: Temel Veriler

Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini kullanarak, yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Temel kategorisindeki alanlar, Yerler isteğinin temel maliyetine dahil edilir ve ek ücret ödenmesine neden olmaz. Temel Veriler SKU'su, bu alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET veya Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes veya GMSPlaceFieldViewport
  • Web hizmeti: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity veya wheelchair_accessible_entrance
AYLIK VOLUME ARALIĞI
(TELEFON GÖRÜŞMESİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Yer isteme maliyeti
+ 0,00 ABD doları		 Yer isteme maliyeti
+ 0,00 ABD doları		 Yer isteme maliyeti
+ 0,00 ABD doları

SKU: İletişim Verileri

Yer Ayrıntıları'nda veya Web hizmetleri için Yer Bulma isteğindeki alanlar parametresini ya da Android veya iOS için bir Place.Field dizisini kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. İletişim kategorisindeki alanlar ek ücret gerektirir. Contact Data SKU'su, aşağıdaki alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS veya Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber veya GMSPlaceFieldWebsite
  • Web hizmeti: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours veya website
AYLIK VOLUME ARALIĞI
(TELEFON GÖRÜŞMESİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Yerler için maliyet maliyeti
+ birim başına 0,003 ABD doları
(+1000 başına 3,00 ABD doları)		 Yerler için maliyet maliyeti
+ her biri için 0,0024 ABD doları
(+1000 başına 2,40 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

SKU: Atmosfer Verileri

Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini kullanarak, yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Atmosfer kategorisindeki alanlar ek ücret alınmasına neden olur. Atmosfer Verileri SKU'su, aşağıdaki alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, 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 veya Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch veya GMSPlaceFieldServesVegetarianFood.
  • JavaScript: Alanlar (Yer ayrıntıları) konusuna bakın
  • Web hizmeti: 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 veya user_ratings_total.
AYLIK VOLUME ARALIĞI
(TELEFON GÖSTERİMİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Yerler için maliyet maliyeti
+ her biri için 0,005 ABD doları
(+1.000 başına 5,00 ABD doları)		 Yerler için maliyet maliyeti
+ ürün başına 0,004 ABD doları
(+1000 başına 4,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

SKU: Otomatik Tamamlama – İstek Başına

Otomatik tamamlama – İstek Başına SKU'su, oturum jetonu içermeyen aşağıdaki çağrılar veya isteklerden herhangi biri için ücretlendirilir:

Geçersiz bir Otomatik Tamamlama oturumundan (ör. oturum jetonunu yeniden kullanan bir oturum) yapılan görüşmelere de Otomatik Tamamlama – İstek Başına SKU ücreti uygulanır.

Haritalar JavaScript API'sinin Yer Otomatik Tamamlama Widget'ından gelen otomatik tamamlama istekleri, geçersiz bir Otomatik Tamamlama oturumundan yapılan aramalar için Otomatik Tamamlama – İstek Başına SKU ücreti alınabilir. Bu durum, bir kullanıcı birden fazla farklı adres yazarken veya widget'a farklı adresler kopyalayıp yapıştırdığında ve her zaman bir otomatik tamamlama tahmini seçmediğinde ortaya çıkabilir.

AYLIK VOLUME ARALIĞI
(İSTEK başına fiyat)
0-100.000 100.001-500.000 500.000+

başına 0,00283 ABD doları(1.000 başına 2,83 ABD doları)		 Her biri için 0,00227 ABD doları
(1.000 başına 2,27 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

SKU: Yer Ayrıntıları olmadan Otomatik Tamamlama – Oturum Başına

Yer Ayrıntıları Olmadan Otomatik Tamamlama – Oturum Başına SKU'su, Yer Ayrıntıları isteği içermeyen bir Otomatik tamamlama oturumu için ücretlendirilir (oturum başladıktan birkaç dakika sonra).

AYLIK VOLUME ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001-500.000 500.000+
Her biri için 0,017 ABD doları
(1000 gösterim başına 17,00 ABD doları)		 Her
0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

Örnek

Uygulamanız tek bir oturumda şu iki aramayı yayınlarsa:

Android

iOS

Web hizmeti

Faturanızda şu SKU'nun listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer Ayrıntıları olmadan Otomatik Tamamlama - Oturum Başına (oturum başına 0,017 ABD dolarından başlayan fiyatlar)

SKU: Otomatik tamamlama (Yer Ayrıntıları dahil) - Oturum Başına

Otomatik tamamlama (Yer Ayrıntıları dahil) - Oturum Başına SKU'su, aşağıdakilerden birini içeren bir Otomatik tamamlama oturumu için ücretlendirilir:

  • Android: fetchPlace() çağrısı
  • iOS: fetchPlaceFromPlaceID: çağrısı
  • Web hizmeti: Yer Ayrıntıları isteği

Otomatik tamamlama isteği ücretsiz olarak sunulur ve sonraki Yer Ayrıntıları çağrısı için normal Yer Ayrıntıları fiyatlandırmasına göre ödeme alınır.

Yer Ayrıntıları istekleri, istekte belirtilen alanlara bağlı olarak Veri SKU'ları (Temel, İletişim ve/veya Atmosfer) oluşturur.

Yer Ayrıntıları isteğinde alan belirtmezseniz tüm Veri SKU'ları (Temel, İletişim ve Atmosfer) tetiklenir.

Otomatik tamamlama oturumu sırasındaki Yer Ayrıntıları Kimliği yenileme istekleri (yalnızca place_id alanını belirten istekler) SKU: Otomatik Tamamlama (Yer Ayrıntıları hariç) - Oturum Başına şeklinde faturalandırılır.

AYLIK VOLUME ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001-500.000 500.000+
0,00 ABD Doları 0,00 ABD Doları 0,00 ABD Doları

Örnek

Uygulamanız tek bir oturumda aşağıdaki üç aramayı yayınlarsa:

Android

iOS

Web hizmeti

Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Otomatik tamamlama (Yer Ayrıntıları dahil) - Oturum Başına (0,00 ABD Doları faturalandırma)
  • Yer Ayrıntıları (oturum başına 0,017 ABD dolarından başlayan fiyatlar)
  • Temel Veriler (0,00 ABD doları faturalandırma)

SKU: Yer Ayrıntıları

Yer Ayrıntıları aramaları aşağıdaki şekilde ücretlendirilir:

AYLIK VOLUME ARALIĞI
(TELEFON GÖSTERİMİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Her biri için 0,017 ABD doları
(1000 gösterim başına 17,00 ABD doları)		 Her
0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

Yer Ayrıntıları SKU'su şu API'lerden oluşturulur:

Yer API'si, web API'si ve hizmetlerde bir oturum jetonu sağlanıp sağlanmamasına bakılmaksızın ücretlendirilir.

Yer Ayrıntıları çağrısı veya isteği, çağrıda veya istekte belirtilen alanlara bağlı olarak Veri SKU'ları (Temel, İletişim ve/veya Atmosfer) de oluşturur. Yer Ayrıntıları çağrısında veya isteğinde HAYIR alanları belirtilirse TÜM Veri SKU'ları tetiklenir ve Yer Ayrıntıları çağrısı veya isteği için ek veri ücreti alınır.

Örnekler

  1. Aşağıdaki aramalardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() veya iOS'ta fetchPlaceFromPlaceID: çağrısı yapın ve yalnızca ADDRESS alanını belirtin
    • Web API veya hizmeti: Yer Ayrıntıları isteğinde bulunun ve yalnızca adres alanını belirtin: getPlaceDetails(fields: formatted_address)
    Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları faturalandırma)
  2. Aşağıdaki aramalardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() veya iOS'ta fetchPlaceFromPlaceID: çağrısı yapın ve yalnızca PHONE_NUMBER alanını belirtin
    • Web API veya hizmeti: Yer Ayrıntıları isteğinde bulunun ve telefon numarası alanını belirtin: getPlaceDetails(fields: formatted_phone_number)
    Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 ABD dolarından başlayan fiyatlar)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
  3. Aşağıdaki aramalardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() veya iOS'ta fetchPlaceFromPlaceID: çağırıp tüm alanları belirtin
    • Web API veya hizmeti: Yer Ayrıntıları isteğinde bulunun ve tüm alanları belirtin (herhangi bir alan belirtmezseniz varsayılan olarak bu tür istekler gönderilir): getPlaceDetails().
    Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları faturalandırma)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyatlar)

SKU: Mevcut Yeri Bulma

findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) numaralı telefona yapılan aramalar için Geçerli Yeri Bul ücreti alınır.

AYLIK VOLUME ARALIĞI
(TELEFON GÖRÜŞMESİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Her biri için 0,030 ABD doları
(1000 başına 30,00 ABD doları)		 Her biri için 0,024 ABD doları
(1000 başına 24,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) için yapılan çağrılar, görüşmede belirtilen alanlara bağlı olarak Veri SKU'ları (Temel, İletişim ve/veya Atmosfer) de oluşturur. Yanıtı yalnızca bu alanlarla sınırlandırmak için veri alanlarını belirtin. Mevcut Yeri Bulma çağrısı ve istenen veriler için faturalandırılırsınız.

Örnekler

  1. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) çağırır ve yalnızca ADDRESS alanını belirtirsiniz. Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Mevcut Yeri Bulma (istek başına 0,030 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları faturalandırma)
  2. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) çağırıp PHONE_NUMBER alanını belirtirsiniz. Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Mevcut Yeri Bulma (istek başına 0,030 ABD dolarından başlayan fiyatlar)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
  3. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) yöntemini çağırıyorsunuz ve üç veri türü grubunun tamamından alanlar belirliyorsunuz. Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Mevcut Yeri Bulma (istek başına 0,030 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları faturalandırma)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyatlar)

SKU: Yer Fotoğrafı

Yer Fotoğrafı SKU'su aşağıdakiler için ücretlendirilir:

JavaScript hizmeti için PlacePhoto.getUrl() yönteminin çağrılması, URL gerçekten piksel verilerini almak için kullanılana kadar faturalandırmaya neden olmaz.

AYLIK VOLUME ARALIĞI
(TELEFON GÖSTERİMİ başına fiyat)
0-100.000 100.001-500.000 500.000+
Her biri için 0,007 ABD doları
(1000 başına 7,00 ABD doları)		 Her biri için 0,0056 ABD doları
(1.000 başına 5,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibi ile iletişime geçin

Diğer kullanım sınırları

Günlük maksimum istek sayısı olmasa da iOS için Yerler SDK'sı kullanılırken aşağıdaki kullanım sınırı geçerlidir:

  • Sıklık sınırı saniyede 100 istektir. Aynı projenin kimlik bilgilerini kullanan tüm uygulamalar için istemci taraflı ve sunucu tarafı isteklerin toplamı olarak hesaplanır.

Kullanım Şartları kısıtlamaları

Kullanım şartları hakkında daha fazla bilgi edinmek için Google Haritalar Platformu Hizmet Şartları'nın Lisans Kısıtlamaları bölümüne bakın.

Kullanım maliyetinizi yönetin

Google Haritalar Platformu API'lerinin kullanım maliyetini yönetmek için faturalandırılabilir API'lere yapılan tüm isteklerle ilgili günlük kota sınırları belirleyin. Günlük kotalar Pasifik saatine göre gece yarısında sıfırlanır.

iOS için Yerler SDK'sının kota sınırlarını görüntülemek veya değiştirmek üzere:

  1. Cloud Console'da Google Haritalar Platformu Kotaları sayfasını açın.
  2. API'lerin açılır menüsünü tıklayın ve iOS için Yerler SDK'sı seçeneğini belirleyin.
  3. Kota sınırlarını görüntülemek için İstekler kartına ilerleyin.
    Tablo, kota adlarını ve sınırlarını listeler.
  4. Bir kota sınırını değiştirmek için ilgili sınırın Düzenle simgesini tıklayın.
    Görüntülenen iletişim kutusunda Kota Sınırı alanına, faturalandırılabilir tercih edilen günlük kota sınırını (Google tarafından belirtilen kota sınırına kadar) girin ve Kaydet'i seçin.

API kullanımınız belirli bir günde faturalandırılabilir kota sınırınıza ulaşırsa uygulamanız günün geri kalanında API'ye erişemez.

  1. Hindistan'daki kullanıcıların, Haritalar Platformu kredisine hak kazanmak için Google Haritalar Platformu faturalandırma hesabı oluşturmadan önce Google Cloud Platform faturalandırma hesabı oluşturması gerekir. ↩