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 özel 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 bazında faturalandırılır. Kullanım her SKU için izlenir ve herhangi bir API veya SDK'nın birden fazla ürün SKU'su olabilir. Maliyet şuna göre hesaplanır:

SKU kullanımı × Her kullanım için fiyat

API veya SDK başına kullanım maliyetinizi tahmin etmek için Fiyat ve Kullanım Hesaplayıcımızı 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 olarak1 uygulanır.

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

Otomatik tamamlama oturumları hakkında

Otomatik Tamamlama oturumu, bazı Otomatik Tamamlama isteklerini (kullanıcı yazarken bir yere ö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.

Kullanıcı bir yer seçtikten sonra (ör. bir Yer Ayrıntıları çağrısı yapıldığında), 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 kabul edilir ve istekler, hiçbir oturum jetonu sağlanmamış gibi ücretlendirilir.

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 şunlardı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: her bir fetchPlaceFromPlaceID: veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: çağrısı
  • Web hizmeti: İstekte belirtilen alanlara bağlı olarak her bir Rehber isteği

Veri SKU'ları, kendilerini tetikleyen isteğin temel SKU'suna ek olarak her zaman ücretlendirilir. Örneğin, Temel Veriler alanlarını içeren bir Yer Ayrıntıları isteği, hem Temel Veri SKU'su hem de 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 herhangi bir ek ücrete neden olmaz. 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, GMSPlaceFieldBusinessStatus, 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 HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
Yer isteği maliyeti
+ 0,00 ABD doları
Yer isteği maliyeti
+ 0,00 ABD doları
Yer isteği maliyeti
+ 0,00 ABD doları

SKU: İletişim Verileri

Web hizmetleri için Yer Ayrıntılarındaki veya Yer Bulma isteğinizdeki alanlar parametresini ya da Android veya iOS için bir Place.Field dizisini 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 HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
Yer isteği maliyeti
+ Her biri için 0,003 ABD doları
(+ 1.000 başına 3,00 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, şu 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 HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
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

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

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

Haritalar JavaScript API'sinin Yer 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 için ücret alınabilir. Bu durum, bir kullanıcı birden fazla farklı adres yazdığında veya farklı adresleri kopyalayıp widget'a yapıştırdığında ve her zaman bir otomatik tamamlama tahmini seçmediğinde ortaya çıkabilir.

AYLIK HACİM ARALIĞI
(İSTEK başına fiyat)
0–100.000 100.001–500.000 500.000+
Her bir
başına 0,00283 ABD doları(1.000 başına 2,83 ABD doları)
Her bir
başına 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 - Oturum Başına SKU'su, Yer Ayrıntısı isteği içermeyen Otomatik Tamamlama oturumu için ücretlendirilir (oturumun başlamasından itibaren birkaç dakika içinde).

AYLIK HACİM ARALIĞI
(OTURUM başına fiyat)
0–100.000 100.001–500.000 500.000+
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)
Her bir
başına 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() numarasına gelen çağrı
  • iOS: fetchPlaceFromPlaceID:'a yapılan çağrı
  • Web hizmeti: Yer Ayrıntısı isteği

Otomatik tamamlama isteği ücretsizdir ve bir sonraki Yer Ayrıntısı çağrısı için normal Yer Ayrıntıları fiyatlandırması uygulanır.

Yer Ayrıntıları 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ı (Temel, Kişi ve Atmosfer) tetiklenir.

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 şeklinde faturalandırılır.

AYLIK HACİM ARALIĞI
(OTURUM başına fiyat)
0–100.000 100.001–500.000 500.000+
0.00 TRY 0.00 TRY 0.00 TRY

Örnek

Uygulamanız tek bir oturumda aşağıdaki üç çağrıyı gerçekleştirirse:

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 ABD dolarından başlayan fiyatlar)
  • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)

SKU: Yer Ayrıntıları

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

AYLIK HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)
Her bir
başına 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'si ve hizmetlerinde, oturum jetonunun sağlanıp sağlanmamasından bağımsız olarak Yer Ayrıntıları SKU'su ücretlendirilir.

Yer Ayrıntıları çağrısı veya isteği, çağrıda veya istekte belirtilen alanlara bağlı olarak Veri SKU'ları da (Temel, Kişi ve/veya Atmosfer) oluşturur. Yer Ayrıntısı çağrısında veya isteğinde HAYIR alanı 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 arama veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace(), iOS'te ise fetchPlaceFromPlaceID: çağrısı yapı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 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  2. Aşağıdaki arama veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace(), iOS'te ise fetchPlaceFromPlaceID: çağrısı yapı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 ABD dolarından başlayan fiyatlar)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
  3. Aşağıdaki arama veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() veya iOS'te fetchPlaceFromPlaceID: adlı uygulamayı ç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 (alan belirtmezseniz bu istek türü varsayılan seçenektir): 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 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
    • İ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

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

AYLIK HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
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) için yapılan ç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ını 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ır ve yalnızca ADDRESS 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 Bulun (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ın ve 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 Bulun (istek başına 0,030 ABD dolarından başlayan fiyat)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyatlar)
  3. findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) yöntemini çağırın ve üç veri türü paketin 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 Bulun (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 fiyatlar)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyatlar)

SKU: Yer Fotoğrafı

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

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

AYLIK HACİM ARALIĞI
(ARAMA başına fiyat)
0–100.000 100.001–500.000 500.000+
Her bir
başına 0,007 ABD doları(1.000 başına 7,00 ABD doları)
Her bir
başına 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ı üst sınırı yoktur. Bununla birlikte, iOS için Yerler SDK'sı kullanılırken aşağıdaki kullanım sınırı geçerlidir:

  • 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 tarafı ve sunucu tarafı isteklerin toplamı olarak hesaplanır.

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

Kullanım şartları hakkında 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

iOS için Yerler SDK'sı kullanım maliyetinizi yönetmek veya üretim trafiğinizin gereksinimlerini karşılamak amacıyla herhangi bir API'ye yapılan tüm isteklerde 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 sayfayı aşağı kaydırarak İstekler kartına gidin.
    Kota adları ve sınırları bir tabloda listelenmiştir.
  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.
    Görüntülenen iletişim kutusundaki Kota Sınırı alanına, tercih edilen 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.

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


  1. Hindistan'daki kullanıcıların Haritalar Platformu kredisini almak için Google Haritalar Platformu faturalandırma hesabı oluşturmadan önce Google Cloud Platform faturalandırma hesabı oluşturmaları gerekir.