Nhảy tới nội dung

Static Maps APIs

Tạo các hình ảnh bản đồ tĩnh với đa dạng tùy chỉnh về đường, lớp bản đồ, icon đánh dấu điểm trên bản đồ.

Base URL​

API Static Maps cho phép ứng dụng của bạn hiển thị các hình ảnh bản đồ tĩnh với các tùy chỉnh về kiểu đánh dấu điểm, đường và lớp bản đồ. Bạn có thể tự do tùy chỉnh kiểu bản đồ, thêm đa dạng các kiểu chấm điểm, vẽ đường giữa các tọa độ và thêm các lớp hình ảnh trên bản đồ.

Nếu bạn không cần một bản đồ tương tác, chỉ cần nhúng bản đồ tĩnh của Openmap.vn vào ứng dụng, báo cáo hoặc trang web của bạn. Ngoài ra, chúng tôi còn cung cấp khả năng tinh chỉnh hình ảnh bản đồ như mức phóng to, kích cỡ và kiểu bản đồ để phù hợp hơn với nhu cầu của bạn.

mẹo

Hãy sử dụng Enterprise Dashboard hoặc hướng dẫn API Key để tạo API Key và trải nghiệm miễn phí!

Base URL​

Mã URL chung cho tất các yêu cầu API: https://mapapis.openmap.vn/v1

Endpoint​

  • Center based:
    /styles/{style-id}/static/{lon},{lat},{zoom}[@{bearing}[,{pitch}]]/{width}x{height}[@2x].{format}
  • Area based:
    /styles/{style-id}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}[@2x].{format}
  • Auto fit path:
    /styles/{style-id}/static/auto/{width}x{height}[@2x].{format}

Ví dụ​

/styles/day-v1/static/105.78792,21.03284,20/[email protected]?marker=105.78792,21.03284|https://openmap.vn/statics/images/map/pin_map_dot.svg

Parameters​

  • Tất cả endpoints của hình ảnh bản đồ tĩnh có thể hỗ trờ các tham số truy vấn sau đây:

    • path - ((fill|stroke|width)\:[^\|]+\|)*(enc:.+|-?\d+(\.\d*)?,-?\d+(\.\d*)?(\|-?\d+(\.\d*)?,-?\d+(\.\d*)?)+)

      • bạn có thể tách kinh độ vĩ độ bằng cách lng,lat, và tách nhiều tọa độ bằng cách sau

        • Ví dụ: path=105.78815,21.03328|105.78792,21.03236

      • Định dạng mã hóa đa đường thẳng của Google

        • Ví dụ: path=enc:_ak_C}vtdSvDl@
        • If 'enc:' is used, the rest of the path parameter is considered to be part of the encoded polyline string -- do not specify the coordinate pairs.

      • Với các lựa chọn (fill|stroke|width)

        • Ví dụ: path=stroke:yellow|width:2|fill:green|105.78815,21.03328|105.78792,21.03236 or path=stroke:blue|width:1|fill:yellow|enc:_ak_C}vtdSvDl@

      • Có thể cung cấp nhiều lần

    • latlng - thể hiện ở dạng "vĩ độ,kinh độ" lat,lng thứ tự sẽ không giống với đường và chấm điểm được thể hiện theo dạng "kinh độ,vĩ độ" lng,lat.

    • fill - Màu mặc định áp dụng cho tất cả các đường (Ví dụ: red, rgba(255,255,255,0.5), #0000ff)

    • stroke - Màu viền mặc định áp dụng cho tất cả các đường

    • width - Độ dày của viền áp dụng cho tất cả các đường

    • linecap - kiểu của điểm bắt đầu và điểm kết thúc của đường - Tìm hiểu thêm.

    • linejoin - Kiểu điểm giao nhau giữa các đường - Tìm hiểu thêm.

    • border - Màu biên phần viền của tất cả các đường; phần biên này giúp cho các đường được tạo hiển thị rõ ràng hơn bằng cách tạo một một quầng sáng phía ngoài của viền đường.

    • borderwidth - độ dày của biên (mặc định sẽ là 10% của độ dày viền) áp dụng cho tất cả các đường.

    • marker - Đánh dấu điểm theo định dạng lng,lat|iconPath|option|option|...

      • Điểm đánh dấu sẽ được hiển thị ở vị trí tâm dưới của vị trí bạn cung cấp

      • lng,lat và iconPath là tham số bắt buộc, hệ thống sẽ không hiển thị icon điểm đánh dấu nếu thiếu hai tham số này.

      • iconPath bạn có thể thêm liên kết của một hình ảnh dưới dạng đường dẫn http(s), hoặc một đường dẫn đến một tệp icon đường liên quan đã được thiết lập

      • option phải tuân theo định dạng optionName:optionValue và hỗ trợ các tên sau:

        • scale - Điều chỉnh tỷ lệ của hình ảnh

          • Ví dụ: 0.5 - Điều chỉnh tỷ lệ của hình ảnh xuống còn một nửa so với hình ảnh gốc.

        • offset - Độ dịch chuyển hình của ảnh dưới dạng giá trị pixel dương hoặc âm theo định dạng [offsetX],[offsetY]

          • Giá trị này được điều chỉnh dựa trên tham số scale, vì vị trí hình ảnh liên quan tới kích thước của nó.
          • Ví dụ: 2,-4 - Hình ảnh sẽ được dịch chuyển 2 pixel sang bên phải và 4 pixel lên trên từ vị trí đã cung cấp.

      • Ví dụ: 105.78815,21.03328|marker-icon.png|scale:0.5|offset:2,-4

      • Có thể cung cấp nhiều lần.

    • padding - "Tỷ lệ phần trăm" của khoảng đệm để căn chỉnh các endpoints (dựa trên khu vực và tự động căn chỉnh đường đi)

      • Với giá trị 0.1 có nghĩa là "thêm 10% kích thước khoảng đệm ở mỗi bên để đảm bảo khu vực quan tâm được hiển thị rõ ràng".

    • maxzoom - Mức độ thu phóng tối đa (chỉ áp dụng cho endpoint tự động nơi mức độ thu phóng được tính toán và không được cung cấp).