Hướng dẫn và ví dụ về API Quản lý bản đồ

Bạn có thể sử dụng API Quản lý bản đồ để quản lý theo phương thức lập trình các tài nguyên định kiểu bản đồ dựa trên đám mây trên cả điểm cuối v2alpha (Thử nghiệm) và v2beta (Bản dùng trước).

Tóm tắt hoạt động

Để trực quan hoá bản đồ tuỳ chỉnh bằng API Quản lý bản đồ, hãy làm theo các bước chính sau:

  1. Tạo StyleConfig: Xác định giao diện trực quan của bản đồ bằng cách sử dụng bản trình bày JSON về màu sắc, chế độ hiển thị và chế độ cài đặt mật độ.
  2. Tạo MapConfig: Thiết lập một Mã bản đồ riêng biệt đóng vai trò là vùng chứa cho danh tính và các tính năng cấp cao của bản đồ.
  3. Liên kết các tập dữ liệu đó với MapContextConfig: Liên kết StyleConfig (và các tập dữ liệu không bắt buộc) với các biến thể bản đồ cụ thể (như ROADMAP hoặc SATELLITE) trong MapConfig.

Hành vi mặc định

Khi sử dụng các điểm cuối phiên bản 2, hãy lưu ý các hành vi mặc định sau:

  • Loại bản đồ: Loại kết xuất bản đồ mặc định là RASTER. Để sử dụng bản đồ dựa trên vectơ, bạn phải đặt rõ ràng map_type thành VECTOR trong MapConfig.
  • Biến thể bản đồ: Nếu bạn không chỉ định map_variants nào khi tạo MapContextConfig, thì theo mặc định, cấu hình sẽ chỉ được áp dụng cho biến thể ROADMAP.
  • Kiểu cơ sở: Nếu json_style_sheet trống hoặc không được cung cấp trong StyleConfig, thì Bản đồ cơ sở mặc định chưa được tạo kiểu của Google sẽ được sử dụng.

Làm việc với StyleConfigs

StyleConfig chứa các định nghĩa về kiểu dựa trên JSON.

Tạo StyleConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

Liệt kê StyleConfig

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

Làm việc với MapConfigs

MapConfig xác định danh tính và loại kết xuất cốt lõi của bản đồ.

Tạo MapConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

Làm việc với MapContextConfigs

MapContextConfig liên kết kiểu với MapConfig.

Tạo MapContextConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

Lỗi

  • PERMISSION_DENIED: Yêu cầu thiếu quyền IAM cần thiết hoặc dự án chưa bật API.
  • NOT_FOUND: Tài nguyên được chỉ định (Dự án, MapConfig hoặc StyleConfig) không tồn tại.
  • INVALID_ARGUMENT: Nội dung yêu cầu không đúng định dạng hoặc chứa các giá trị trường không hợp lệ.