HTML地理定位特性使得你的web應用程序可以獲得網站浏覽者的地理位置。地理位置實際上並不是HTML5規范的一部分，但是因為HTML5已經成為HTML和JavaScript新特性事實上的標桿，我在這個HTML5教程中介紹地理位置。
安全和隱私
用戶通過浏覽器對話框接受您的網站訪問他們的位置，所以你不能在它們不知道的情況下使用它進行間諜活動。
訪問地理位置
地理位置可以在JavaScript中通過浏覽器的navigator.geolocation對象訪問。地理位置對象允許你通過兩個基本方法訪問地理位置：
- getCurrentPosition()
- watchPosition()
getCurrentPositio()函數以一次性快照的形式返回游客的位置。watchPosition()函數在每次位置變化的時候返回游客的位置。它通過位置變化時調用成功或錯誤的回調函數來實現。
這兩個函數需要以下參數：
- 成功回調函數
- 錯誤回調函數（可選）
- 地理位置選擇對象（可選）
正如你看到的，一些參數是可選的。 下面是一個例子,通過getCurrentPosition()的成功回調函數訪問用戶的地理位置：
navigator.geolocation.getCurrentPosition(
function(position) {
alert("your position is: "
+ position.coords.latitude + ", "
+ position.coords.longitude);
}
);
地理位置是異步獲取的。這意味著，當你調用getCurrentPosition()或watchPosition()時函數會立即返回。 當浏覽器知道用戶的位置，並且用戶已經同意該網站可以訪問自己的地理位置，成功回調函數被調用。如果發生錯誤，錯誤回調函數被調用。
位置對象
傳遞給成功回調函數的位置對象大致如下：
double latitude // read only attribute
double longitude // read only attribute
double accuracy // read only attribute
double altitude // read only attribute
double altitudeAccuracy // read only attribute
double heading // read only attribute
double speed // read only attribute
latitude(緯度)和longitude(經度)屬性為地理位置坐標。accuracy屬性為位置精度(米)。accuracy越小，精度越高。
altitude, altitudeAccuracy, heading和speed屬性只有當運行浏覽器的設備內置GPS時才可用，否則這些屬性的值為null。
altitude屬性為用戶的海拔高度。altitudeAccuracy屬性為海拔高度精度(米)。heading屬性表示用戶移動的方向。value屬性是相對於正北的角度（0-360）。 speed屬性為用戶的速度(米每秒)，如果有的話。
速度
速度屬性只有在你使用watchPosition()方法時才有值。浏覽器顯然需要幾個位置來計算計算速度。
錯誤回調函數
如果無法獲得用戶的地理位置，傳遞給getCurrentPosition()或watchPosition()的錯誤回調函數將會被調用。無法獲得地理位置的原因可能如下：
- 用戶拒絕網站訪問地理位置。
- 運行浏覽器的設備無法獲得地理位置，例如，在隧道、地鐵等設備無法接收GPS衛星信號的地方。
- 該設備獲取位置的時間超時。
錯誤回調函數接受一個帶有兩個屬性的對象：
short code // unsigned read only attribute.
DOMString message // read only attribute.
code屬性的值是下面中一個：
- 1表示PERMISSION_DENIED
- 2表示POSSITION_UNAVAILABLE
- 3表示TIMEOUT
message屬性包含對錯誤的描述。對於開發人員來說，這個錯誤可能是有用的，但對網站的用戶來說可能沒有太大的意義。
地理位置選項對象 getCurrentPosition()和watchPosition()函數可以使用地理位置選項對象作為第三個參數。此選項對象可以包含以下屬性：
enableHighAccuracy // true or false
timeout // milliseconds
maximumAge // milliseconds
enableHighAccuracy屬性可以是true或false。值為true時告訴浏覽器如果設備有GPS的話，就啟用它。要記住GPS耗費很多的電量，除非需要很高的精度不要啟用它。
Timeout屬性告訴浏覽器要用多長時間來獲取到位置並調用成功回調函數，否則調用失敗回調函數。
maximumAge屬性告訴浏覽器你的應用可以接受的緩存位置的最長時間(以毫秒為單位)。值為0意味著浏覽器必須在每次調用成功回調函數時都獲取一個新的位置。
一個完整的例子
下面是一個代碼示例，使用了成功回調、錯誤回調和選項對象：
navigator.geolocation.getCurrentPosition(
function(position) {
alert("your position is: "
+ position.coords.latitude + ", "
+ position.coords.longitude);
}
,
function(errorObject) {
alert("Error obtaining position");
}
,
{
enableHighAccuracy : true,
timeout : 3000,
maximumAge : 60000
}
);
原文鏈接 OSCHINA原創翻譯
