HTML5 是一項令人振奮的技術,這背後有著充分的理由。它將是一次真正的技術突破,因為它能夠把桌面應用程式的功能帶進瀏覽器之中。而在行動瀏覽器上,它的潛力甚至更為可觀——不僅如此,最受歡迎的行動瀏覽器早已開始採用並實作 HTML5 規範中許多重要部分。在這個由五部分組成的系列中,你將深入了解 HTML5 裡一些對行動 Web 應用開發影響深遠的新技術。本系列每一部分都會帶你動手打造一個展示 HTML5 新特性的行動 Web 應用,這些特性都能運行於最新的行動瀏覽器之上,例如 iPhone 與 Android 裝置。
常用縮寫
本文中,你將運用最新的 Web 技術來開發 Web 應用。這裡的絕大部分程式碼都是 HTML、JavaScript 與 CSS——它們是 Web 開發的核心技術。你最需要的工具,是能拿來測試的瀏覽器。就本文而言,我強烈建議使用 Mozilla Firefox 3.5 以上版本,因為它是支援地理定位的桌面瀏覽器。當然,你也需要在行動瀏覽器上測試,因此還需要最新的 iPhone 與 Android SDK。本文使用的是 iPhone SDK 3.1.3 與 Android SDK 2.1。
地理定位本身就是一項新技術,它能讓你得知使用者身在何處。然而,僅僅知道這一點並回報給使用者,其實並不特別有用——又有誰會真正在意自己所在的精確經緯度呢?唯有把它與其他資料和服務結合,這份位置資訊才能煥發價值,衍生出有趣的結果。而這些服務都需要使用者的經度與緯度作為輸入。這正是我們要取得的東西。下面清單 1 展示的是這方面的標準 JavaScript API。
清單 1. 找到使用者:getCurrentPosition
這是地理定位中最重要的 API。對於絕大多數應用而言,僅靠這一個 API 便足矣。地理定位物件是標準 navigator 物件的一部分,它擁有幾個方法,其中最常用的是 getCurrentPosition。取得使用者位置是相當耗時的操作(就像要在太空中鎖定一顆衛星一樣!),而且還需要事先獲得使用者同意,因此它是一個非同步操作。它的參數是一組回呼函式:一個用於成功,一個用於失敗。
成功函式會收到一個 Position 類型的參數。這個物件有兩個屬性:一個是時間戳,另一個是名為 Coordinates 類型的「座標」屬性。Coordinates 物件包含以下幾個屬性:
這些參數並非在所有裝置上都可用,除了 latitude、longitude 與 accuracy 之外。只要裝置支援地理定位 API,且能解析出位置,你就能取得 latitude、longitude 與 accuracy。
失敗回呼函式則會收到一個 PositionError 類型的參數。PositionError 有兩個屬性:code 與 message。message 是裝置特定的,可用於除錯;code 則有以下三種取值:
應用程式應依據 code,向使用者顯示友善的失敗訊息。
請注意,W3C 規範還允許傳入第三個參數,用於設定取得位置的逾時時間。儘管如此,像 iPhone 這類裝置目前尚未支援,因此並不建議使用。既然已詳細看過 API,下面就來看看實際的使用範例。
接下來,我們讓 hello world 混搭程式透過某種方式用上 Twitter。第一個範例將使用 Twitter 的搜尋 API,它支援依位置範圍搜尋貼文。清單 2 展示的是本地化的 Twitter 搜尋。
清單 2. 本地 Twitter 搜尋
使用者可以在文字框中輸入搜尋關鍵字,點擊按鈕便會呼叫 startSearch 函式,這裡就用上了地理定位 API。首先檢查它是否可用;若可用,便呼叫 getCurrentPosition。當成功回呼時,即交由 searchTwitter 函式處理;若回呼失敗,則傳入一個顯示失敗訊息的參數。
一旦瀏覽器成功定位,便會呼叫 searchTwitter 函式。這裡使用傳入的位置,向 Twitter 搜尋查詢加上 geocode 參數。清單 2 會搜尋指定位置方圓 50 英哩內的貼文。為了呼叫 Twitter,這裡使用了動態 script 標籤——這是一項常被稱為 JSONP 的技術。Twitter 搜尋 API 對此提供支援,讓你能直接從瀏覽器呼叫 Twitter 搜尋,而無須經過伺服器,這由查詢中的 callback 參數指明。請注意它被設為 showResults,這正是要被呼叫的函式名稱。清單 2 中未展示它,因為那部分只是用來建立 UI,但在本文的源碼中已一併包含(可查看下載)。圖 1 展示的是清單 2 程式碼在 iPhone 上運行的截圖。
圖 1. 從 iPhone 上搜尋 Twitter

