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