DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 行動應用開發(一):結合地理定位 API 與 Web 服務
編輯:HTML5教程     

HTML5 是一項令人振奮的技術,這背後有著充分的理由。它將是一次真正的技術突破,因為它能夠把桌面應用程式的功能帶進瀏覽器之中。而在行動瀏覽器上,它的潛力甚至更為可觀——不僅如此,最受歡迎的行動瀏覽器早已開始採用並實作 HTML5 規範中許多重要部分。在這個由五部分組成的系列中,你將深入了解 HTML5 裡一些對行動 Web 應用開發影響深遠的新技術。本系列每一部分都會帶你動手打造一個展示 HTML5 新特性的行動 Web 應用,這些特性都能運行於最新的行動瀏覽器之上,例如 iPhone 與 Android 裝置。

常用縮寫

  • API:應用程式介面
  • CSS:層疊樣式表
  • GPS:全球定位系統
  • HTML:超文本標記語言
  • JSONP:帶填充的 JSON
  • SDK:軟體開發工具包
  • UI:使用者介面
  • W3C:全球資訊網協會

先決條件

本文中,你將運用最新的 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

  1. navigator.geolocation.getCurrentPosition(successCallback, errorCallback, options);

這是地理定位中最重要的 API。對於絕大多數應用而言,僅靠這一個 API 便足矣。地理定位物件是標準 navigator 物件的一部分,它擁有幾個方法,其中最常用的是 getCurrentPosition。取得使用者位置是相當耗時的操作(就像要在太空中鎖定一顆衛星一樣!),而且還需要事先獲得使用者同意,因此它是一個非同步操作。它的參數是一組回呼函式:一個用於成功,一個用於失敗。

成功函式會收到一個 Position 類型的參數。這個物件有兩個屬性:一個是時間戳,另一個是名為 Coordinates 類型的「座標」屬性。Coordinates 物件包含以下幾個屬性:

  1. latitude
  2. longitude
  3. altitude
  4. accuracy
  5. altitudeAccuracy
  6. heading
  7. speed

這些參數並非在所有裝置上都可用,除了 latitude、longitude 與 accuracy 之外。只要裝置支援地理定位 API,且能解析出位置,你就能取得 latitude、longitude 與 accuracy。

失敗回呼函式則會收到一個 PositionError 類型的參數。PositionError 有兩個屬性:code 與 message。message 是裝置特定的,可用於除錯;code 則有以下三種取值:

  1. PERMISSION_DENIED (1)
  2. POSITION_UNAVAILABLE (2)
  3. TIMEOUT (3)

應用程式應依據 code,向使用者顯示友善的失敗訊息。

請注意,W3C 規範還允許傳入第三個參數,用於設定取得位置的逾時時間。儘管如此,像 iPhone 這類裝置目前尚未支援,因此並不建議使用。既然已詳細看過 API,下面就來看看實際的使用範例。

與 Twitter 整合

接下來,我們讓 hello world 混搭程式透過某種方式用上 Twitter。第一個範例將使用 Twitter 的搜尋 API,它支援依位置範圍搜尋貼文。清單 2 展示的是本地化的 Twitter 搜尋。

清單 2. 本地 Twitter 搜尋

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta name = "viewport" content = "width = device-width"/>
  5. <title>Local Twitter Search</title>
  6. <script type="text/javascript">
  7.     function startSearch(){
  8.         var gps = navigator.geolocation;
  9.         if (gps){
  10.             gps.getCurrentPosition(searchTwitter,
  11.                    function(error){
  12.                 alert("Got an error, code: " + error.code + " message: "
  13. + error.message);
  14.             });
  15.         } else {
  16.             searchTwitter();
  17.         } }
  18.     function searchTwitter(position){
  19.         var query = "https://search.twitter.com/search.json?callback=showResults&q=";
  20.         query += $("kwBox").value;
  21.         if (position){
  22.             var lat = position.coords.latitude;
  23.             var long = position.coords.longitude;
  24.             query += "&geocode=" + escape(lat + "," + long + ",50mi");
  25.         } }
  26.         var script = document.createElement("script");
  27.         script.src = query;
  28.         document.getElementsByTagName("head")[0].appendChild(script);
  29.     } }
  30. </script>
  31. </head>
  32. <body>
  33.    <div id="main">
  34.         <label for="kwBox">Search Twitter:</label>
  35.         <input type="text" id="kwBox"/>
  36.         <input type="button" value="Go!" onclick="startSearch()"/>
  37.    </div>
  38.    <div id="results"> </div>
  39. </body>
  40. </html>

