Trang này được dịch bởi Cloud Translation API.

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

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

Đối với Place Details (Mới), Nearby Search (Mới) và Text Search (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ẽ bị tính phí ở SKU cao nhất áp dụng cho yêu cầu của bạn. Điều đó có nghĩa là nếu chọn các trường trong cả SKU Essentials và Pro, bạn sẽ bị tính phí dựa trên SKU Pro.

Sử dụng tính năng che phủ trường là một phương pháp thiết kế hay để đả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à 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 Autocomplete (Mới) bao gồm một hoặc nhiều yêu cầu Autocomplete (Mới) và một yêu cầu Place Details (Mới) hoặc Address Validation. Mã thông báo phiên tương tự được truyền đến yêu cầu Autocomplete (Mới) và đến yêu cầu Place Details (Mới) hoặc yêu cầu Address Validation tiếp theo.

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). Sau đó, một yêu cầu 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 của tính năng 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 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 về đị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.

Mã thông báo phiên chỉ dùng được cho một phiên và không dùng được 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ể bạn không cung cấp mã thông báo phiên.

Thông tin chi tiết về SKU và giá cho Places API

Bảng sau đây cho biết thông tin chi tiết về SKU và giá của Places API.

Danh mục	Thông tin chi tiết về SKU của Places API (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á ở Ấn Độ
Essentials	SKU: Autocomplete Session Usage	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Place Details Essentials (IDs Only)	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Nguyên tắc cơ bản về thông tin chi tiết về địa điểm	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Nguyên tắc cơ bản về tìm kiếm bằng văn bản (Chỉ mã nhận dạng)	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Nearby Search Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Place Details Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Text Search Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Nearby Search Enterprise	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Nearby Search Enterprise Plus	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Place Details Enterprise	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Place Details Enterprise + Atmosphere	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Text Search Enterprise	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Text Search Enterprise + Atmosphere	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Ảnh chi tiết về địa điểm	Danh sách giá chính Danh sách giá ở Ấn Độ
Danh mục	Thông tin về SKU Places API (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á ở Ấn Độ
Essentials	SKU: Tự động hoàn thành (có trong Thông tin chi tiết về địa điểm) – Mỗi phiên	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Dữ liệu cơ bản	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Find Place – ID only	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Place Details Essentials – ID Refresh	Danh sách giá chính Danh sách giá ở Ấ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á ở Ấn Độ
Pro	SKU: Autocomplete without Place Details - Per Session	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Find Place	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Places – Nearby Search	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Places – Text Search	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Place Details Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Dữ liệu về bầu khí quyển	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Dữ liệu liên hệ	Danh sách giá chính Danh sách giá ở Ấn Độ
Enterprise	SKU: Ảnh về địa điểm	Danh sách giá chính Danh sách giá ở Ấn Độ

Hạn mức sử dụng

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

Places API (Mới): Hạn mức yêu cầu mỗi phút là theo phương thức API cho mỗi dự án. Tức là mỗi phương thức API có một hạn mức riêng.
Places API (phiên bản cũ): Giới hạn về 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ả các ứng dụng sử dụng thông tin đăng nhập của cùng một dự án.

Điều chỉnh hạn mức

Hạn mức xác định số lượng yêu cầu tối đa được phép cho một API hoặc dịch vụ cụ thể trong một khung thời gian nhất định. Khi số lượng yêu cầu trong dự án của bạn đạt đến hạn mức, dịch vụ của bạn sẽ ngừng phản hồi các yêu cầu.

Để sửa đổi giá trị hạn mức cho API của bạn, hãy làm theo các bước sau:

Trong Bảng điều khiển đám mây, hãy chuyển đến Nền tảng Google Maps > Hạn mức.
Chọn API mà bạn muốn sửa đổi hạn mức.
Xác định giá trị hạn mức mà bạn muốn thay đổi, rồi chọn giá trị đó bằng hộp đánh dấu.
Nhấp vào Chỉnh sửa, nhập giá trị hạn mức mới rồi nhấp vào Gửi yêu cầu.

Xem yêu cầu tăng hạn mức

Cách xem tất cả yêu cầu tăng hạn mức, bao gồm cả yêu cầu trước đây và yêu cầu đang chờ xử lý:

Trong Bảng điều khiển đám mây, hãy chuyển đến Nền tảng Google Maps > Hạn mức.
Chọn API mà bạn muốn xem yêu cầu tăng hạn mức.
Nhấp vào Tăng số yêu cầu.

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

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