iOS Kullanımı ve Faturalandırması için Yerler SDK'sı

Hata: kGMSPlacesRateLimitExceeded

iOS için Yerler SDK'sı, kullandıkça öde fiyatlandırma modelini kullanır. Places API için iOS isteklerine yönelik Yerler SDK'sı, SKU tarafından 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ı da vardır. Google Cloud Console'daki 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'nin veya SDK'nın birden fazla ürün SKU'su olabilir. Maliyet şöyle hesaplanır:

SKU kullanımı × Her kullanım başına fiyat

API veya SDK başına kullanım maliyetinizi tahmin etmek için Fiyatlandırma ve Kullanım Hesaplayıcı'yı kullanın. Uygun 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'lara otomatik olarak uygulanır1.

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

Otomatik tamamlama oturumları hakkında

Bir Otomatik Tamamlama oturumu, bazı Otomatik Tamamlama isteklerini (kullanıcı yazarken bir yerden öneriler almak için) ve en fazla bir Yer Ayrıntıları isteği (kullanıcı tarafından seçilen yerle ilgili ayrıntıları almak için) içerir. Aynı oturum jetonu, Otomatik Tamamlama ve sonraki Yer Ayrıntısı isteğine iletilir. Oturum, ilk Otomatik Tamamlama isteğiyle başlar (bu genellikle kullanıcı yazmaya başladığında gerçekleşir). Kullanıcı, Otomatik tamamlama önerilerinden birini seçtiğinde Yer Ayrıntıları çağrısı yapılır. Kullanıcı bir öneriyi seçmezse Yer Ayrıntıları çağrısı yapılmaz.

