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

Bạn có thể 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 xem trước).

Tóm tắt các thao tác

Để 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 hình thức 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, khả năng hiển thị và chế độ cài đặt 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 mã này 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ể (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 v2, hãy lưu ý đến 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 map_type thành VECTOR một cách rõ ràng trong MapConfig.
  • Biến thể bản đồ: Nếu không có map_variants nào được chỉ định 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ở của Google không có kiểu mặc định sẽ được sử dụng.

Cách dùng StyleConfig

StyleConfig chứa các định nghĩa tạo 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

Cách dùng MapConfig

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"
}'

Cách dùng MapContextConfig

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 đầy đủ hoặc dự án không 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 có định dạng không đúng hoặc chứa các giá trị trường không hợp lệ.