Tự động hoàn thành và giá theo phiên

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

Bạn nên sử dụng các phiên có tính năng Tự động hoàn thành (Mới). Phiên giúp đơn giản hoá việc định giá và cung cấp mô hình định giá nhất quán để sử dụng với tính năng Tự động hoàn thành (Mới).

Giá theo phiên bắt đầu bằng yêu cầu Tự động hoàn thành (Mới) đầu tiên có mã thông báo phiên, tiếp tục qua từng yêu cầu Tự động hoàn thành (Mới) tiếp theo, sau đó kết thúc bằng yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ sử dụng mã thông báo phiên.

Sau khi phiên kết thúc, mọi lệnh gọi đến tính năng Tự động hoàn thành (Mới), Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ sử dụng mã thông báo phiên đã hết hạn sẽ được tính phí như thể không có mã thông báo phiên.

Các phiên chưa hoàn tất (tức là các phiên không bị chấm dứt bằng yêu cầu về Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ) chỉ bị tính phí cho các yêu cầu tự động hoàn thành bằng SKU: Yêu cầu tự động hoàn thành.

Ba trường hợp đặt giá phổ biến nhất là:

  • Tự động hoàn thành cho dữ liệu vị trí
  • Tính năng tự động hoàn thành để khám phá địa điểm
  • Tự động điền thông tin thanh toán và giao hàng

Tự động hoàn thành cho dữ liệu vị trí

Trong trường hợp này, bạn muốn sử dụng tính năng Tự động hoàn thành và Chi tiết địa điểm (Mới) để lấy thông tin vị trí về một địa điểm. Ví dụ: bạn chọn một đề xuất từ tính năng tự động hoàn thành, sau đó sử dụng thẻ Thông tin chi tiết về địa điểm (Mới) để lấy toạ độ vĩ độ và kinh độ của địa điểm đó nhằm hiển thị địa điểm đó trên bản đồ.

Thông tin vị trí có thể bao gồm:

  • Địa chỉ
  • Vị trí dưới dạng toạ độ vĩ độ và kinh độ
  • Plus Code
  • Loại
  • Khung nhìn

Phiên này được chấm dứt bằng một yêu cầu duy nhất đến Place Details (New) (Thông tin chi tiết về địa điểm (Mới)) yêu cầu mọi trường do SKU: Place Details Essentials (Thông tin chi tiết về địa điểm cơ bản) xác định.

Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành (Mới) đầu tiên có chứa mã thông báo phiên, tiếp tục qua từng yêu cầu Tự động hoàn thành (Mới) tiếp theo, sau đó kết thúc bằng một yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ sử dụng mã thông báo phiên. Đối với phiên Tự động hoàn thành (Mới), bạn sẽ được tính phí như sau:

  • 12 yêu cầu Tự động hoàn thành (Mới) đầu tiên: Bạn sẽ được tính phí cho mỗi yêu cầu Tự động hoàn thành (Mới), tối đa là 12 yêu cầu, bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành.
  • Đối với các yêu cầu Tự động hoàn thành (Mới) từ 13 trở lên trong cùng một phiên: Bạn sẽ được tính phí theo SKU: Mức sử dụng phiên Tự động hoàn thành, tức là không tính phí cho các yêu cầu đó.
  • Yêu cầu Xác thực địa chỉ hoặc Chi tiết về địa điểm: Bạn cũng sẽ bị tính phí cho yêu cầu chấm dứt bằng các SKU đó.

Tính năng tự động hoàn thành để khám phá địa điểm

Trong trường hợp sử dụng tính năng Tự động hoàn thành để khám phá địa điểm, bạn không chỉ muốn nhận dữ liệu vị trí về một địa điểm. Ví dụ: bạn có thể yêu cầu bất kỳ nội dung nào sau đây:

  • Tuỳ chọn hỗ trợ tiếp cận
  • Giờ mở cửa hiện tại
  • Lựa chọn đỗ xe
  • Bài đánh giá
  • Điểm xếp hạng

Đối với trường hợp này, phiên của bạn sẽ bị chấm dứt bằng một yêu cầu đến phần Thông tin chi tiết về địa điểm (Mới) yêu cầu mọi trường có trong SKU Thông tin chi tiết về địa điểm (Mới) Pro, Enterprise hoặc Enterprise + Atmosphere.

Sau đó, bạn sẽ được tính phí như sau:

Tự động điền thông tin thanh toán và giao hàng

Address Validation API (API Xác thực địa chỉ) là một dịch vụ chấp nhận địa chỉ. Phương thức này xác định các thành phần địa chỉ và xác thực các thành phần đó. Hàm này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ và kinh độ chính xác nhất cho địa chỉ đó.

Trong trường hợp Tự động hoàn thành cho quy trình thanh toán và giao hàng, bạn sẽ chấm dứt phiên bằng một yêu cầu gửi đến Address Validation API (API Xác thực địa chỉ) để xác thực địa chỉ đã chọn. Sau đó, bạn sẽ được tính phí như sau:

Ví dụ về việc đặt giá

Bảng sau đây cho thấy ví dụ về giá cho 3 tình huống chính về phiên. Bảng này cũng liệt kê các SKU xuất hiện trong bảng sao kê thanh toán của bạn cho từng trường hợp.

Trường hợp Ví dụ về yêu cầu SKU đã tính phí Yêu cầu đã tính phí
Dữ liệu vị trí
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới) (giới hạn ở 12 yêu cầu cho phiên)
  • 1 yêu cầu về Thông tin chi tiết về địa điểm (Mới)
Khám phá địa điểm
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới)
  • 1 yêu cầu về Thông tin chi tiết về địa điểm (Mới)
Thanh toán và giao hàng
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới)
  • 1 yêu cầu xác thực địa chỉ
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới)
  • 1 yêu cầu gửi đến Address Validation Enterprise

Ví dụ về việc đặt giá không tính theo phiên

Nếu không sử dụng phiên, bạn sẽ được tính phí theo yêu cầu đối với tính năng Tự động hoàn thành (Mới) bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành.

Giá dự phòng cho các phiên không hoàn tất hoặc bị bỏ dở

Nếu một phiên bị bỏ ngang, nghĩa là không bị chấm dứt bằng lệnh gọi đến tính năng Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ, thì các yêu cầu Tự động hoàn thành (Mới) sẽ quay lại mô hình định giá theo yêu cầu và được tính phí theo SKU: Yêu cầu tự động hoàn thành.