getCurrentPosition(options)
デバイスの現在の地理的位置情報を取得します。
options
— (必須) 場所の要求を設定するためのLocationServiceOptions
オブジェクト。
デバイスの位置情報の詳細を使用して Location
として解決される Promise オブジェクト。
却下された Promise では、エラーに関する詳細が含まれる LocationServiceFailure
オブジェクトが返されます。
この関数は、1 回限りの位置情報の要求を実行し、その時点でのデバイスの現在位置を返します。
この関数がコールされると、現在地取得の要求がデバイスの位置情報機能に送られます。デバイスの現在位置が確定すると、Location
オブジェクトで Promise が解決されます。現在地の特定にかかる時間は、さまざまな外的要因のために、ほぼ瞬時から数秒までばらつく可能性があります。
位置情報の要求に関係するユーザインターフェースはありません。応答を待機している間にフィードバックを表示するには、Lightning Web コンポーネントのコードを更新します。getCurrentPosition()
を呼び出す直前に、lightning-spinner を表示することをお勧めします。そして、getCurrentPosition()
Promise ハンドラの finally()
句でこのスピナーを削除します。
関連トピック