Bạn nên sử dụng phiên với 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ột 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).
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 thông qua mỗi 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 đến Chi tiết đị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 đều sử dụng mã thông báo phiên đã hết hạn và sẽ được tính phí như thể không có mã thông báo phiên.
Những phiên chưa hoàn tất (tức là những phiên không kết thúc bằng yêu cầu Place Details (Mới) hoặc Xác thực địa chỉ) chỉ được tính phí cho các yêu cầu Tự động hoàn thành (Mới) bằng SKU: Yêu cầu tự động hoàn thành.
Thanh toán theo phiên
Phiên kết thúc bằng một yêu cầu về Place Details (Mới)
Đối với các phiên Autocomplete (Mới) kết thúc bằng một yêu cầu sử dụng các trường từ SKU: Places API Place Details Essentials:
- 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 về tính năng 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 về tính năng Tự động hoàn thành.
- Đối với yêu cầu Tự động hoàn thành (Mới) thứ 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, nghĩa là không tính phí cho các yêu cầu đó.
- Place Details (Mới) Essentials: Bạn cũng sẽ bị tính phí cho yêu cầu kết thúc tại SKU: Place Details Essentials trong Places API.
Phiên kết thúc bằng yêu cầu Xác thực địa chỉ hoặc Place Details (Mới) (không phải Essentials)
Đối với các phiên Autocomplete (Mới) kết thúc bằng một yêu cầu Xác thực địa chỉ hoặc một yêu cầu Chi tiết về địa điểm (Mới) bằng cách sử dụng các trường từ Chi tiết về địa điểm Pro, Enterprise hoặc Enterprise + Atmosphere:
- Yêu cầu về tính năng Tự động hoàn thành (Mới): Tất cả yêu cầu về tính năng Tự động hoàn thành (Mới) đều được tính phí theo SKU: Mức sử dụng phiên tự động hoàn thành, tức là bạn không phải trả phí cho những yêu cầu đó.
-
Yêu cầu về Place Details (Mới) hoặc Xác thực địa chỉ: Bạn cũng sẽ được tính phí cho yêu cầu kết thúc theo SKU thích hợp:
- Các yêu cầu chấm dứt Chi tiết địa điểm (Mới) được tính phí theo Mã SKU: Chi tiết địa điểm Enterprise + Atmosphere, bất kể các trường được yêu cầu.
- Các yêu cầu chấm dứt Xác thực địa chỉ được tính phí theo SKU: Xác thực địa chỉ cho doanh nghiệp.
Các trường hợp định giá theo phiên
Sau đây là 3 trường hợp phổ biến nhất về giá theo phiên:
- 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 khi thanh toán và giao hàng
Các phần sau đây mô tả các khoản phí thanh toán riêng lẻ cho từng trường hợp.
Tính năng tự động hoàn thành cho dữ liệu vị trí
Trong trường hợp Tự động hoàn thành cho dữ liệu vị trí, bạn muốn sử dụng tính năng Tự động hoàn thành (Mới) 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 (Mới), sau đó sử dụng tính năng Place Details (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) (Thông tin chi tiết về địa điểm (mới)) yêu cầu các trường do SKU: Place Details Essentials (SKU: Thông tin chi tiết cơ bản về địa điểm) xác định.
Sau đó, 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 sẽ được tính phí theo SKU: Yêu cầu tự động hoàn thành.
- Mọi yêu cầu còn lại về tính năng Tự động hoàn thành (Mới) đều được tính phí theo SKU: Mức sử dụng phiên tự động hoàn thành, 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 (Mới) kết thúc được tính phí theo SKU: Các thông tin cơ bản về Chi tiết về địa điểm trong Places API.
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
Đối với trường hợp này, phiên của bạn sẽ kết thúc bằng một yêu cầu duy nhất đến Chi tiết địa điểm (Mới) yêu cầu bất kỳ trường nào có trong SKU Pro, Enterprise hoặc Enterprise + Atmosphere của Chi tiết địa điểm (Mới).
Sau đó, bạn sẽ được tính phí như sau:
- Tất cả các yêu cầu Tự động hoàn thành (Mới) đều được tính phí theo SKU: Mức sử dụng phiên tự động hoàn thành, tức là bạn không phải trả phí cho những yêu cầu đó.
- Yêu cầu Place Details (Mới) kết thúc được tính phí theo SKU: Places API Place Details Enterprise + Atmosphere.
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 độ phù hợp 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ẽ được tính phí như sau:
- Tất cả yêu cầu Tự động hoàn thành (Mới) đều được tính phí theo SKU: Mức sử dụng phiên tự động hoàn thành, nghĩa là không tính phí cho các yêu cầu đó.
- Yêu cầu Place Details Essentials (không bắt buộc) sẽ không bị tính phí nếu được yêu cầu trước yêu cầu Xác thực địa chỉ kết thúc.
- Yêu cầu Xác thực địa chỉ kết thúc được tính phí theo SKU: Xác thực địa chỉ cho doanh nghiệp.
Giá không có 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.
Định giá cho các 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 (Mới) hoặc Address Validation, thì các yêu cầu Autocomplete (Mới) sẽ quay về mô hình định giá theo yêu cầu và được tính phí theo SKU: Autocomplete Requests.