Static Map

Static Map (bản đồ tĩnh) là một dịch vụ cung cấp dữ liệu bản đồ ở một khu vực nào đó dưới dạng hình ảnh. Những hình ảnh này có thể được hiển thị trên web và thiết bị di động mà không cần sự hỗ trợ của thư viện ánh xạ hoặc API. Chúng trông giống như một bản đồ được nhúng. Nó không tương tác, có nghĩa là không có tính năng di chuyển, thu phóng hoặc thay đổi các lớp bản đồ.

Dịch vụ Static Map

Mô tả: Dịch vụ trả về dữ liệu ảnh theo khu vực bản đồ như tâm bản đồ(center), mức hiển thị (zoom), chiều rộng, chiều cao, ...

URL: /staticmap

Method: GET

Parameters:

Tham sốMô tảVí dụ
mapCác loại bản đồ nền do eKMap cung cấp. Giá trị bao gồm:
- osm-bright: Bản đồ eKMap Sáng
- osm-gray: Bản đồ eKMap Xám
- osm-dark: Bản đồ eKMap Đêm
- osm-night: Bản đồ eKMap Đêm xanh cô ban
- ctm-bright: Bản đồ eKMap Chi tiết Sáng
- ctm-night: Bản đồ eKMap Chi tiết Đêm xanh cô ban
- ctm-dark: Bản đồ eKMap Chi tiết Đêm
- ctm-gray: Bản đồ eKMap Chi tiết Xám
- bdm: Bản đồ eKMap hành chính
ctm-bright
heightChiều cao ảnh (yêu cầu)1024
widthChiều rộng ảnh (yêu cầu)1024
zoomMức hiển thị (Yêu cầu)14
centerVị trí tâm (Yêu cầu)14
bearingGóc xoay bản đồ, giá trị từ 0-360. Mặc định 00
pitchGóc cao độ so với đường chân trời, giá trị từ 0-60. Mặc định 00
styleDữ liệu JSON đặc tả các Overlay có thể thêm vào, JSON theo đặc tả Style của Mapbox và giá trị cần được mã hóa URL (encode)14
ratioHiển thị DPI cao, giá trị từ 1-10. Mặc định 114

Ví dụ dưới đây cung cấp ảnh Bản đồ eKMap Chi tiết (bản sáng) với kích thước 768x512 tại vị trí 105.7971,21.00324 ở mức hiển thị 15

$ curl "https://api.ekgis.vn/staticmap?height=512&width=768&center=105.7971,21.00324&zoom=15&map=ctm-bright&api_key={YOUR_API_KEY}"

Kết quả như sau:

Hoặc ví dụ dưới đây bạn có thể chồng xếp lên bản đồ đối tượng đường dạng GeoJSON lên đồ:

$ curl "https://api.ekgis.vn/staticmap?height=512&width=768&center=105.7971,21.00324&zoom=15&style=%7B%0A%20%20%22sources%22%3A%20%7B%0A%09%22geojson%22%3A%20%7B%0A%09%20%20%22type%22%3A%20%22geojson%22%2C%0A%09%20%20%22data%22%3A%20%7B%0A%09%09%22type%22%3A%20%22Feature%22%2C%0A%09%09%22properties%22%3A%20%7B%7D%2C%0A%09%09%22geometry%22%3A%20%7B%0A%09%09%09%22type%22%3A%20%22LineString%22%2C%0A%09%09%09%22coordinates%22%3A%20%5B%5B105.79213984157872%2C21.005574587174028%5D%2C%5B105.79385645535108%2C21.00329095425659%5D%2C%5B105.79510100032728%2C21.00172844844136%5D%2C%5B105.79617388393612%2C21.00042634776566%5D%2C%5B105.79709656383955%2C20.999304528843613%5D%5D%0A%09%09%7D%0A%09%20%20%7D%0A%09%7D%0A%20%20%7D%2C%0A%20%20%22layers%22%3A%20%5B%7B%0A%09%09%22id%22%3A%20%22geojson%22%2C%0A%09%09%22type%22%3A%20%22line%22%2C%0A%09%09%22source%22%3A%20%22geojson%22%2C%0A%09%09%22layout%22%3A%20%7B%0A%09%09%09%22line-join%22%3A%20%22round%22%2C%0A%09%09%09%22line-cap%22%3A%20%22round%22%0A%09%09%7D%2C%0A%09%09%22paint%22%3A%20%7B%0A%09%09%09%22line-color%22%3A%20%22%23ff0000%22%2C%0A%09%09%09%22line-width%22%3A%208%0A%09%09%7D%0A%09%7D%0A%20%20%5D%0A%7D&map=ctm-bright&api_key={YOUR_API_KEY}"

Kết quả như sau: