Sử dụng và thanh toán API Địa điểm

Lưu ý: Để sử dụng API Địa điểm, bạn phải bật tính năng thanh toán trên từng dự án và thêm khoá API hoặc mã thông báo OAuth vào tất cả các yêu cầu API hoặc SDK.

Giới thiệu về mặt nạ trường

Đối với thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng văn bản (Mới), hãy sử dụng tiêu đề FieldMask trong các yêu cầu API để chỉ định danh sách các trường cần trả về trong phản hồi. Sau đó, bạn sẽ được tính phí theo SKU cao nhất áp dụng cho yêu cầu của mình. Điều đó có nghĩa là nếu bạn chọn các trường trong cả SKU Essentials và SKU Pro, thì bạn sẽ được tính phí dựa trên SKU Pro.

Việc sử dụng tính năng che trường là một phương pháp thiết kế hiệu quả để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và các khoản phí thanh toán không cần thiết.

Giới thiệu về phiên Tự động hoàn thành (Mới)

Một phiên Tự động hoàn thành (Mới) bao gồm một hoặc nhiều yêu cầu Tự động hoàn thành (Mới) và một yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ. Mã thông báo phiên tương tự được chuyển đến yêu cầu Tự động hoàn thành (Mới) và đến yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ tiếp theo.

Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành (Mới) đầu tiên. Sau đó, yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ sẽ được thực hiện khi người dùng đã chọn một trong các đề xuất Tự động hoàn thành (Mới). Nếu một phiên bị bỏ dở, tức là không có yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ nào được thực hiện, thì các yêu cầu Tự động hoàn thành (Mới) sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp.

Sau khi người dùng chọn một địa điểm (nghĩa là yêu cầu Chi tiết địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ được thực hiện), bạn phải bắt đầu một phiên mới bằng mã thông báo phiên mới.

Lưu ý: Mã thông báo phiên có thể trùng lặp giữa các dự án, nhưng phải là duy nhất cho mỗi dự án. Ví dụ: một ứng dụng sử dụng Dự án A và một ứng dụng sử dụng Dự án B có thể sử dụng cùng một mã thông báo phiên, trong khi nhiều ứng dụng sử dụng Dự án A không thể sử dụng cùng một mã thông báo phiên.

Mã thông báo phiên chỉ có giá trị trong một phiên và không thể sử dụng cho nhiều phiên. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được coi là không hợp lệ và các yêu cầu sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp.

Thông tin chi tiết về SKU và giá của API Địa điểm

Bảng sau đây cho thấy thông tin chi tiết về SKU và giá của API Địa điểm.

Danh mục	Thông tin chi tiết về SKU trong API Địa điểm (Mới)	Giá SKU
Essentials	SKU: Yêu cầu tự động hoàn thành	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Lượt sử dụng tính năng tự động hoàn thành phiên	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Thông tin cơ bản về địa điểm (chỉ dành cho mã nhận dạng)	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Thông tin cơ bản về thông tin chi tiết về địa điểm	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Nguyên tắc cơ bản về Tìm kiếm bằng văn bản (chỉ dành cho giấy tờ tuỳ thân)	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Tìm kiếm lân cận Pro	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Place Details Pro	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Text Search Pro	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Nearby Search Enterprise	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Tìm kiếm địa điểm lân cận Enterprise Plus	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Thông tin chi tiết về địa điểm dành cho doanh nghiệp	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Thông tin chi tiết về địa điểm dành cho doanh nghiệp + Bầu không khí	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Text Search Enterprise	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Text Search Enterprise + Atmosphere	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Ảnh thông tin chi tiết về địa điểm	Danh sách giá chính Danh sách giá tại Ấn Độ
Danh mục	Chi tiết SKU của API Địa điểm (cũ)	Giá SKU
Essentials	SKU: Tự động hoàn thành – Theo mỗi yêu cầu	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Tính năng tự động hoàn thành (bao gồm cả Thông tin chi tiết về địa điểm) – Theo phiên	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Dữ liệu cơ bản	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Tìm địa điểm – chỉ có mã nhận dạng	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Thông tin cơ bản về địa điểm – Làm mới mã nhận dạng	Danh sách giá chính Danh sách giá tại Ấn Độ
Essentials	SKU: Tự động hoàn thành truy vấn – Theo mỗi yêu cầu	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Số phiên	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Tìm địa điểm	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Địa điểm – Tìm kiếm địa điểm lân cận	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Địa điểm – Tìm kiếm bằng văn bản	Danh sách giá chính Danh sách giá tại Ấn Độ
Pro	SKU: Place Details Pro	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Dữ liệu khí quyển	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Dữ liệu liên hệ	Danh sách giá chính Danh sách giá tại Ấn Độ
Doanh nghiệp	SKU: Ảnh địa điểm	Danh sách giá chính Danh sách giá tại Ấn Độ

Các hạn mức sử dụng khác

Để xem lại và quản lý hạn mức và giới hạn sử dụng, hãy xem bài viết Hạn mức và cảnh báo hạn mức.

• API Địa điểm (Mới): Giới hạn tốc độ mỗi phút là theo phương thức API trên mỗi dự án. Tức là mỗi phương thức API có một hạn mức riêng.

• API Địa điểm: Giới hạn tốc độ mỗi phút được tính bằng tổng số yêu cầu phía máy khách và phía máy chủ cho tất cả ứng dụng sử dụng thông tin xác thực của cùng một dự án.

Quy định hạn chế trong Điều khoản sử dụng

Để biết thông tin về điều khoản sử dụng, hãy xem chính sách đối với API Địa điểm và mục Hạn chế về giấy phép trong Điều khoản dịch vụ của Nền tảng Google Maps.

---