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ını 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, bir yer seçiminin ardından birden fazla otomatik tamamlama sorgusu bulunabilir. 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ı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ını kullanın.
- Her oturum için yeni bir jeton oluşturun.
- Bir oturumdaki tüm Yer Otomatik 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.
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 sayılır ve istekler için oturum jetonu sağlanmamış gibi ücret alınır.
Örnek
Kullanıcı bir sorguyu yazarken, her birkaç tuş vuruşunda bir (karakter başına değil) bir otomatik tamamlama isteği çağrılır ve olası sonuçların bir 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 gruplanarak 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şlamasından sonraki birkaç dakika içinde bir seçim yapmazsa yalnızca arama sorgusu için ücret alınır.
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şi algılandığında uygulama, "A Jetonu" adlı yeni bir oturum jetonu oluşturur.
- API, kullanıcı yazı yazarken her birkaç karakter için bir otomatik tamamlama isteği göndererek her biri için yeni bir potansiyel sonuç listesi gösterir:
"P"
"Par"
"Paris,"
"Paris, Cuma"
- 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 "Jeton A" 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
GMSAutocompleteSessionToken.init() çağrısı yapın.