Tổng quan về API Quản lý bản đồ

API Quản lý Bản đồ là một API RESTful mà bạn có thể dùng để quản lý các tài nguyên định kiểu bản đồ dựa trên đám mây theo phương thức lập trình. Với API này, bạn có thể xác định giao diện trực quan của bản đồ, quản lý danh tính bản đồ và liên kết các kiểu cũng như tập dữ liệu tuỳ chỉnh với các biến thể bản đồ cụ thể mà không cần sử dụng bảng điều khiển Cloud.

API Quản lý Bản đồ được thiết kế cho những nhà phát triển muốn quản lý cấu hình bản đồ trên quy mô lớn hoặc tích hợp tính năng tạo kiểu bản đồ vào quy trình làm việc tự động và các công cụ nội bộ của riêng họ.

Các nguồn lực chính

  • StyleConfig: Chứa biểu thị JSON của một kiểu bản đồ. Chế độ này xác định màu sắc, khả năng hiển thị và mật độ của các đối tượng trên bản đồ.
  • MapConfig: Biểu thị một giá trị nhận dạng duy nhất của bản đồ (Mã bản đồ). Thành phần này đóng vai trò là vùng chứa cho các chế độ cài đặt kiểu và các tính năng như tăng cường POI hoặc làm phẳng toà nhà.
  • MapContextConfig: Liên kết một StyleConfig (và tuỳ ý một hoặc nhiều Tập dữ liệu) với MapVariants cụ thể trong MapConfig.

Kênh tạo phiên bản API

API Quản lý bản đồ sử dụng tính năng tạo phiên bản dựa trên kênh để cung cấp một lộ trình rõ ràng từ các tính năng thử nghiệm đến giai đoạn phát hành rộng rãi.

  • v2alpha (Thử nghiệm): Chứa các tính năng thử nghiệm mới nhất. Các tính năng trong kênh này có thể thay đổi mà không cần thông báo và bạn không nên dùng cho mục đích phát hành công khai.
  • v2beta (Bản xem trước): Chứa các tính năng ổn định và đang được chuẩn bị để phát hành rộng rãi. Kênh này phù hợp để áp dụng sớm và thử nghiệm trong môi trường tiền sản xuất.
  • v2 (Phát hành công khai): Chứa các tính năng được hỗ trợ đầy đủ và sẵn sàng phát hành công khai.

Hầu hết các tính năng của phiên bản 2 đều có ở cả điểm cuối v2alpha và v2beta trong các giai đoạn triển khai tương ứng. Đối với người dùng mới, Google đề xuất bắt đầu bằng điểm cuối v2beta.

Xác thực

Bạn chỉ có thể sử dụng OAuth 2.0 để xác thực bằng Map Management API (API Quản lý bản đồ). API này không hỗ trợ khoá API. Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth.

Các điểm hạn chế

  • Vai trò nhà phát triển: Để sử dụng API Quản lý bản đồ, bạn phải có các quyền IAM cần thiết để quản lý tài nguyên của Google Maps Platform trong dự án Google Cloud của mình.
  • Phạm vi tài nguyên: API này tập trung vào việc quản lý các tài nguyên Tạo kiểu bản đồ dựa trên đám mây. Các cấu hình khác của Nền tảng Google Maps vẫn có thể yêu cầu bảng điều khiển Cloud.

Chi phí

Bạn không phải trả phí khi sử dụng Map Management API. Các lệnh gọi API sẽ xuất hiện trên trang Thanh toán trong Cloud Console, nhưng các khoản phí sẽ là 0 USD. Tuy nhiên, các yêu cầu bị hạn chế như sau:

  • 3 QPS (số truy vấn mỗi giây)
  • 180 QPM (số lượng truy vấn mỗi phút) cho một dự án, được làm mới mỗi phút
  • 100.000 QPD (số lượt truy vấn mỗi ngày) cho một dự án, được làm mới mỗi ngày

Xem phần Mức sử dụng và phí.