Bir kullanıcı bir yer seçtikten sonra (yani, 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:

Bir 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 için hiçbir oturum jetonu sağlanmamış gibi ücret alınır.

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

Yer Verileri SKU'ları hakkında

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

Şunlar için bir veya daha fazla Veri SKU'su tetiklenir:

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

Veri SKU'ları, kendilerini tetikleyen istek için her zaman temel SKU'ya ek olarak ücretlendirilir. Örneğin, Temel Veri alanları içeren bir Yer Ayrıntısı isteği, hem Temel Veri SKU'su hem de Yer Ayrıntısı 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 herhangi bir ek ücretle sonuçlanmaz. Temel Veriler SKU'su, şu 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 HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ 0,00 TRY		 Yer isteği maliyeti
+ 0,00 TRY		 Yer isteği maliyeti
+ 0,00 TRY

SKU: İletişim Verileri

Web hizmetleri için Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini ya da Android veya iOS için bir Place.Field dizisi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Kişi kategorisindeki alanlar ek ücrete tabidir. İletişim Verileri SKU'su, şu 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 HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ her biri için 0,003 ABD doları
(+ 1.000 başına 3 ABD doları)		 Yer isteği maliyeti
+ her biri için 0,0024 ABD doları
(+ 1.000 başına 2,40 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletiş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 ücrete tabidir. Atmosfer Verileri SKU'su, aşağıdaki alanlardan herhangi biri istendiğinde tetiklenir:

  • 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 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 HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ her biri için 0,005 ABD doları
(+ 1.000 başına 5 ABD doları)		 Yer isteği maliyeti
+ her biri için 0,004 ABD doları
(+ 1.000 başına 4,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Otomatik Tamamlama - İstek Başına

Otomatik Tamamlama - İstek Başına SKU'su, oturum jetonu içermeyen şu çağrı veya istekler için ücretlendirilir:

Geçersiz bir Otomatik Tamamlama oturumundan (örneğin, bir oturum jetonunu yeniden kullanan bir oturum) yapılan aramalardan da Otomatik Tamamlama - İstek Başına SKU'su için ücret alınır.

Haritalar JavaScript API'sinin Otomatik Tamamlama Widget'ından gelen Otomatik Tamamlama isteklerinden, geçersiz bir Otomatik Tamamlama oturumundan çağrı yapılması durumunda Otomatik Tamamlama – İstek Başına SKU'su alınabilir. Bu durum, bir kullanıcı birden çok farklı adres yazarken veya farklı adresleri kopyalayıp widget'a yapıştırdığında ve her zaman bir otomatik tamamlama tahmini seçmediğinde ortaya çıkabilir.

AYLIK SAYI ARALIĞI
(İSTEK başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,00283 ABD doları(1.000 başına 2,83 ABD doları)		 Her bir
için 0,00227 ABD doları(1.000 başına 2,27 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

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

Yer Ayrıntıları olmadan Otomatik Tamamlama SKU'su, Yer Ayrıntısı isteği içermeyen (oturumun başlangıcından birkaç dakika önce) Otomatik Tamamlama oturumu için ücretlendirilir.

AYLIK SAYI ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Örnek

Uygulamanız tek bir oturumda şu iki çağrıyı yaparsa:

Android

iOS

Web hizmeti

Faturanızda bu 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 herhangi 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ısı isteği

Otomatik tamamlama isteği ücretsizdir ve sonraki Yer Ayrıntısı araması için normal Yer Ayrıntıları fiyatlandırmasına göre ücret alınır.

Yer Ayrıntısı isteği, istekte belirtilen alanlara bağlı olarak Veri SKU'ları (Temel, Kişi ve/veya Atmosfer) oluşturur.

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

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

AYLIK SAYI ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
0.00 TRY 0.00 TRY 0.00 TRY

Örnek

Uygulamanız tek bir oturumda aşağıdaki üç çağrıyı yaparsa:

Android

iOS

Web hizmeti

Faturanızda şu SKU'ların listelendiğini 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ı üzerinden faturalandırılır)
  • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
  • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)

SKU: Yer Ayrıntıları

Yer Ayrıntısı aramaları şu şekilde ücretlendirilir:

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

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

Web API ve hizmetlerde, oturum jetonu sağlanıp sağlanmadığına bakılmaksızın Yer Ayrıntıları SKU'su ücretlendirilir.

Yer Ayrıntıları çağrısı veya isteği, çağrıda ya da istekte belirtilen alanlara bağlı olarak Veri SKU'ları da (Temel, Kişi ve/veya Atmosfer) 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 ile tüm verilerin maliyeti için ücretlendirilirsiniz.

Örnekler

  1. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() uygulamasını veya iOS'ta fetchPlaceFromPlaceID: uygulamasını çağırın ve yalnızca ADDRESS alanını belirtin
    • Web API veya hizmet: Yer Ayrıntıları isteğinde bulunun ve yalnızca adres alanını belirtin: getPlaceDetails(fields: formatted_address)
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  2. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() uygulamasını veya iOS'ta fetchPlaceFromPlaceID: uygulamasını çağırın ve yalnızca PHONE_NUMBER alanını belirtin
    • Web API veya hizmet: Yer Ayrıntıları isteğinde bulunun ve telefon numarası alanını belirtin: getPlaceDetails(fields: formatted_phone_number)
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  3. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() yöntemini veya iOS'te fetchPlaceFromPlaceID: uygulamasını çağırın ve tüm alanları belirtin
    • Web API veya hizmet: Bir Yer Ayrıntısı isteği yapın ve tüm alanları belirtin (herhangi bir alan belirtmezseniz bu istek türü varsayılandır): getPlaceDetails().
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Mevcut Yeri Bulma

Mevcut Yeri Bulma findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) çağrıları için ücretlendirilir.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,030 ABD doları(1.000 başına 30,00 ABD doları)		 Her bir
başına 0,024 ABD doları(1.000 başına 24,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Görüşmede belirtilen alanlara bağlı olarak findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) çağrıları da Veri SKU'ları (Temel, Kişi ve/veya Atmosfer) oluşturur. Yanıtı yalnızca bu alanlarla sınırlamak için veri alanları belirtin. Mevcut Yeri Bul çağrısı ve istenen veriler için faturalandırılırsınız.

Örnekler

  1. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) yöntemini çağırın ve yalnızca ADDRESS alanını belirtin. Faturanızda şu SKU'ların listelendiğini 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 fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  2. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) yöntemini çağırıp PHONE_NUMBER alanını belirtirsiniz. Faturanızda şu SKU'ların listelendiğini 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 fiyat)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  3. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) yöntemini çağırır ve üç veri türü paketinin tümünden alanlar belirtirsiniz. Faturanızda şu SKU'ların listelendiğini 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 fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Yer Fotoğrafı

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

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

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,007 ABD doları(1.000 başına 7,00 ABD doları)		 Her bir
için 0,0056 ABD doları(1.000 başına 5,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

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

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

  • Hız sınırı 6.000 QPM'dir (dakika başına istek sayısı). 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 bilgi için Google Haritalar Platformu Hizmet Şartları'nın Lisans Kısıtlamaları bölümüne bakın.

Kullanım maliyetinizi yönetin

iOS için Yerler SDK'sı kullanım maliyetinizi yönetmek veya üretim trafiğinizin taleplerini karşılamak amacıyla herhangi bir API'ye yapılan tüm istekler için 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'ler 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 gidin.
    Bir tabloda kota adları ve sınırları listelenir.
  4. Bir kota sınırını değiştirmek için, söz konusu sınırın Düzenle simgesini tıklayın.
    Açılan iletişim kutusundaki Kota Sınırı alanına, tercih ettiğiniz faturalandırılabilir 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 herhangi 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 Maps Platform kredisini almak için Google Haritalar Platformu faturalandırma hesabı oluşturmadan önce Google Cloud Platform faturalandırma hesabı oluşturmaları gerekir. ↩