HTML5 令人振奮的理由很直接:它把過去只屬於桌面應用程式的能力搬進了瀏覽器。而在行動裝置上,這套標準的想像空間甚至更大——各家主流行動瀏覽器早已搶先實作 HTML5 規格中許多關鍵部分。這個由五篇文章組成的系列,將逐一剖析對行動 Web 開發影響深遠的新技術,並在每一篇中動手做出一個能直接在 iPhone、Android 等最新行動瀏覽器上執行的位置感知應用。
本文的示範程式幾乎全部由 HTML、JavaScript 與 CSS 這三項 Web 核心技術構成,因此你真正必備的工具只有一個:能測試的瀏覽器。桌面端建議使用 Firefox 3.5 以上版本,因為它是當時少數已支援地理定位的桌面瀏覽器;行動端則需要 iPhone SDK 與 Android SDK,本文的實測環境為 iPhone SDK 3.1.3 與 Android SDK 2.1。
定位本身是項新技術,但單是把經緯度回報給使用者,其實沒什麼用處——真的有那麼多人關心自己所在的精確座標嗎?位置資訊要與其他資料和服務結合才會產生價值,而這些服務的輸入,通常就是經度與緯度。取得座標的標準做法,是 W3C 定義的 JavaScript API:
navigator.geolocation.getCurrentPosition(successCallback, errorCallback, options);
大多數應用只需要這一個方法。地理定位物件是標準 navigator 物件的一部分,其中 getCurrentPosition 最為常用。取得位置是耗時操作(好比在太空中找一顆衛星),而且必須先取得使用者同意,因此它被設計成非同步呼叫,參數是兩個回呼函數:一個負責成功,一個負責失敗。
成功時會收到一個 Position 物件,它有兩個屬性:時間戳記,以及名為 Coordinates 的座標物件。Coordinates 提供下列欄位:
除 latitude、longitude、accuracy 之外,其餘欄位不保證在所有裝置上都可用。也就是說,只要瀏覽器支援地理定位且能解析位置,這三個值就應該拿得到。
失敗時收到的是 PositionError 物件,包含 code 與 message 兩個屬性。message 的內容依裝置而異,適合拿來除錯;code 則只有三種取值:
介面應依 code 顯示對使用者友善的提示。此外,W3C 規格雖然允許傳入第三個 options 參數(例如設定逾時時間),但當時 iPhone 等裝置尚未支援,因此不建議依賴。 API 看清楚了,接著看它實際怎麼用。
第一個範例是「Hello World 級」的位置混搭應用:用 Twitter 的搜尋 API,查詢指定位置半徑內的貼文。使用者輸入關鍵字並按下按鈕後,程式先確認瀏覽器是否支援地理定位;支援就呼叫 getCurrentPosition,成功後交由 searchTwitter 處理,失敗則跳出錯誤提示。
function startSearch(){
var gps = navigator.geolocation;
if (gps) {
gps.getCurrentPosition(searchTwitter, function(error){
alert("取得位置失敗,code: " + error.code + " message: " + error.message);
});
} else {
searchTwitter();
}
}
function searchTwitter(position){
var query = "https://search.twitter.com/search.json?callback=showResults&q=" + $("kwBox").value;
if (position) {
query += "&geocode=" + escape(position.coords.latitude + "," + position.coords.longitude + ",50mi");
}
var script = document.createElement("script");
script.src = query;
document.getElementsByTagName("head")[0].appendChild(script);
}
searchTwitter 會把回傳的位置加上 geocode 參數,限定搜尋半徑為 50 英里內的貼文。呼叫 Twitter 時使用的是動態 script 標籤,也就是俗稱 JSONP 的技術;Twitter 搜尋 API 原生支援,讓瀏覽器得以直接跨網域取得資料,完全不需要自己的伺服器。查詢字串中的 callback 參數指定為 showResults,即為回呼函數名稱。

這個應用和大多數位置感知程式一樣,只取一次位置。若要在使用者移動時持續更新,就得換用更高階的 API。
watchPosition 就是為此而生。它的參數與 getCurrentPosition 相同,差別在於會回傳一組 ID,可搭配 clearWatch 使用:呼叫 watchPosition 之後,瀏覽器會持續把新位置送進成功回呼,直到你呼叫 clearWatch 為止。由於反覆取得位置會消耗裝置資源,這些 API 務必謹慎使用。
Google 地圖 API 已針對行動裝置(尤其 iPhone 與 Android)做過優化,很適合拿來做位置感知應用。下面的範例會在地圖上標出使用者位置,並在位置變動時同步更新。
var trackerId = 0, geocoder, theUser = {}, map = {};
function initialize() {
geocoder = new google.maps.Geocoder();
if (navigator.geolocation) {
var gps = navigator.geolocation;
gps.getCurrentPosition(function(pos){
var latLng = new google.maps.LatLng(pos.coords.latitude, pos.coords.longitude);
var opts = {zoom: 12, center: latLng, mapTypeId: google.maps.MapTypeId.ROADMAP};
map = new google.maps.Map($("map_canvas"), opts);
theUser = new google.maps.Marker({position: latLng, map: map, title: "You!"});
showLocation(pos);
});
trackerId = gps.watchPosition(function(pos){
var latLng = new google.maps.LatLng(pos.coords.latitude, pos.coords.longitude);
map.setCenter(latLng);
theUser.setPosition(latLng);
showLocation(pos);
});
}
}
function stopTracking(){
if (trackerId) {
navigator.geolocation.clearWatch(trackerId);
}
}
頁面 body 載入完成後即呼叫 initialize。它先確認瀏覽器是否支援地理定位,接著用取得的緯經度建立 google.maps.LatLng 物件讓地圖居中,再放上一個代表使用者所在位置的標記;最後以 watchPosition 回傳的 ID 開始追蹤,每次收到新位置就重新置中並移動標記。
showLocation 函數則示範了反向地理編碼:把定位 API 給的座標交給 google.maps.Geocoder 轉換成人看得懂的地址,輸出到畫面上。而 stopTracking 做的事很單純——把 trackerId 交給 clearWatch,裝置便停止取位,JavaScript 也不再被呼叫。

要真正驗證追蹤行為,使用者必須移動。實務做法是把 Web 應用上傳到 Google App Engine 這類可公開存取的環境,用手機連上後實際走動:搭一段公車,或請人開車帶你繞一圈,就能觀察頁面如何回應不斷變化的座標。
本文示範了如何在行動 Web 應用中使用地理定位 API。GPS 聽來迷人卻相當複雜,而 W3C 的地理定位標準把它收斂成一個非常直覺的介面:取得目前位置、隨時間追蹤位置,再把座標交給任何支援位置的網路服務,或你自己開發的位置感知服務。系列第 2 篇將談如何用本機儲存(localStorage)提升行動 Web 應用的效能。