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 kullandıkça öde SKU ayrıntıları ve fiyatlandırması gösterilmektedir.

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

SKU: Temel Veriler

Ek ücretler:

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

SKU: Yer Bulma

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Pro

SKU: Yerler - Yakında Arama

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Pro

SKU: Places - Text Search

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Pro

SKU: Yer Ayrıntıları

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Enterprise

SKU: Atmosfer Verileri

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Enterprise

SKU: Kişi Verileri

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Yer Fotoğrafları Global fiyat listesi
Hindistan fiyat 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. Diğer bir deyişle, 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.

Places API için uygun maliyetli stratejiler

Bu bölümde, kullanımınızı optimize etmenin ve Places API ile ilişkili maliyetleri düşürmenin yolları açıklanmaktadır.

Alan maskelerini kullanma

Alan maskeleme, gereksiz veri istememenizi sağlar. Bu da gecikmeyi ve faturalandırma ücretlerini azaltmaya yardımcı olur.

Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) isteklerinde, yanıtta döndürülecek alanların listesini belirtmek için alan maskesi kullanın.

Ardından, isteğiniz için geçerli olan en yüksek SKU üzerinden faturalandırılırsınız. Örneğin, hem Essentials hem de Pro SKU'larından alan seçerseniz Pro SKU'ya göre faturalandırılırsınız.

Yer Ayrıntıları ile oturum fiyatlandırmasını kullanma (Yeni)

Uygulamalarınızın aylık çağrı hacmi 100.001-500.000 veya daha fazlaysa ya da kullanıcılar oturum başına 12'den fazla otomatik tamamlama isteğinde bulunuyorsa Google, Otomatik Tamamlama (Yeni) ile oturumları kullanmanızı önerir. Oturumlar, fiyatlandırmayı basitleştirmeye yardımcı olur ve Otomatik Tamamlama (Yeni) ile kullanım için tutarlı bir fiyatlandırma modeli sağlar.

Daha fazla bilgi için Otomatik tamamlama (yeni) ve oturum fiyatlandırması başlıklı makaleyi inceleyin.

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.