Hoạt động sử dụng và thanh toán API Maps JavaScript

Lưu ý: Để sử dụng Maps JavaScript API, bạn phải bật tính năng thanh toán cho 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.

Nhấp vào biểu tượng thông tin thông tin để xem mục lục của trang này.

Các yêu cầu Maps JavaScript API tạo ra các lệnh gọi đến nhiều SKU tuỳ thuộc vào loại yêu cầu: ví dụ: lượt tải bản đồ sẽ kích hoạt SKU Bản đồ động và ảnh toàn cảnh sẽ kích hoạt SKU Chế độ xem đường phố linh động. Các lệnh gọi đến Thư viện địa điểm, Maps JavaScript API và các dịch vụ JavaScript khác được tính giá riêng. Để biết thêm thông tin, hãy xem danh sách giá và thông tin chi tiết về SKU trong bảng sau.

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

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

Danh mục	Thông tin chi tiết về SKU của Maps	Giá theo SKU
Essentials	SKU: Bản đồ động	Bảng giá chính Bảng giá tại Ấn Độ
Essentials	SKU: Chế độ xem đường phố tĩnh	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Chế độ xem đường phố động	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Elevation	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Bản đồ trực quan	Bảng giá chính Bảng giá tại Ấn Độ
Danh mục	Thông tin chi tiết về SKU của Places Library, Maps JavaScript 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: Mã hoá địa lý	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: 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ục	Thông tin chi tiết về SKU Places Library, Maps JavaScript API (Cũ)	Giá theo SKU
Essentials	SKU: Tự động hoàn thành – Theo mỗi yêu cầu	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: SKU: Places Details SKU: Find Place SKU: Places – Nearby Search SKU: Places – Tìm kiếm văn bản	Bảng giá chính Bảng giá tại Ấn Độ
Essentials	SKU: Find Place – ID only (SKU: Tìm địa điểm – Chỉ mã nhận dạng)	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 mỗi 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: SKU: Dữ liệu cơ bản SKU: Dữ liệu liên hệ SKU: Dữ liệu khí quyển	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Places – Nearby Search Phí bổ sung: SKU: Dữ liệu cơ bản SKU: Dữ liệu liên hệ SKU: Dữ liệu khí quyển	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: SKU: Dữ liệu cơ bản SKU: Dữ liệu liên hệ SKU: Dữ liệu khí quyển	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Places Details Phí bổ sung: SKU: Dữ liệu cơ bản SKU: Dữ liệu liên hệ SKU: Dữ liệu khí quyển	Bảng giá chính Bảng giá tại Ấn Độ
Doanh nghiệp	SKU: Dữ liệu khí quyển Phí bổ sung: SKU: Places Details SKU: Find Place SKU: Places – Nearby Search SKU: Places – Tìm kiếm văn bản	Bảng giá chính Bảng giá tại Ấn Độ
Doanh nghiệp	SKU: Dữ liệu liên hệ Phí bổ sung: SKU: Places Details SKU: Find Place SKU: Places – Nearby Search SKU: Places – Tìm kiếm văn bản	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 Độ
Danh mục	Places UI Kit	Giá theo SKU
Essentials	SKU: Places UI Kit Query	Bảng giá chính Bảng giá tại Ấn Độ
Essentials	SKU: Places UI Kit – Autocomplete Per Session	Danh sách giá chính Danh sách giá ở Ấn Độ
Danh mục	Thông tin chi tiết về SKU của thư viện tuyến đường	Giá theo SKU
Essentials	SKU: Routes: Compute Routes Essentials	Danh sách giá chính Danh sách giá ở Ấn Độ
Essentials	SKU: Routes: Compute Route Matrix Essentials	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Tuyến đường: Compute Routes Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Pro	SKU: Routes: Compute Route Matrix Pro	Danh sách giá chính Danh sách giá ở Ấn Độ
Doanh nghiệp	SKU: Routes: Compute Routes Enterprise	Danh sách giá chính Danh sách giá ở Ấn Độ
Doanh nghiệp	SKU: Routes: Compute Route Matrix Enterprise	Danh sách giá chính Danh sách giá ở Ấn Độ
Danh mục	Thông tin chi tiết về SKU Routes API (Cũ)	Giá theo SKU
Essentials	SKU: Directions	Bảng giá chính Bảng giá tại Ấn Độ
Essentials	SKU: Ma trận khoảng cách	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Directions Advanced	Bảng giá chính Bảng giá tại Ấn Độ
Pro	SKU: Distance Matrix Advanced	Bảng giá chính Bảng giá tại Ấn Độ

