getCurrentPosition (クライアント API 参照)

  • [アーティクル]

デバイスの物理的場所機能を使用して、現在の場所を返します。

以下に使用できます

このメソッドは、モバイルクライアントでのみサポートされます。

構文

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 });
    }
);

Xrm.Device

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。