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 hình thức trực quan của bản đồ, quản lý danh tính bản đồ và liên kết các kiểu tuỳ chỉnh cũng như tập dữ liệu với các biến thể bản đồ cụ thể – tất cả đều không cần 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 cho bản đồ vào các quy trình làm việc tự động và công cụ nội bộ của riêng họ.

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

  • StyleConfig: Chứa bản trình bày JSON của một kiểu bản đồ. Kiểu 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: Đại diện cho một danh tính bản đồ duy nhất (Mã bản đồ). Đây là một vùng chứa cho các tính năng và chế độ cài đặt tạo kiểu 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 các MapVariants cụ thể trong một MapConfig.

Các 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 trước và bạn không nên dùng cho mục đích phát hành chính thức.
  • v2beta (Bản xem trước): Chứa các tính năng ổn định và đang được chuẩn bị cho giai đoạn 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 phát hành chính thức.
  • v2 (Có sẵn trên diện rộng): Chứa các tính năng được hỗ trợ đầy đủ và sẵn sàng cho việc phát hành chính thức.

Hầu hết các tính năng v2 đều có sẵn trên 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 khuyên bạn nên bắt đầu với điểm cuối v2beta.

Xác thực

Bạn chỉ có thể sử dụng OAuth 2.0 để xác thực với 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 Google Maps Platform trong dự án Google Cloud.
  • 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 cho bản đồ dựa trên đám mây. Các cấu hình khác của Google Maps Platform 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 xuất hiện trên trang Thanh toán trong Bảng điều khiển Cloud, nhưng mức 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ố 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ố truy vấn mỗi ngày) cho một dự án, được làm mới mỗi ngày

Xem bài viết Mức sử dụng và thanh toán.