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à 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ẽ được tính phí theo SKU cao nhất áp dụng cho yêu cầu của bạn. Tức là nếu bạn chọn các trường trong cả SKU Essentials và Pro, thì bạn sẽ được tính phí dựa trên SKU Pro.

Sử dụng mặt nạ 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 Autocomplete (New)

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 Place Details (Mới) hoặc yêu cầu Xác thực địa chỉ. Cùng một mã phiên được truyền đến yêu cầu Tự động hoàn thành (Mới) và yêu cầu Place Details (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 Place Details (Mới) hoặc 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 nào về Place Details (Mới) hoặc Xác thực địa chỉ được thực hiện, thì các yêu cầu về Tự động hoàn thành (Mới) sẽ được 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 thể 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ẽ được 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á cho Places API

Bảng sau đây trình bày thông tin chi tiết về SKU và giá theo mức dùng của Places API.

Danh mụcThô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 Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Autocomplete Session Usage Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials (IDs Only) Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Text Search Essentials (IDs Only) Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro SKU: Nearby Search Pro Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro SKU: Place Details Pro Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro SKU: Text Search Pro Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Nearby Search Enterprise Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Nearby Search Enterprise + Atmosphere Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Place Details Enterprise Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Place Details Enterprise + Atmosphere Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Text Search Enterprise Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Text Search Enterprise + Atmosphere Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise Mã SKU: Ảnh trong thông tin chi tiết về địa điểm Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Danh mụcThông tin chi tiết về SKU của Places API (Phiên bản cũ)Giá SKU
Essentials SKU: Tự động hoàn thành – Theo mỗi yêu cầu Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Tự động hoàn thành (đi kèm với Place Details) – Mỗi phiên Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials

SKU: Basic Data

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Tìm địa điểm – Chỉ mã nhận dạng Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Place Details Essentials – Làm mới mã nhận dạng Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Essentials SKU: Tự động hoàn thành truy vấn – Theo mỗi yêu cầu Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro SKU: Autocomplete without Place Details – Mỗi phiên Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro

SKU: Find Place

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro

SKU: Địa điểm – Tìm kiếm lân cận

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro

SKU: Địa điểm – Tìm kiếm văn bản

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Pro

SKU: Chi tiết địa điểm

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise

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

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise

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

Phí bổ sung:

Bảng giá toàn cầu
Bảng giá tại Ấn Độ
Enterprise SKU: Ảnh địa điểm Bảng giá toàn cầu
Bảng giá tại Ấn Độ

Hạn mức sử dụng

Để xem 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 về hạn mức.

  • Places API (Mới): Giới hạn số lượng yêu cầu mỗi phút được áp dụng cho mỗi phương thức API trên mỗi dự án. Nói cách khác, 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 số lượng yêu cầu 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.

Chiến lược tiết kiệm chi phí cho Places API

Phần này cung cấp các cách để tối ưu hoá mức sử dụng và giảm chi phí liên quan đến Places API.

Sử dụng mặt nạ trường

Việc sử dụng tính năng che trường đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp giảm độ trễ và phí thanh toán.

Đối với các yêu cầu Place Details (Mới), Nearby Search (Mới) và Tìm kiếm văn bản (Mới), hãy sử dụng mặt nạ trường để 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 bạn. Ví dụ: nếu bạn chọn các trường trong cả SKU Essentials và Pro, thì bạn sẽ được tính phí dựa trên SKU Pro.

Sử dụng giá theo phiên với Place Details (Mới)

Nếu ứng dụng của bạn có số lượng lệnh gọi hằng tháng từ 100.001 đến 500.000 trở lên, hoặc nếu người dùng thực hiện hơn 12 yêu cầu tự động hoàn thành mỗi phiên, thì Google khuyên 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).

Để biết thêm thông tin, hãy xem bài viết Tính năng Tự động hoàn thành (Mới) và giá theo phiê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, hãy làm theo các bước sau:

  1. Trong Google Cloud Console, hãy chuyển đến Google Maps Platform > Quotas (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

Để 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ý, hãy làm theo các bước sau:

  1. Trong Google Cloud Console, hãy chuyển đến Google Maps Platform > Quotas (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 Yêu cầu tăng.

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

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