座標點對齊地圖的方向
此範例示範如何在地圖上控制座標點 Feature 對齊地圖的方向，包含以下功能：
- 座標點對齊方式設定：使用
map.data.add()方法新增多個 Feature 點，並在 properties 中設定rotationAlignmentMap屬性，控制座標點對齊地圖的方向。 - 動態調整對齊方式：使用
map.data.setStyle()方法動態調整座標點的對齊方式。 - 恢復原始對齊方式：使用
map.data.setStyle()方法配合條件判斷，恢復原始對齊方式。
info
詳細使用說明請參考「資料層」。
<!DOCTYPE html>
<html>
<head>
<meta charset=utf-8 />
<title>座標點對齊地圖的方向</title>
<meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no" />
<script src="https://kw3dmap.localking.com.tw/openapi/loader/mapPlus-1.3.9.loader.js" crossorigin="anonymous" referrerpolicy="origin"></script>
<!-- Bootstrap CDN -->
<link
href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.1/dist/css/bootstrap.min.css"
rel="stylesheet"
integrity="sha384-4bw+/aepP/YC94hEpVNVgiZdgIC5+VKNBQNGCHeKRQN+PtmoHDEXuppvnDJzQIu9"
crossorigin="anonymous"
/>
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.5/font/bootstrap-icons.css"
/>
<script
src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.1/dist/js/bootstrap.bundle.min.js"
integrity="sha384-HwwvtgBNo3bZJJLYd8oVXjrBZt8cqVSpeBNS5n7C8IVInixGAoxmnlMuBnhbgrkm"
crossorigin="anonymous"
></script>
<style>
body { margin: 0; padding: 0; }
#map { width: 100vw; height: 100vh; }
#toolbar {
position: absolute;
top: 16px;
right: 16px;
width: fit-content;
height: fit-content;
}
</style>
</head>
<body>
<div id="map"></div>
<aside
id="toolbar"
class="d-flex flex-column align-items-center gap-3 bg-white p-2 pb-3 rounded-2 shadow"
>
<!-- 商標 -->
<div class="pb-2 border-bottom border-secondary-subtle">
<img
src="https://kw3dmap.autoking.com.tw/kingway-logo.png"
alt="Kingway map"
width="44"
height="44"
/>
</div>
<div>
<input
type="checkbox"
class="btn-check"
id="toggleBtnSetStyle"
autocomplete="off"
/>
<label
class="btn btn-outline-primary"
for="toggleBtnSetStyle"
data-bs-toggle="tooltip"
data-bs-placement="left"
data-bs-title="變更座標點對齊地圖的方向"
>
<i class="bi bi-gear-fill"></i>
</label>
</div>
</aside>
<script type="module">
const map = await new mapPlus(document.getElementById("map"), {
accessKey: "get_your_key", // 聯絡勤崴國際，取得專屬key
accessToken: "get_your_token", // 聯絡勤崴國際，取得專屬token
style: 'https://kw3dmap.localking.com.tw/openapi/map/kwmap.etxt', // 樣式
center: { lng: 121.52449353370274, lat: 25.026540436497626 },
zoom: 15.8,
pitch: 85
});
// Bootstrap 提示訊息 初始化
const tooltipList = document.querySelectorAll('[data-bs-toggle="tooltip"]');
const tooltipInit = [...tooltipList].map(
(tooltip) => new bootstrap.Tooltip(tooltip)
);
// 新增與地圖方向垂直對齊的點
map.data.add({
geometry: new mapPlus.Data.Point({
lng: 121.52345832858763,
lat: 25.025126634176872,
}),
properties: {
textField: "Align Viewport",
textSize: 12,
id: 1,
},
});
/* ══════════════════════════════════════════════════════════════════════════
* 座標點對齊方式設定：
- 可調整 properties 中的 rotationAlignmentMap，控制 ID 為 2 的座標點對齊地圖的方向。
══════════════════════════════════════════════════════════════════════════ */
map.data.add({
geometry: new mapPlus.Data.Point({
lng: 121.52345832858763,
lat: 25.028226634176872,
}),
properties: {
textField: "Align Map",
textSize: 12,
id: 2,
// 圖示及文字對齊地圖的方向，true 為平行地圖方向，false 為垂直地圖方向
rotationAlignmentMap: true,
},
});
const toggleStyle = (checkboxElement) => {
/* ══════════════════════════════════════════════════════════════════════════
* 動態設置座標點對齊方式
══════════════════════════════════════════════════════════════════════════ */
// 點擊第一下按鈕，將上方的點設為與地圖方向垂直對齊
if (checkboxElement.getAttribute("checked")) {
map.data.setStyle((f) => {
if (f.getProperty("id") === 2) {
return {
rotationAlignmentMap: false,
};
}
});
checkboxElement.removeAttribute("checked");
} else {
/* ══════════════════════════════════════════════════════════════════════════
* 恢復原始對齊方式
══════════════════════════════════════════════════════════════════════════ */
// 點擊第二下按鈕，恢復原始對齊方式
map.data.setStyle((f) => {
if (f.getProperty("id") === 2) {
return {
rotationAlignmentMap: true,
};
}
});
checkboxElement.setAttribute("checked", true);
}
};
const toggleBtnSetStyle = document.getElementById("toggleBtnSetStyle");
toggleBtnSetStyle.setAttribute("checked", true);
toggleBtnSetStyle.addEventListener("click", () => {
toggleStyle(toggleBtnSetStyle);
});
</script>
</body>
</html>
<script src="https://kw3dmap.localking.com.tw/openapi/loader/mapPlus-1.3.9.loader.js" crossorigin="anonymous" referrerpolicy="origin"></script>
<script
src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.1/dist/js/bootstrap.bundle.min.js"
integrity="sha384-HwwvtgBNo3bZJJLYd8oVXjrBZt8cqVSpeBNS5n7C8IVInixGAoxmnlMuBnhbgrkm"
crossorigin="anonymous"
></script>
<script type="module">
const map = await new mapPlus(document.getElementById("map"), {
accessKey: "get_your_key", // 聯絡勤崴國際，取得專屬key
accessToken: "get_your_token", // 聯絡勤崴國際，取得專屬token
style: 'https://kw3dmap.localking.com.tw/openapi/map/kwmap.etxt', // 樣式
center: { lng: 121.52449353370274, lat: 25.026540436497626 },
zoom: 15.8,
pitch: 85
});
// Bootstrap 提示訊息 初始化
const tooltipList = document.querySelectorAll('[data-bs-toggle="tooltip"]');
const tooltipInit = [...tooltipList].map(
(tooltip) => new bootstrap.Tooltip(tooltip)
);
// 新增與地圖方向垂直對齊的點
map.data.add({
geometry: new mapPlus.Data.Point({
lng: 121.52345832858763,
lat: 25.025126634176872,
}),
properties: {
textField: "Align Viewport",
textSize: 12,
id: 1,
},
});
/* ══════════════════════════════════════════════════════════════════════════
* 座標點對齊方式設定：
- 可調整 properties 中的 rotationAlignmentMap，控制 ID 為 2 的座標點對齊地圖的方向。
══════════════════════════════════════════════════════════════════════════ */
map.data.add({
geometry: new mapPlus.Data.Point({
lng: 121.52345832858763,
lat: 25.028226634176872,
}),
properties: {
textField: "Align Map",
textSize: 12,
id: 2,
// 圖示及文字對齊地圖的方向，true 為平行地圖方向，false 為垂直地圖方向
rotationAlignmentMap: true,
},
});
const toggleStyle = (checkboxElement) => {
/* ══════════════════════════════════════════════════════════════════════════
* 動態設置座標點對齊方式
══════════════════════════════════════════════════════════════════════════ */
// 點擊第一下按鈕，將上方的點設為與地圖方向垂直對齊
if (checkboxElement.getAttribute("checked")) {
map.data.setStyle((f) => {
if (f.getProperty("id") === 2) {
return {
rotationAlignmentMap: false,
};
}
});
checkboxElement.removeAttribute("checked");
} else {
/* ══════════════════════════════════════════════════════════════════════════
* 恢復原始對齊方式
══════════════════════════════════════════════════════════════════════════ */
// 點擊第二下按鈕，恢復原始對齊方式
map.data.setStyle((f) => {
if (f.getProperty("id") === 2) {
return {
rotationAlignmentMap: true,
};
}
});
checkboxElement.setAttribute("checked", true);
}
};
const toggleBtnSetStyle = document.getElementById("toggleBtnSetStyle");
toggleBtnSetStyle.setAttribute("checked", true);
toggleBtnSetStyle.addEventListener("click", () => {
toggleStyle(toggleBtnSetStyle);
});
</script>
<link
href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.1/dist/css/bootstrap.min.css"
rel="stylesheet"
integrity="sha384-4bw+/aepP/YC94hEpVNVgiZdgIC5+VKNBQNGCHeKRQN+PtmoHDEXuppvnDJzQIu9"
crossorigin="anonymous"
/>
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.5/font/bootstrap-icons.css"
/>
<style>
body { margin: 0; padding: 0; }
#map { width: 100vw; height: 100vh; }
#toolbar {
position: absolute;
top: 16px;
right: 16px;
width: fit-content;
height: fit-content;
}
</style>