Oturum jetonları kullanın

Platform seçin: Android iOS Web Hizmeti

Oturum jetonları, kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla ayrı bir oturumda gruplandırır.

Oturum jetonu oluşturma

Kullanıcılar, her oturum için benzersiz oturum jetonları oluşturmaktan sorumludur. Google, sürüm 4 UUID'lerinin kullanılmasını önerir.

Örnek

Kullanıcı sorgu yazarken birkaç tuş vuruşunda bir (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 seçim yaptığında bu seçim istek olarak sayılır ve arama sırasında yapılan tüm istekler tek bir istek olarak paketlenip sayılır. Kullanıcı bir yer seçerse arama sorgusu ücretsiz olarak kullanılabilir ve yalnızca yer verileri isteği için ödeme alınır. Kullanıcı, oturumun başlamasından sonraki birkaç dakika içinde seçim yapmazsa yalnızca arama sorgusu için ödeme alınır.

Bu etkinlik akışını bir uygulama açısından inceleyelim.

  1. Bir kullanıcı, "Paris, Fransa"yı aramak için sorgu yazmaya başlıyor.
  2. Uygulama, kullanıcı girişini algıladığında yeni bir oturum jetonu ("A Jetonu") oluşturur.
  3. Kullanıcı yazarken API, birkaç karakterde bir otomatik tamamlama isteğinde bulunur ve her biri için olası sonuçların yeni bir listesini gösterir:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. Kullanıcı 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, 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 başlıklı makaleyi inceleyin.