Tính năng tự động hoàn thành (Mới) và giá theo phiên

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

Google khuyên 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 từ yêu cầu đầu tiên về tính năng Tự động hoàn thành (Mới) có mã thông báo phiên, tiếp tục qua từng yêu cầu tiếp theo về tính năng Tự động hoàn thành (Mới), sau đó kết thúc bằng một yêu cầu về tính năng 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 Autocomplete (New), Place Details (New) hoặc Address Validation sử dụng mã thông báo phiên đã hết hạn đều đượ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 kết thúc bằng yêu cầu về 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.

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

  • Tính năng 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 hoàn thành thông tin thanh toán và giao hàng

Tính nă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 về đị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ô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 sẽ kết thúc bằng một yêu cầu duy nhất đối với Place Details (New) để yêu cầu mọi trường do SKU: Place Details Essentials xác định.

Một phiên bắt đầu bằng yêu cầu đầu tiên về tính năng Tự động hoàn thành (Mới) có mã thông báo phiên, tiếp tục qua từng yêu cầu tiếp theo về tính năng Tự động hoàn thành (Mới), sau đó kết thúc bằng một yêu cầu về tính năng 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 một phiên sử dụng tính năng Tự động hoàn thành (Mới), bạn sẽ bị tính phí như sau:

  • 12 yêu cầu đầu tiên về tính năng Tự động hoàn thành (Mới): Bạn sẽ bị 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 Autocomplete (Mới) từ 13 trở lên trong cùng một phiên: Bạn sẽ bị tính phí theo SKU: Autocomplete Session Usage (Mức sử dụng tính năng tự động hoàn thành theo phiên), tức là bạn không phải trả phí cho những yêu cầu đó.
  • Yêu cầu Chi tiết về địa điểm hoặc Xác thực địa chỉ: Bạn cũng sẽ bị tính phí cho yêu cầu kết thúc bằng cách sử dụng những SKU đó.

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

Trong trường hợp Tự động hoàn thành để khám phá địa điểm, bạn muốn nhận được nhiều thông tin hơn ngoài dữ liệu vị trí về một địa điểm. Ví dụ: bạn có thể yêu cầu bất kỳ thông tin 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

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

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

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

Address Validation API là một dịch vụ chấp nhận địa chỉ. Thư viện này xác định các thành phần địa chỉ và xác thực chúng. API 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ẽ kết thúc phiên bằng một yêu cầu gửi đến Address Validation API để xác thực địa chỉ đã chọn. Sau đó, bạn sẽ bị tính phí như sau:

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

Bảng sau đây cho thấy các ví dụ về giá cho 3 trường hợp chính của 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 được tính phí Yêu cầu được 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)
  • 1 yêu cầu đến Place Details (New) bằng SKU: Place Details Essentials
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới) (tối đa 12 yêu cầu cho phiên)
  • 1 yêu cầu đến Place Details (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 đến Place Details (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 đến dịch vụ 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 đến Address Validation Enterprise

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

Nếu không sử dụng phiên, bạn sẽ bị tính phí cho mỗi yêu cầu đến 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 những phiên chưa hoàn tất hoặc bị bỏ dở

Nếu một phiên bị bỏ dở, tức là không kết thúc bằng lệnh gọi đến Place Details (New) hoặc Address Validation, thì các yêu cầu Autocomplete (New) sẽ quay trở lại mô hình định giá theo yêu cầu và được tính phí theo SKU: Autocomplete Requests.