Yer Otomatik Tamamlama, kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla ayrı bir oturumda gruplandırmak için oturum jetonları kullanır. Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve bir yer seçtiğinde ve Yer Ayrıntıları arandığında sona erer. Her oturumda birden fazla otomatik tamamlama sorgusu ve ardından tek bir yer seçimi olabilir. Bir oturumdaki her istek için kullanılan API anahtarları aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessiontoken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturumdan hiçbir oturum jetonu sağlanmamış gibi ücret alınır (her istek ayrı olarak faturalandırılır).
Aşağıdaki kuralları uygulamanızı öneririz:
- Tüm otomatik tamamlama oturumları için oturum jetonları kullanın.
- Her oturum için yeni bir jeton oluşturun.
- Bir oturumdaki tüm Otomatik Yer Tamamlama ve Yer Ayrıntıları istekleri için kullanılan API anahtarlarının aynı Google Cloud Console projesine ait olduğundan emin olun.
- Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonu birden fazla oturumda kullanmak, her isteğin ayrı ayrı faturalandırılmasına neden olur.
İsterseniz bir istekteki otomatik tamamlama oturum jetonunu çıkarabilirsiniz. Oturum jetonu atlanırsa her istek ayrı faturalandırılır ve Otomatik Tamamlama - İstek Başına SKU'yu tetikler. Bir oturum jetonunu yeniden kullanırsanız, oturum geçersiz sayılır ve istekler, herhangi bir oturum jetonu sağlanmamış gibi ücretlendirilir.
Örnek
Kullanıcı bir sorgu yazdığında, her birkaç tuş vuruşunda (karakter başına değil) otomatik tamamlama isteği çağrılır ve olası sonuçların listesi döndürülür. Kullanıcı, sonuç listesinden bir seçim yaptığında bu seçim bir istek olarak sayılır ve arama sırasında yapılan tüm istekler gruplanıp tek bir istek olarak sayılır. Kullanıcı bir yer seçerse, arama sorgusu ücretsiz olarak kullanılabilir ve yalnızca Yer verileri isteği için ücret alınır. Kullanıcı, oturumun başlangıcından sonraki birkaç dakika içinde seçim yapmazsa yalnızca arama sorgusu ücretlendirilir.
Bu etkinlik akışını uygulamanın açısından inceleyelim.
- Bir kullanıcı "Paris, Fransa" için arama sorgusu yazmaya başlar.
- Kullanıcı girişi algılandığında, uygulama yeni bir oturum jetonu "Jeton A"" oluşturur.
- Kullanıcı türü arttıkça API her birkaç karakterde bir otomatik tamamlama isteğinde bulunur ve her sonuç için yeni bir sonuç listesi görüntüler:
- Kullanıcı bir seçim yaptığında:
- Sorgudan kaynaklanan tüm istekler, tek bir istek olarak gruplandırılır ve "Jeton A"sıyla temsil edilen oturuma eklenir.
- Kullanıcının seçimi Yer Ayrıntısı isteği olarak sayılır ve "Jeton A"" ile temsil edilen oturuma eklenir.
- Oturum sonlandırıldı ve uygulama "Token A"" ifadesini siliyor.
Otomatik Tamamlama isteklerinin nasıl faturalandırıldığı hakkında daha fazla bilgi edinmek için Kullanım ve Faturalandırma bölümüne bakın.
Oturum jetonu oluşturma
Oturum jetonu oluşturmak için GMSAutocompleteSessionToken.init() numaralı telefonu arayın.