使用者可以在文字框中輸入搜尋關鍵字,點擊按鈕便會呼叫 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 地圖整合

本範例中,你將使用 Google 地圖 API。這些 API 已針對行動裝置進行優化,尤其是 iPhone 與 Android 平台,這使它們對行動 Web 開發者格外具有吸引力,特別是在開發位置感知應用時。下面的範例將在地圖上標示使用者位置,並在使用者每次改變位置時更新。清單 3 是對應的地圖程式碼。

清單 3. 使用 Geolocation 的地圖應用

  1. <html>
  2. <head>
  3. <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
  4. <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
  5. <title>I’m tracking you!</title>
  6. <script type="text/javascript" src="https://maps.google.com/maps/api/js? sensor=true"></script>
  7. <script type="text/javascript">
  8.     var trackerId = 0;
  9.     var geocoder;
  10.     var theUser = {};
  11.     var map = {};
  12.     function initialize() {
  13.         geocoder = new google.maps.Geocoder();
  14.         if (navigator.geolocation){
  15.             var gps = navigator.geolocation;
  16.             gps.getCurrentPosition(function(pos){
  17.                 var latLng = new google.maps.LatLng(pos.coords.latitude,pos.coords.longitude);
  18.                 var opts = {zoom:12, center:latLng, mapTypeId: google.maps.MapTypeId.ROADMAP};
  19.                 map = new google.maps.Map($("map_canvas"), opts);
  20.                 theUser = new google.maps.Marker({ position: latLng, map: map, title: "You!" });
  21.                 showLocation(pos);
  22.             });
  23.             trackerId = gps.watchPosition(function(pos){
  24.                 var latLng = new google.maps.LatLng(pos.coords.latitude,pos.coords.longitude);
  25.                 map.setCenter(latLng);
  26.                 theUser.setPosition(latLng);
  27.                 showLocation(pos);
  28.             });
  29.         } }
  30. </script>
  31. </head>
  32. <body style="margin:0px; padding:0px;" onload="initialize()">
  33.    <div id="superbar">
  34.         <span class="msg">Current location: <span id="location"></span> </span>
  35.         <input type="button" value="Stop tracking me!" onclick="stopTracking()"/>
  36.    </div>
  37.   <div id="map_canvas" style="width:100%; height:90%; float:left; border: 1px solid black;"> </div>
  38. </body>
  39. </html>

當文件主體載入完成後,便會呼叫 initialize 函式。該函式會先檢查瀏覽器是否支援地理定位;若支援,便呼叫 getCurrentPosition,與清單 2 中的前一個範例一樣。當它取得位置後,就用 Google 地圖 API 建立地圖。請留意它是如何用緯度與經度來建立 google.maps.LatLng 物件的——這個物件被用來讓地圖居中。下一步,在地圖上建立一個標記來代表使用者當前位置,而這個標記同樣用到了從地理定位 API 接收到的緯度與經度。

建立地圖並放置標記之後,便开始追蹤使用者。這裡會捕獲從 watchPosition 回傳的 ID。每當收到新的位置,就把地圖重新居中到新位置,並把標記移到新位置。清單 4 展示了另外兩個值得了解的函式。

清單 4. 地理編碼與取消追蹤函式

  1. function showLocation(pos){
  2.     var latLng = new google.maps.LatLng(pos.coords.latitude,pos.coords.longitude);
  3.     if (geocoder) {
  4.         geocoder.geocode({’latLng’: latLng}, function(results, status) {
  5.           if (status == google.maps.GeocoderStatus.OK) {
  6.             if (results[1]) { $("location").innerHTML = results[1].formatted_address; }
  7.           } }
  8.         });
  9.         }
  10. }
  11. function stopTracking(){
  12.     if (trackerId){
  13.         navigator.geolocation.clearWatch(trackerId);
  14.     } }

在清單 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 應用的效能。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved