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

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

Đối với API Place Details (Mới), Nearby Search (Mới) và Tìm kiếm 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ẽ bị tính phí theo SKU cao nhất áp dụng cho yêu cầu của bạn. Điều đó có nghĩa là nếu bạn chọn các trường trong cả SKU Essentials và Pro, thì 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ề các 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 Xác thực địa chỉ. Mã phiên tương tự được truyền đến yêu cầu Autocomplete (Mới) và đến yêu cầu Place Details (New) 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 đầu tiên về tính năng Tự động hoàn thành (Mới). Sau đó, một yêu cầu Place Details (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 Place Details (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ã 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 Place Details (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 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ụcThông tin chi tiết về SKU của Places API (Mới)Giá theo SKU
Essentials SKU: Yêu cầu tự động hoàn thành Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Autocomplete Session Usage Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials (Chỉ có mã nhận dạng) Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Nguyên tắc cơ bản của Tìm kiếm văn bản (Chỉ mã nhận dạng) Bảng giá chính
Bảng giá tại Ấn Độ
Pro SKU: Nearby Search Pro Bảng giá chính
Bảng giá tại Ấn Độ
Pro SKU: Place Details Pro Bảng giá chính
Bảng giá tại Ấn Độ
Pro SKU: Text Search Pro Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Nearby Search Enterprise Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Nearby Search Enterprise + Atmosphere Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Place Details Enterprise Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Place Details Enterprise + Atmosphere Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Text Search Enterprise Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Text Search Enterprise + Atmosphere Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Ảnh Place Details Bảng giá chính
Bảng giá tại Ấn Độ
Danh mụcThông tin chi tiết về SKU Places API (Cũ)Giá theo SKU
Essentials SKU: Autocomplete – Per Request Bảng giá chính
Bảng giá tại Ấ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 Bảng giá chính
Bảng giá tại Ấn Độ
Essentials

SKU: Dữ liệu cơ bản

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Tìm địa điểm – ID only Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials - ID Refresh Bảng giá chính
Bảng giá tại Ấn Độ
Essentials SKU: Tự động hoàn thành truy vấn – Theo yêu cầu Bảng giá chính
Bảng giá tại Ấn Độ
Pro SKU: Autocomplete without Place Details - Per Session Bảng giá chính
Bảng giá tại Ấn Độ
Pro

SKU: Find Place

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Pro

SKU: Places – Nearby Search

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Pro

SKU: Places – Tìm kiếm văn bản

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Pro

SKU: Places Details

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp

SKU: Dữ liệu khí quyển

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp

SKU: Dữ liệu liên hệ

Phí bổ sung:

Bảng giá chính
Bảng giá tại Ấn Độ
Doanh nghiệp SKU: Ảnh về địa điểm Bảng giá chính
Bảng giá tại Ấ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à cho mỗi 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ũ): Hạn mức tỷ lệ 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:

  1. Trong Cloud Console, hãy chuyển đến Google Maps Platform > Hạn mức.
  2. Chọn API mà bạn muốn sửa đổi hạn mức.
  3. 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.
  4. 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 các 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ý:

  1. Trong Cloud Console, hãy chuyển đến Google Maps Platform > Hạn mức.
  2. Chọn API mà bạn muốn xem yêu cầu tăng hạn mức.
  3. 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 APImục Giới hạn về giấy phép trong Điều khoản dịch vụ của Google Maps Platform.