`getCurrentPosition(options)`

デバイスの現在の地理的位置情報を取得します。

構文

1import { getLocationService } from 'lightning/mobileCapabilities';
2getCurrentPosition(options: LocationServiceOptions): Promise<Object>

パラメータ

options — (必須) 場所の要求を設定するための LocationServiceOptions オブジェクト。

戻り値

デバイスの位置情報の詳細を使用して Location として解決される Promise オブジェクト。

却下された Promise では、エラーに関する詳細が含まれる LocationServiceFailure オブジェクトが返されます。

使用方法

この関数は、1 回限りの位置情報の要求を実行し、その時点でのデバイスの現在位置を返します。

1myLocationService
2  .getCurrentPosition({ enableHighAccuracy: true })
3  .then((result) => {
4    this.myLocation = result.coords;
5  })
6  .catch((error) => {
7    console.error(error);
8  });

この関数がコールされると、現在地取得の要求がデバイスの位置情報機能に送られます。デバイスの現在位置が確定すると、Location オブジェクトで Promise が解決されます。現在地の特定にかかる時間は、さまざまな外的要因のために、ほぼ瞬時から数秒までばらつく可能性があります。

位置情報の要求に関係するユーザインターフェースはありません。応答を待機している間にフィードバックを表示するには、Lightning Web コンポーネントのコードを更新します。getCurrentPosition() を呼び出す直前に、lightning-spinner を表示することをお勧めします。そして、getCurrentPosition() Promise ハンドラの finally() 句でこのスピナーを削除します。

関連トピック

The Japanese Summer '24 guide is now live

日本語の Summer '24 ガイドが公開されました! 「Component Reference (コンポーネントリファレンス)」は、以前と同様にコンポーネントライブラリにあります。