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

Hata: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

Android için Yerler SDK'sı, kullandıkça öde fiyatlandırma modelini kullanır. Android için Yerler SDK'sının Android isteklerine yönelik Yerler SDK'sı SKU tarafından faturalandırılır. Genel Google Kullanım Şartları'nın yanı sıra, Android için Yerler SDK'sına özel kullanım sınırları mevcuttur. Google Cloud Console'da sunulan araçlarla maliyetlerinizi ve kullanımınızı yönetin.

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

Android 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'nın birden fazla ürün SKU'su 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. 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'lara1 otomatik olarak uygulanır.

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

Otomatik tamamlama oturumları hakkında

Otomatik tamamlama oturumu, bazı otomatik tamamlama istekleri (bir yer hakkında kullanıcı türü olarak öneriler 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ı isteğine 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ılmaz.

Kullanıcı bir yer seçtiğinde (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 kullanışlıdır 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.

Yerler Veri SKU'ları hakkında

Yer verileri üç SKU'dur: 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 Yerler 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 hem de Yer Ayrıntıları SKU'su kapsamında ücretlendirilir.

SKU: Temel Veriler

Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini kullanarak yanıtı sadece belirtilen alanlarla sınırlandırabilirsiniz. Temel kategorisindeki alanlar, Yerler isteğinin temel maliyetine dahil edilir ve ek ücret alınmasına neden olmaz. Temel Veriler SKU'su, aşağıdaki 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 SES MESAJI
(ARAMA başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
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

Yer ayrıntılarındaki alanlar parametresini veya web hizmetleri için Yer bulma isteğini ya da Android veya iOS için Place.Field dizisini kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. İletişim kategorisindeki alanlar ek ücret alınmasına neden olur. İletişim Verileri 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 SES MESAJI
(ARAMA 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,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ı sadece 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.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ı) bölümüne 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 SES MESAJI
(ARAMA 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,00 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, oturum jetonu içermeyen çağrılar veya istekler 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 için ücret uygulanır.

Haritalar JavaScript API'nin Yer Otomatik Tamamlama Widget'ından gelen otomatik tamamlama istekleri, geçersiz bir Otomatik Tamamlama oturumundan gelen çağrılar olması halinde Otomatik Tamamlama - İstek Başına SKU için ücretlendirilebilir. 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 SES ALANI
(İSTEK başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
Her biri için 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ış 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ıları isteği içermeyen bir Otomatik tamamlama oturumu için ücretlendirilir (oturumun başlamasından birkaç dakika sonra).

AYLIK SES ALANI
(OTURUM başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
Her biri için 0,017 ABD doları
(1000 başına 17,00 ABD doları)		 Her biri için 0,0136 ABD doları
(1000 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ı 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ülediğinizde):

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

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

Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına SKU'su için aşağıdakilerden birini içeren Otomatik tamamlama oturumu için ücret alınır:

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

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

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

Yer Ayrıntıları isteğinde alanlar 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: Otomatik Tamamlama - Yer Ayrıntıları - Oturum Başına şeklinde faturalandırılır.

AYLIK SES ALANI
(OTURUM başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
0,00 ABD Doları 0,00 ABD Doları 0,00 ABD Doları

Örnek

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

Android

iOS

Web hizmeti

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

  • Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum başına (0,00 ABD doları olarak faturalandırılır)
  • Yer Ayrıntıları (fiyat, oturum başına 0,017 ABD dolarından başlayan fiyatlar)
  • Temel Veriler (0,00 ABD doları olarak faturalandırılır)

SKU: Yer Ayrıntıları

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

AYLIK SES MESAJI
(ARAMA başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
Her biri için 0,017 ABD doları
(1000 başına 17,00 ABD doları)		 Her biri için 0,0136 ABD doları
(1000 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 hizmetleri için Yer Ayrıntıları SKU'su, oturum jetonu sağlanıp sağlanmamasına bakılmaksızın ücretlendirilir.

Bir 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, İletişim ve/veya Atmosfer) oluşturur. Yer Ayrıntıları çağrısında veya isteğinde NO alanları belirtilirse TÜM Veri SKU'ları tetiklenir ve Yer Ayrıntıları çağrısı veya isteği için sizden 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: numarasını arayı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ülediğinizde):
    • Yer Ayrıntıları (fiyat, oturum başına 0,017 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları olarak faturalandırılır)
  2. Aşağıdaki aramalardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() veya iOS'ta fetchPlaceFromPlaceID: numarasını arayı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ülediğinizde):
    • Yer Ayrıntıları (fiyat, 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 istek türü budur): getPlaceDetails().
    Faturanızda, şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülediğinizde):
    • Yer Ayrıntıları (fiyat, oturum başına 0,017 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları olarak 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 Bulun, findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) çağrıları için ücretlendirilir.

AYLIK SES MESAJI
(ARAMA başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
Her biri için 0,030 ABD doları
(1000 başına 30,00 ABD doları)		 Her biri için 0,024 ABD doları
(1.000 başına 24,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

findCurrentPlace() (Android) veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) ç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ülediğinizde):
    • Mevcut Yeri Bulma (fiyat, istek başına 0,030 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları olarak faturalandırılır)
  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ülediğinizde):
    • Mevcut Yeri Bulma (fiyat, 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) çağırır ve üç veri türü paketinin her birinden alanlar belirtirsiniz. Faturanızda şu SKU'ları görürsünüz (faturanızı SKU'ya göre görüntülediğinizde):
    • Mevcut Yeri Bulma (fiyat, istek başına 0,030 ABD dolarından başlayan fiyatlar)
    • Temel Veriler (0,00 ABD doları olarak 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 için aşağıdakiler geçerlidir:

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

AYLIK SES MESAJI
(ARAMA başına fiyat)
0-100.000 100.001-500.000 500.000'den fazla
Her biri için 0,007 ABD doları
(1.000 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ış Ekibiyle İletişime Geçin

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

Android için Yerler SDK'sı kullanım maliyetinizi yönetmek veya üretim trafiğinizin taleplerini karşılamak için 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.

Android 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 Android için Yerler SDK'sını seçin.
  3. Kota sınırlarını görmek için İstekler kartına gidin.
    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 kutusundaki Kota Sınırı alanına, faturalandırılabilir günlük kota sınırını (varsa, 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 kredisi almak için Google Haritalar Platformu faturalandırma hesabı oluşturmadan önce bir Google Cloud Platform faturalandırma hesabı oluşturması gerekir. ↩