Places API Kullanımı ve Faturalandırması

Alan maskeleri hakkında

Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Text Search (Yeni) için API isteklerinde FieldMask başlığını kullanarak yanıtta döndürülecek alanların listesini belirtin. 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'ya göre faturalandırılırsınız.

Alan maskeleme kullanmak, gereksiz veri istememenizi sağlayan iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınabilirsiniz.

Otomatik tamamlama (yeni) oturumları hakkında

Bir Autocomplete (Yeni) oturumu, bir veya daha fazla Autocomplete (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.

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 yapılmazsa) Otomatik Tamamlama (Yeni) istekleri, oturum jetonu sağlanmamış gibi ücretlendirilir.

Bir kullanıcı bir yer seçtikten sonra (yani bir Yer Ayrıntıları (Yeni) isteği veya Adres Doğrulama 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 için 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: Autocomplete Requests Küresel fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Otomatik Tamamlama Oturumu Kullanımı Global fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Place Details Essentials (IDs Only) Küresel fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Place Details Essentials Küresel fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Text Search Essentials (IDs Only) Küresel fiyat listesi
Hindistan fiyat listesi
Pro SKU: Nearby Search Pro Küresel fiyat listesi
Hindistan fiyat listesi
Pro SKU: Place Details Pro Küresel fiyat listesi
Hindistan fiyat listesi
Pro SKU: Text Search Pro Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Nearby Search Enterprise Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Nearby Search Enterprise + Atmosphere Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Place Details Enterprise Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Place Details Enterprise + Atmosphere Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Text Search Enterprise Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Text Search Enterprise + Atmosphere Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Place Details Photos Küresel fiyat listesi
Hindistan fiyat listesi
KategoriPlaces API (Eski) SKU ayrıntılarıSKU fiyatlandırması
Essentials SKU: Autocomplete - Per Request Global fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Otomatik Tamamlama (Yer Ayrıntıları'na dahildir) - Oturum Başına Küresel fiyat listesi
Hindistan fiyat listesi
Essentials

SKU: Temel Veriler

Ek ücretler:

Küresel fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Find Place - ID only Global fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Place Details Essentials - ID Refresh Küresel fiyat listesi
Hindistan fiyat listesi
Essentials SKU: Sorgu Otomatik Tamamlama - İstek Başına Global fiyat listesi
Hindistan fiyat listesi
Pro SKU: Autocomplete without Place Details - Per Session Küresel fiyat listesi
Hindistan fiyat listesi
Pro

SKU: Yer Bulma

Ek ücretler:

Küresel fiyat listesi
Hindistan fiyat listesi
Pro

SKU: Places - Nearby Search

Ek ücretler:

Küresel 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: Atmosphere Data

Ek ücretler:

Küresel fiyat listesi
Hindistan fiyat listesi
Enterprise

SKU: Kişi Verileri

Ek ücretler:

Global fiyat listesi
Hindistan fiyat listesi
Enterprise SKU: Place Photos Küresel fiyat listesi
Hindistan fiyat listesi

Kullanım sınırları

Kotalarınızı ve kullanım sınırlarınızı inceleyip yönetmek için Kotalar ve kota uyarıları başlıklı makaleyi inceleyin.

  • Places API (Yeni): Dakika başına sıklık sınırlaması, 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 sıklık sınırlaması, aynı projenin yeterlilik belgelerini kullanan tüm uygulamalar için istemci taraflı ve sunucu tarafı isteklerin 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 kullanmak, 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ı (yeni) ile oturum fiyatlandırmasını kullanma

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ği gönderiyorsa Google, Autocomplete (New) 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 sunar.

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. Kotayı 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 İstek 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.