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ını kullanır. Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve 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 olabilir. 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 her oturum için yeni bir jeton oluşturmalıdır. sessiontoken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı ayrı faturalandırılır).
Aşağıdaki yönergeleri 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 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 gönderdiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğinin ayrı olarak faturalandırılmasına neden olur.
İsteğe bağlı olarak otomatik tamamlama oturum jetonunu isteklerden çıkarabilirsiniz. Oturum jetonu atlanırsa her istek ayrı olarak faturalandırılır ve Otomatik Tamamlama - İstek Başına SKU'su tetiklenir. Bir oturum jetonunu yeniden kullanırsanız oturum geçersiz kabul edilir ve istekler, oturum jetonu sağlanmamış gibi ücretlendirilir.
Örnek
Kullanıcı bir sorgu yazarken birkaç tuş vuruşunda bir otomatik tamamlama isteği çağrılır (karakter başına değil) 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 birleştirilerek tek bir istek olarak sayılır. Kullanıcı bir yer seçerse arama sorgusu ücretsizdir ve yalnızca yer verisi isteği ücretlendirilir. Kullanıcı, oturumun başlangıcından sonraki birkaç dakika içinde bir seçim yapmazsa yalnızca arama sorgusu için ödeme alınır.
Bu etkinlik akışını bir uygulamanın bakış açısından inceleyelim.
- Bir kullanıcı "Paris, Fransa" araması yapmak için bir sorgu yazmaya başlar.
- Uygulama, kullanıcı girişini algıladıktan sonra "A jetonu" adlı yeni bir oturum jetonu oluşturur.
- Kullanıcı yazarken API birkaç karakterde bir otomatik tamamlama isteği gönderir ve her biri için olası sonuçların yeni bir listesini gösterir:
"P"
"Par"
"Paris,"
"Paris, Fr"
- Kullanıcı bir seçim yaptığında:
- Sorgudan kaynaklanan tüm istekler gruplandırılı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 atar.
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
Tercih ettiğiniz programatik mekanizmayı kullanarak oturum jetonları oluşturabilirsiniz. Oturum jetonları için sürüm 4 UUID kullanmanızı öneririz.