這個外掛程式提供了有關該設備的位置,例如緯度和經度資訊。 常見的位置資訊來源包括全球定位系統 (GPS) 和網路信號,如 IP 位址、 RFID、 WiFi 和藍牙 MAC 位址和 GSM/CDMA 儲存格 Id 從推斷出的位置。 沒有任何保證,API 返回設備的實際位置。
此 API 基於W3C 地理定位 API 規範,並只執行已經不提供實現的設備上。
警告: 地理定位資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論這款應用程式如何使用地理定位資料,資料是否共用它的任何其他締約方和的資料 (例如,粗、 細,ZIP 代碼級別,等等) 的精度水準。 地理定位資料一般認為是敏感,因為它能揭示使用者的下落以及如果存儲,他們的旅行的歷史。 因此,除了應用程式的隱私權原則,您應強烈考慮之前應用程式訪問地理定位資料 (如果設備作業系統不會這樣做已經) 提供在時間的通知。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 (例如,通過為確定並不感謝提出的選擇)。 有關詳細資訊,請參閱隱私指南。
這個外掛程式定義了一個全球 navigator.geolocation
物件 (為平臺哪裡否則丟失)。
儘管物件是在全球範圍內,提供這個外掛程式的功能不可用直到 deviceready
事件之後。
document.addEventListener("deviceready", onDeviceReady, false); function onDeviceReady() { console.log("navigator.geolocation works well"); }
cordova plugin add cordova-plugin-geolocation
返回設備的當前位置到 geolocationSuccess
回檔與 Position
物件作為參數。 如果有錯誤,geolocationError
回檔傳遞一個 PositionError
物件。
navigator.geolocation.getCurrentPosition(geolocationSuccess, [geolocationError], [geolocationOptions]);
geolocationSuccess: 傳遞當前位置的回檔。
geolocationError: *(可選)*如果錯誤發生時執行的回檔。
geolocationOptions: *(可選)*地理定位選項。
// onSuccess Callback // This method accepts a Position object, which contains the // current GPS coordinates // var onSuccess = function(position) { alert('Latitude: ' + position.coords.latitude + '\n' + 'Longitude: ' + position.coords.longitude + '\n' + 'Altitude: ' + position.coords.altitude + '\n' + 'Accuracy: ' + position.coords.accuracy + '\n' + 'Altitude Accuracy: ' + position.coords.altitudeAccuracy + '\n' + 'Heading: ' + position.coords.heading + '\n' + 'Speed: ' + position.coords.speed + '\n' + 'Timestamp: ' + position.timestamp + '\n'); }; // onError Callback receives a PositionError object // function onError(error) { alert('code: ' + error.code + '\n' + 'message: ' + error.message + '\n'); } navigator.geolocation.getCurrentPosition(onSuccess, onError);
返回設備的當前的位置,當檢測到更改位置。 當設備檢索一個新位置時,則 geolocationSuccess
回檔執行與 Position
物件作為參數。 如果有錯誤,則 geolocationError
回檔執行同一個 PositionError
物件作為參數。
var watchId = navigator.geolocation.watchPosition(geolocationSuccess, [geolocationError], [geolocationOptions]);
geolocationSuccess: 傳遞當前位置的回檔。
geolocationError: (可選) 如果錯誤發生時執行的回檔。
geolocationOptions: (可選) 地理定位選項。
navigator.geolocation.clearWatch
停止了觀看中位置的更改。// onSuccess Callback // This method accepts a `Position` object, which contains // the current GPS coordinates // function onSuccess(position) { var element = document.getElementById('geolocation'); element.innerHTML = 'Latitude: ' + position.coords.latitude + '<br />' + 'Longitude: ' + position.coords.longitude + '<br />' + '<hr />' + element.innerHTML; } // onError Callback receives a PositionError object // function onError(error) { alert('code: ' + error.code + '\n' + 'message: ' + error.message + '\n'); } // Options: throw an error if no update is received every 30 seconds. // var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
若要自訂的地理 Position
檢索的可選參數.
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
enableHighAccuracy: 提供應用程式需要最佳的可能結果的提示。 預設情況下,該設備將嘗試檢索 Position
使用基於網路的方法。 將此屬性設置為 true
告訴要使用更精確的方法,如衛星定位的框架。 (布林值)
timeout: 時間 (毫秒) 從調用傳遞,允許的最大長度 navigator.geolocation.getCurrentPosition
或 geolocation.watchPosition
直到相應的 geolocationSuccess
回檔執行。 如果 geolocationSuccess
不會在此時間內調用回檔 geolocationError
傳遞回檔 PositionError.TIMEOUT
錯誤代碼。 (請注意,與一起使用時 geolocation.watchPosition
、 geolocationError
的時間間隔可以調用回檔每 timeout
毫秒!)(人數)
maximumAge: 接受其年齡大於指定以毫秒為單位的時間沒有緩存的位置。(人數)
Android 2.x 模擬器不除非 enableHighAccuracy
選項設置為 true
,否則返回地理定位結果.
停止觀察到 watchID
參數所引用的設備的位置。
navigator.geolocation.clearWatch(watchID);
watchPosition
清除的時間間隔。(字串)// Options: watch for changes in position, and use the most // accurate position acquisition method available. // var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true }); // ...later on... navigator.geolocation.clearWatch(watchID);
包含 Position
座標和時間戳記,由地理位置 API 創建。
coords: 一組的地理座標。(座標)
timestamp: 創建時間戳記為 coords
。(DOMTimeStamp)
Coordinates
的物件附加到一個 Position
物件,可用於在當前職位的請求中的回呼函數。 它包含一組屬性描述位置的地理座標。
latitude: 緯度以十進位度為單位。(人數)
longitude: 經度以十進位度為單位。(人數)
altitude: 高度在米以上橢球體中的位置。(人數)
accuracy: 中米的緯度和經度座標的精度級別。(人數)
altitudeAccuracy: 在米的海拔高度座標的精度級別。(人數)
heading: 旅行,指定以度為單位元數目相對於真北順時針方向。(人數)
speed: 當前地面速度的設備,指定在米每秒。(人數)
altitudeAccuracy: 不支援的 Android 設備,返回 null
.
altitudeAccuracy: 不支援的 Android 設備,返回 null
.
PositionError
物件將傳遞給 geolocationError
回呼函數中,當出現 navigator.geolocation 錯誤時發生。
code: 下面列出的預定義的錯誤代碼之一。
message: 描述所遇到的錯誤的詳細資訊的錯誤訊息。
PositionError.PERMISSION_DENIED
PositionError.POSITION_UNAVAILABLE
PositionError.TIMEOUT
timeout
中包含 geolocationOptions
。 與一起使用時 navigator.geolocation.watchPosition
,此錯誤可能反復傳遞給 geolocationError
回檔每 timeout
毫秒為單位)。