Thông tin về giá của thư viện tuyến đường

Mỗi lớp Route và RouteMatrix đều có 3 SKU xác định chi phí của một yêu cầu. SKU được dùng để xác định chi phí dựa trên dịch vụ bạn sử dụng, lớp Route hoặc lớp RouteMatrix, cũng như các tính năng mà bạn sử dụng trong yêu cầu. Ví dụ:

• Các yêu cầu Tính toán tuyến đường được tính phí cho mỗi Yêu cầu.

• Yêu cầu Tính toán ma trận tuyến đường được tính phí theo PHẦN TỬ được trả về từ yêu cầu. Số lượng phần tử là số lượng điểm xuất phát nhân với số lượng điểm đến. Ví dụ: nếu một yêu cầu chứa hai điểm xuất phát và ba điểm đến, thì yêu cầu đó sẽ được tính phí cho sáu phần tử.

Các tính năng bạn sử dụng sẽ xác định danh mục SKU được tính phí:

• Essentials: Tính phí cho các yêu cầu chỉ sử dụng các tính năng cơ bản với tối đa 10 điểm tham chiếu trung gian.

• Pro: Tính phí cho các yêu cầu sử dụng một tính năng nâng cao, chẳng hạn như công cụ sửa đổi tuyến đường TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL.

• Doanh nghiệp: Tính phí cho các yêu cầu sử dụng một tính năng dành cho doanh nghiệp, chẳng hạn như tính năng chỉ đường cho xe hai bánh.

JavaScript có các giới hạn sử dụng sau đây.

Tính toán tuyến đường

• Hạn mức tốc độ là 3.000 truy vấn mỗi phút.

• Số lượng tối đa các điểm tham chiếu trung gian được phép cho mỗi yêu cầu computeRoutes là 25.

Tính toán ma trận tuyến đường

• Hạn mức tốc độ là 3.000 phần tử mỗi phút, được tính bằng số lượng nguồn nhân với số lượng đích đến.

• Số lượng điểm xuất phát và điểm đến tối đa mà bạn có thể chỉ định bằng cách sử dụng mã địa điểm hoặc địa chỉ là 50.

• Tổng số phần tử tối đa được phép cho mỗi yêu cầu computeRouteMatrix có routingPreference được đặt thành TRAFFIC_AWARE_OPTIMAL là 100.

• Tổng số phần tử tối đa được phép cho mỗi yêu cầu computeRouteMatrix khi travelMode được đặt thành TRANSIT là 100.

• Tổng số phần tử tối đa được phép cho mỗi yêu cầu computeRouteMatrix là 625.

Hạn mức và giới hạn sử dụng

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

Hạn mức lượt tải bản đồ

Các hạn mức sau đây áp dụng cho lượt tải bản đồ 2D và 3D của Maps JavaScript API:

• 30.000 lần tải bản đồ mỗi phút cho mỗi dự án
• 300 lần tải bản đồ mỗi phút cho mỗi địa chỉ IP

Hạn mức sử dụng Places UI Kit

Places UI Kit phải tuân theo các hạn mức sử dụng sau:

• Truy vấn Places UI Kit: Các yêu cầu từ các phần tử Place Details và Tìm kiếm địa điểm bị giới hạn ở 6.000 truy vấn mỗi phút cho mỗi dự án.

• Phiên Places UI Kit: Các yêu cầu từ phần tử Tự động hoàn thành bị giới hạn ở 6.000 truy vấn mỗi phút cho mỗi dự án.

Các yêu cầu cơ bản đối với Places API và Geocoding API không tiêu thụ hạn mức trong dự án trên đám mây của bạ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ạ cho trường

Việc sử dụng tính năng che phủ 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 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ẽ bị tính phí theo SKU cao nhất áp dụng cho yêu cầu của bạn. Ví dụ: nếu 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 giá theo phiên với phần Thông tin chi tiết về địa điểm (Mới)

Nếu các ứ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 hoặc nhiều hơ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 nên sử dụng các phiên có 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 phần 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.

Lưu ý quan trọng: Để biết việc tăng hạn mức có thể ảnh hưởng như thế nào đến hoá đơn của bạn, hãy xem máy tính định giá.

Để 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

Lưu ý quan trọng: Bạn phải có quyền IAM thích hợp để 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.

Lưu ý: Hãy nhớ thường xuyên theo dõi mức sử dụng hạn mức để tránh bị gián đoạn dịch vụ. Tìm hiểu thêm về hạn mức và cảnh báo hạn mức.

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

Để biết thông tin đầy đủ về việc sử dụng được phép, hãy tham khảo 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.

---