使用裝置地理位置功能傳回目前位置。
適用於
此方法僅支援行動用戶端。
語法
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
參數
| 參數名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
successCallback |
功能 | Yes | 傳回目前地理位置資訊時要呼叫的函式。 具有下列值的地理位置物件會傳遞至函式。 - coords：包含一組地理座標以及關聯的精確度和一組其他可選值，例如高度和速度。 - timestamp：代表取得物件的時間，並表示為 DOMTimeStamp。 |
errorCallback |
功能 | Yes | 作業失敗時要呼叫的函式。 會傳遞具有下列屬性的物件： - code：錯誤碼。 號碼。 - message：描述錯誤詳細資料的當地語系化訊息。 String.如果您的行動裝置上未啟用使用者位置設定，則錯誤訊息會指出相同的情況。 如果您使用的是舊版的模型導向應用程式行動用戶端，或行動裝置上無法使用地理位置功能，則會將 null 傳遞至錯誤回呼。 |
傳回值
成功時，傳回地理位置物件，其中包含稍早在 successCallback 函式中指定的值。
Exceptions
請參閱 Web 服務錯誤碼
備註
若要讓 getCurrentPosition 方法運作，必須在您的行動裝置上啟用地理位置功能，且模型導向應用程式行動用戶端必須具有存取裝置位置的權限，預設不會啟用。
Example
Xrm.Device.getCurrentPosition().then(
function success(location) {
Xrm.Navigation.openAlertDialog({
text: "Latitude: " + location.coords.latitude +
", Longitude: " + location.coords.longitude
});
},
function (error) {
Xrm.Navigation.openAlertDialog({ text: error.message });
}
);