デバイスの物理的場所機能を使用して、現在の場所を返します。
使用可能な対象
このメソッドは、モバイルクライアントでのみサポートされます。
構文
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
Parameters
| パラメーター名 | タイプ | Required | Description |
|---|---|---|---|
successCallback |
Function | はい | 現在の位置情報が返される場合に呼び出す関数。 以下の値を持つ位置情報ブジェクトが関数に渡されます: - coords: 位置情報の座標とそれに伴う精度、高度や速度などのオプション値が含まれています。 - timestamp: オブジェクトが取得された時が DOMTimeStamp として表されます。 |
errorCallback |
Function | はい | 処理が失敗したときに呼び出す関数。 次のプロパティを持つオブジェクトが渡されます: - code: エラー コード。 番号。 - message: エラーの詳細を説明する RLocalized メッセージ。 ストリング。ユーザーの場所設定がモバイル デバイスで有効ではない場合、エラー メッセージが表示されます。 モデル駆動型アプリ モバイル クライアントの以前のバージョンを使用している場合、または物理的場所機能がモバイル デバイス上で使用できない場合、エラー コールバックに null が渡されます。 |
戻り値
成功時に、successCallback 関数の説明で指定済みの値を持つ位置情報オブジェクトを戻します。
例外
Web サービス エラー コード を参照してください
意見
getCurrentPosition メソッドが機能するには、物理的場所機能がモバイル デバイスで有効になっている必要があり、モデル駆動型アプリ モバイル クライアントは、既定で有効になっていないデバイスの場所へのアクセス許可が必要です。
例
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 });
}
);