Otomatik Yer Tamamlama, bir 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 kullanıcı bir yer seçip Yer Ayrıntıları çağrısı yapıldığında sona erer. Her oturumda, birden fazla otomatik tamamlama sorgusu ve ardından bir yer seçimi yapılabilir. Bir oturumdaki her istek için kullanılan API anahtarları aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanızın her oturum için yeni bir jeton oluşturması gerekir. sessiontoken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).
Aşağıdaki yönergeleri ö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 Yer Otomatik Tamamlama ve Yer Ayrıntısı 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 aktardığınızdan emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.
Dilerseniz otomatik tamamlama oturum jetonunu bir istekten çıkarabilirsiniz. Oturum jetonu atlanırsa her istek ayrı olarak faturalandırılır ve Otomatik Tamamlama - İstek Başına SKU'sunu tetikler. Bir oturum jetonunu yeniden kullanırsanız oturum geçersiz kabul edilir ve istekler için hiçbir oturum jetonu sağlanmamış gibi ücret alınır.
Örnek
Kullanıcı bir sorgu yazarken, birkaç tuş vuruşunda bir (karakter başına değil) bir otomatik tamamlama isteği çağrılır ve olası sonuçların listesi döndürülür. Kullanıcı, sonuç listesinden seçim yaptığında, yapılan seçim bir istek olarak sayılır ve arama sırasında yapılan tüm istekler gruplanarak tek bir istek olarak sayılır. Kullanıcı bir yer seçerse arama sorgusu ücretsiz olarak kullanılabilir hale gelir 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 bir seçim yapmazsa yalnızca arama sorgusu ücretlendirilir.
Bu etkinlik akışını bir uygulama açısından inceleyelim.
- Bir kullanıcı "Paris, Fransa"yı aramak için bir sorgu yazmaya başlar.
- Kullanıcı girişini algıladıktan sonra uygulama, "A Jetonu" adlı yeni bir oturum jetonu oluşturur.
- Kullanıcı yazı yazarken API, her birkaç karakterde bir otomatik tamamlama isteği gönderir. İsteğin her biri için potansiyel sonuçların yeni bir listesi gösterilir:
"P"
"Par"
"Paris,"
"Paris, Fr"
- Kullanıcı bir seçim yaptığında:
- Sorgudan kaynaklanan tüm istekler gruplanır ve "A Jetonu" ile temsil edilen oturuma tek bir istek olarak eklenir.
- Kullanıcının seçimi bir Yer Ayrıntısı isteği olarak sayılır ve "A jetonu" ile temsil edilen oturuma eklenir.
- Oturum sona erer ve uygulama "A Jetonu"nu siler.
Otomatik Tamamlama isteklerinin nasıl faturalandırıldığı hakkında daha fazla bilgi için Kullanım ve Faturalandırma bölümüne bakın.
Oturum jetonları oluşturma
Oturum jetonu oluşturmak için AutocompleteSessionToken.newInstance() çağrısı yapın.