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ý giá trị nhận dạng bản đồ, cũng như liên kết các kiểu và 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 Cloud Console.

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 kiểu bản đồ vào 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 nội dung biểu thị kiểu bản đồ dưới dạng JSON. Thao tác này xác định màu sắc, chế độ hiển thị và mật độ của các đối tượng trên bản đồ.
  • MapConfig: Đại diện cho một giá trị nhận dạng bản đồ duy nhất (Mã bản đồ). Kiểu bản đồ đóng vai trò là vùng chứa cho các chế độ cài đặt và tính năng tạo kiểu như tăng cường địa điểm yêu thích 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 một 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à không được đề xuất 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ị để giai đoạn phát hành rộng rãi. Kênh này phù hợp cho việc sử dụng sớm và thử nghiệm trong môi trường trước khi phát hành công khai.
  • v2 (Giai đoạn phát hành rộng rãi): Chứa các tính năng được hỗ trợ đầy đủ và sẵn sàng cho môi trường thực tế.

Hầu hết các tính năng của phiên bản 2 đều có 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 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 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ò của 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 Nền tảng Google Maps 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 Định kiểu bản đồ dựa trên đám mây. Các cấu hình khác của Google Maps Platform có thể vẫn cần đến Cloud Console.

Chi phí

Bạn không phải trả phí khi sử dụng API quản lý bản đồ. Các lệnh gọi API xuất hiện trên trang Thanh toán trong Cloud Console, nhưng phí sẽ là 0 USD. Tuy nhiên, các yêu cầu bị ràng buộc 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 phần Mức sử dụng và thanh toán.