Sử dụng mã thông báo phiên

Chọn nền tảng: Android iOS Dịch vụ web

Mã thông báo phiên nhóm các giai đoạn truy vấn và lựa chọn của một lượt tìm kiếm tự động hoàn thành của người dùng thành một phiên riêng biệt cho mục đích thanh toán.

Tạo mã thông báo phiên

Người dùng chịu trách nhiệm tạo mã thông báo phiên riêng biệt cho mỗi phiên. Bạn nên sử dụng UUID phiên bản 4.

Ví dụ

Khi người dùng nhập một cụm từ tìm kiếm, yêu cầu tự động hoàn thành sẽ được gọi sau mỗi vài lần nhấn phím (không phải theo từng ký tự) và danh sách các kết quả có thể có sẽ được trả về. Khi người dùng lựa chọn trong danh sách kết quả, lựa chọn đó sẽ được tính là một yêu cầu và tất cả yêu cầu được thực hiện trong quá trình tìm kiếm sẽ được gộp lại và tính là một yêu cầu duy nhất. Nếu người dùng chọn một địa điểm, thì cụm từ tìm kiếm sẽ được cung cấp miễn phí và chỉ yêu cầu về Dữ liệu địa điểm mới bị tính phí. Nếu người dùng không đưa ra lựa chọn trong vòng vài phút kể từ khi bắt đầu phiên, thì chỉ cụm từ tìm kiếm mới bị tính phí.

Hãy cùng xem xét luồng sự kiện này từ góc độ của một ứng dụng.

  1. Người dùng bắt đầu nhập cụm từ tìm kiếm để tìm "Paris, Pháp".
  2. Khi phát hiện hoạt động đầu vào của người dùng, ứng dụng sẽ tạo một mã thông báo phiên mới, "Mã thông báo A".
  3. Khi người dùng nhập, API sẽ đưa ra yêu cầu tự động hoàn thành sau mỗi vài ký tự, hiển thị danh sách kết quả tiềm năng mới cho mỗi ký tự:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. Khi người dùng đưa ra lựa chọn:
  • Tất cả yêu cầu từ cụm từ tìm kiếm đều được nhóm lại và thêm vào phiên được biểu thị bằng "Mã thông báo A", dưới dạng một yêu cầu duy nhất.
  • Lựa chọn của người dùng được tính là một yêu cầu Place Details và được thêm vào phiên hoạt động do "Mã thông báo A" đại diện.
  • Phiên kết thúc và ứng dụng sẽ loại bỏ "Mã thông báo A".

Để biết thêm thông tin về cách tính phí cho các yêu cầu của tính năng Tự động hoàn thành, hãy xem phần Sử dụng và thanh toán.