このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTMLGeolocationElement: location イベント

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

構文

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

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

onlocation = (event) => { }

イベント型

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 のメインページを参照してください。

仕様書

This feature does not appear to be defined in any specification.

ブラウザーの互換性

関連情報