本應用與其他位置感知應用一樣,只需取得一次位置即可。然而,還有其他應用需要在使用者移動時持續追蹤,這些應用就得用上更高階的地理定位 API。
有時候,應用程式不只需要知道使用者的當前位置,還要在使用者每次改變位置時即時更新。為此有一個專門的 API——watchPosition。它與 getCurrentPosition 十分相似,接收相同的參數,最大的不同在於它會回傳一個 ID。這個 ID 可與最後一個地理定位 API——clearWatch——搭配使用,後者會用到從 watchPosition 取得的 ID。當你呼叫 watchPosition 後,瀏覽器便會持續向你傳入的成功回呼函式推送更新,直到你呼叫 clearWatch 為止。由於持續不斷地取得位置會耗損裝置資源,因此請審慎使用這些 API。下面來看範例。
本範例中,你將使用 Google 地圖 API。這些 API 已針對行動裝置進行優化,尤其是 iPhone 與 Android 平台,這使它們對行動 Web 開發者格外具有吸引力,特別是在開發位置感知應用時。下面的範例將在地圖上標示使用者位置,並在使用者每次改變位置時更新。清單 3 是對應的地圖程式碼。
清單 3. 使用 Geolocation 的地圖應用
當文件主體載入完成後,便會呼叫 initialize 函式。該函式會先檢查瀏覽器是否支援地理定位;若支援,便呼叫 getCurrentPosition,與清單 2 中的前一個範例一樣。當它取得位置後,就用 Google 地圖 API 建立地圖。請留意它是如何用緯度與經度來建立 google.maps.LatLng 物件的——這個物件被用來讓地圖居中。下一步,在地圖上建立一個標記來代表使用者當前位置,而這個標記同樣用到了從地理定位 API 接收到的緯度與經度。
建立地圖並放置標記之後,便开始追蹤使用者。這裡會捕獲從 watchPosition 回傳的 ID。每當收到新的位置,就把地圖重新居中到新位置,並把標記移到新位置。清單 4 展示了另外兩個值得了解的函式。
清單 4. 地理編碼與取消追蹤函式
在清單 3 中,無論是地圖初次繪製,還是收到使用者位置更新時,都會呼叫 showLocation 函式,如清單 4 所示。它使用的是 google.maps.Geocoder 物件(在清單 3 的 initialize 函式開頭就已建立)。這個 API 既能執行地理編碼(把地址轉換為地圖座標,即緯度與經度),也能執行反向地理編碼——把地圖座標還原為實際位置。本範例中,我們把地理定位 API 產生的座標,交給 Google 地圖 API 進行反向編碼,並將結果顯示在螢幕上。
清單 4 中最後一個函式是 stopTracking,當使用者點擊清單 3 中 HTML 產生的按鈕時便會呼叫它。這裡會用到首次呼叫 watchPosition 時取得的 trackerId,只要把它傳給 clearWatch 函式,瀏覽器/裝置就會停止取得使用者位置,也不再呼叫 JavaScript。圖 2 展示的是追蹤應用運行時的截圖。
圖 2. 追蹤應用程式

當然,要真正測試追蹤功能,你需要改變自身位置。此時可以借助 Google App Engine,因為它能把你的 Web 應用上傳到一個公開可存取的位置,然後你就能直接在一台網路連線良好的行動裝置上測試。一切就緒後,你不妨搭乘公共交通工具,或請別人開車帶你四處走動,親眼看看你的 Web 應用如何對不斷變化的位置做出回應。
本文示範了如何在行動 Web 應用中使用地理定位 API。GPS 聽來迷人,實則相當複雜;但如你所見,地理定位的 W3C 標準提供了非常簡潔的 API,讓你能直接取得使用者位置,並隨時間變化持續追蹤,再把座標傳遞給眾多支援位置的 Web 服務,或是你自己正在開發的位置感知服務。在本系列關於 HTML5 與行動 Web 應用的第 2 部分中,你將看到如何利用本地儲存來提升行動 Web 應用的效能。