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 (Xem 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 một bản trình bày JSON về các chế độ cài đặt màu sắc, khả năng hiển thị và mật độ.
  2. Tạo MapConfig: Thiết lập một mã bản đồ duy nhấ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 đối tượng này với một 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ể (chẳng hạn 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 ý những 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 map_type thành VECTOR một cách rõ ràng trong MapConfig.
  • Biến thể bản đồ: Nếu bạn không chỉ định map_variants khi tạo MapContextConfig, thì cấu hình sẽ chỉ được áp dụng cho biến thể ROADMAP theo mặc định.
  • Tạo kiểu cơ bản: 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 của Google sẽ được 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ê StyleConfigs

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 không có đủ quyền IAM hoặc dự án chưa bật API.
  • NOT_FOUND: Tài nguyên được chỉ định (Project, 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ệ.