Places API Kullanımı ve Faturalandırması

Alan maskeleri hakkında

Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) için, yanıtta döndürülecek alanların listesini belirtmek üzere API isteklerinde FieldMask başlığını kullanın. Ardından, isteğiniz için geçerli olan en yüksek SKU üzerinden faturalandırılırsınız. Yani hem Essentials hem de Pro SKU'larında alan seçerseniz Pro SKU'suna göre faturalandırılırsınız.

Gereksiz veri istemediğinizden emin olmak için alan maskeleme kullanmak iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresi ve faturalandırma ücretlerinden kaçınabilirsiniz.

Otomatik tamamlama (yeni) oturumları hakkında

Otomatik Tamamlama (Yeni) oturumu, bir veya daha fazla Otomatik Tamamlama (Yeni) isteği ve bir Yer Ayrıntıları (Yeni) isteği ya da Address Validation isteği içerir. Aynı oturum jetonu, Otomatik Tamamlama (Yeni) isteğine ve sonraki Yer Ayrıntıları (Yeni) isteğine veya Adres Doğrulama isteğine iletilir.

Bir oturum, ilk Otomatik Tamamlama (Yeni) isteğiyle başlar. Kullanıcı, Otomatik Tamamlama (Yeni) önerilerinden birini seçtiğinde Yer Ayrıntıları (Yeni) isteği veya Address Validation isteği gönderilir. Bir oturum terk edilirse (yani Yer Ayrıntıları (Yeni) isteği veya Address Validation isteği gönderilmezse) Otomatik Tamamlama (Yeni) istekleri, oturum jetonu sağlanmamış gibi ücretlendirilir.

Bir kullanıcı yer seçtikten sonra (yani Yer Ayrıntıları (Yeni) isteği veya Address Validation isteği yapıldıktan sonra) yeni bir oturum jetonu kullanarak yeni bir oturum başlatmanız gerekir.

Oturum jetonu tek bir oturum için geçerlidir ve birden fazla oturumda kullanılamaz. Oturum jetonunu yeniden kullanırsanız oturum geçersiz sayılır ve istekler, oturum jetonu sağlanmamış gibi ücretlendirilir.

Places API için SKU ayrıntıları ve fiyatlandırma

Aşağıdaki tabloda Places API'nin SKU ayrıntıları ve fiyatlandırması gösterilmektedir.

KategoriPlaces API (Yeni) SKU ayrıntılarıSKU Fiyatlandırması
Essentials SKU: Otomatik Tamamlama İstekleri Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials STB: Otomatik Tamamlama Oturumu Kullanımı Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Place Details Essentials (IDs Only) Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Yer Ayrıntıları ile İlgili Temel Bilgiler Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Text Search Essentials (IDs Only) Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro SKU: Nearby Search Pro Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro SKU: Place Details Pro Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro SKU: Text Search Pro Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Nearby Search Enterprise Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Nearby Search Enterprise + Atmosphere Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Place Details Enterprise Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Place Details Enterprise + Atmosphere Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Text Search Enterprise Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Text Search Enterprise + Atmosphere Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Yer Ayrıntıları Fotoğrafları Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
KategoriPlaces API (Eski) SKU ayrıntılarıSKU Fiyatlandırması
Essentials SKU: Otomatik Tamamlama - İstek Başına Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials

SKU: Temel Veriler

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Yer Bulma - Yalnızca Kimlik Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Yer Ayrıntıları ile İlgili Temel Bilgiler - Kimlik Yenileme Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Essentials SKU: Otomatik Sorgu Tamamlama - İstek Başına Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro SKU: Otomatik Tamamlama (Yer Ayrıntıları hariç) - Oturum Başına Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro

SKU: Yer Bulma

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro

SKU: Yerler - Yakında Arama

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro

SKU: Places - Text Search

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Pro

SKU: Yer Ayrıntıları

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise

SKU: Atmosfer Verileri

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise

SKU: Kişi Verileri

Ek ücretler:

Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi
Enterprise SKU: Yer Fotoğrafları Ana fiyatlandırma listesi
Hindistan fiyatlandırma listesi

Kullanım sınırları

Kotalarınızı ve kullanım sınırlarınızı incelemek ve yönetmek için Kotalar ve kota uyarıları bölümüne bakın.

  • Places API (Yeni): Dakika başına hız sınırı, proje başına API yöntemi başına uygulanır. Yani her API yönteminin ayrı bir kotası vardır.

  • Places API (Eski): Dakika başına hız sınırı, aynı projenin kimlik bilgilerini kullanan tüm uygulamalar için istemci tarafı ve sunucu tarafı isteklerinin toplamı olarak hesaplanır.

Kotayı ayarlama

Kota sınırları, belirli bir zaman aralığında belirli bir API veya hizmet için izin verilen maksimum istek sayısını tanımlar. Projenizdeki istek sayısı kota sınırına ulaştığında hizmetiniz isteklere yanıt vermeyi durdurur.

API'nizin kota değerini değiştirmek için aşağıdaki adımları uygulayın:

  1. Cloud Console'da Google Haritalar Platformu > Kotalar'a gidin.
  2. Kotasını değiştirmek istediğiniz API'yi seçin.
  3. Değiştirmek istediğiniz kota değerini belirleyin ve onay kutusunu kullanarak seçin.
  4. Düzenle'yi tıklayın, yeni bir kota değeri girin ve İsteği gönder'i tıklayın.

Kota artışı isteklerini görüntüleme

Geçmiş ve bekleyen istekler de dahil olmak üzere tüm kota artışı isteklerini görüntülemek için:

  1. Cloud Console'da Google Haritalar Platformu > Kotalar'a gidin.
  2. Kota artışı isteğini görüntülemek istediğiniz API'yi seçin.
  3. İstekleri Artır'ı tıklayın.

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

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