這次我們把 HTML5 的 geolocation 結合 Google Maps,做一個能標出自己位置的小應用。Google Maps 官方文件:https://developers.google.com/maps/documentation/javascript/?hl=zh-TW 。
要使用 Google Maps,先在頁面中加上 script 標籤:
<script type="text/javascript"
src="https://maps.google.com/maps/api/js"></script>
早期版本還需要帶一個 sensor 參數,用來宣告你的應用是否使用 GPS 等感測器來判斷使用者位置——若使用就必須設為 true,行動裝置上尤其重要。要注意這個參數後來已被官方標示為不必要,現在的寫法改為帶上自己的 API key,因此建議直接省略 sensor。
結構很簡單,準備一個 div 當容器就好:
<body>
<div id="map" style="width: 100%; height: 500px;"></div>
</body>
提醒一下,Google Maps 需要容器有明確的高度,否則地圖不會顯示。
<script type="text/javascript">
var map;
var browserSupport = false;
var attempts = 0;
$(document).ready(function () {
InitMap(); // 初始化地圖
getLocation(); // 取得目前位置
watchLocation(); // 持續追蹤位置
});
function InitMap() { }
function getLocation() { }
function watchLocation() { }
// 把位置畫到地圖上並縮放過去
function plotLocation(position) { }
// 統一在這裡回報錯誤
function reportProblem(e) { }
</script>
InitMap 負責呼叫 Google Maps API 建立地圖,重點是那份 options 設定物件:
function InitMap() {
var options = {
zoom: 4,
center: new google.maps.LatLng(38.6201, -90.2003),
mapTypeId: google.maps.MapTypeId.ROADMAP,
mapTypeControl: true,
mapTypeControlOptions: {
style: google.maps.MapTypeControlStyle.HORIZONTAL_BAR,
position: google.maps.ControlPosition.BOTTOM_CENTER
},
panControl: true,
panControlOptions: {
position: google.maps.ControlPosition.TOP_RIGHT
},
zoomControl: true,
zoomControlOptions: {
style: google.maps.ZoomControlStyle.LARGE,
position: google.maps.ControlPosition.LEFT_CENTER
},
scaleControl: true,
scaleControlOptions: {
position: google.maps.ControlPosition.BOTTOM_LEFT
},
streetViewControl: true,
streetViewControlOptions: {
position: google.maps.ControlPosition.LEFT_TOP
}
};
map = new google.maps.Map($('#map')[0], options);
}
這裡把各種控制元件(地圖型別、平移、縮放、比例尺、街景)逐一開啟並指定位置,就是為了示範 options 可以控制到多細。實務上如果沒有特別需求,只留 zoom、center、mapTypeId 三項也能跑。
function getLocation() {
// 檢查瀏覽器是否支援 W3C Geolocation API
if (navigator.geolocation) {
browserSupport = true;
navigator.geolocation.getCurrentPosition(
plotLocation, reportProblem, { timeout: 45000 }
);
} else {
reportProblem();
}
}
function watchLocation() {
if (navigator.geolocation) {
browserSupport = true;
navigator.geolocation.watchPosition(
plotLocation, reportProblem, { timeout: 45000 }
);
} else {
reportProblem();
}
}
兩者的差別是:getCurrentPosition 只取一次位置,watchPosition 則會持續回報位置變化,適合需要即時追蹤的場景(例如運動 App 的路線記錄)。在一般頁面上同時呼叫兩者其實是重複的,實作時挑一個就好。
成功取得座標後,交給 plotLocation 在 Google Maps 上標記並置中:
function plotLocation(position) {
attempts = 0;
var point = new google.maps.LatLng(
position.coords.latitude,
position.coords.longitude
);
var marker = new google.maps.Marker({
position: point,
map: map
});
map.setCenter(point);
map.setZoom(15);
}
Demo 下載:googleMapGeolocation.rar
第一,Geolocation 涉及隱私,瀏覽器一定會先跳出詢問,使用者按下「允許」才會回傳座標;若被拒絕,reportProblem 收到的錯誤碼會是 PERMISSION_DENIED。請務必在版面設計上預留這個情境,不要假設定位一定會成功。
第二,定位精度取決於裝置與環境:桌機多半靠 IP 推估,可能只對到城市等級;手機有 GPS 時可達數公尺。所以把 setZoom 寫死成 15 未必合適,可以參考回傳的 position.coords.accuracy 動態調整縮放層級。