HTMLGeolocationElement: location イベント

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more support for this feature? Tell us why.

location は HTMLGeolocationElement インターフェイスのイベントで、ブラウザーが位置データを受信したとき、または位置データのリクエストが失敗した際のエラー情報を受信したときに発生します。

構文

このイベント名を addEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js
addEventListener("location", (event) => { })

onlocation = (event) => { }

例

location を使用して位置データやエラーに応答

埋め込み地図の例（ソースコード）では、location イベントハンドラーを使用して、位置データやエラーを受信したときに応答しています。

js
geo.addEventListener("location", () => {
  if (geo.position) {
    console.log(
      `${geo.position.coords.latitude},${geo.position.coords.longitude}`,
    );
    drawMap(geo.position.coords.latitude, geo.position.coords.longitude, geo);
  } else if (geo.error) {
    console.log(geo.error.message);
  }
});

位置データが正常に返された場合、HTMLGeolocationElement.position プロパティ経由でアクセスし、緯度と経度の値を取得します。これらの値をコンソールにログ出力した後、drawMap() 関数に HTMLGeolocationElement オブジェクトへの参照とともに渡して地図上にプロットします。データ取得に失敗した場合、HTMLGeolocationElement.error プロパティ経由でエラーにアクセスし、エラーメッセージをコンソールにログ出力します。

この例の完全な手順を追った解説については、HTMLGeolocationElement のメインページを参照してください。