HTMLGeolocationElement: position プロパティ

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

position は HTMLGeolocationElement インターフェイスの読み取り専用プロパティで、位置データの取得に成功した場合、ユーザーの現在地を表す GeolocationPosition オブジェクトを返します。

取得された位置情報は、最新である場合もあればそうでない場合もあります。<geolocation> 要素のボタンコントロールが押された際にのみ、ユーザーの位置情報が一度取得されます。ただし、watch 属性を true に設定した場合、ユーザー端末が移動するたびに新しい位置情報が取得されます。ユーザーの現在位置を読み取るには、location イベントが発生した際に position プロパティを参照する必要があります。

位置情報の取得に失敗した場合、関連付けられたエラー情報は HTMLGeolocationElement.error プロパティで取得できます。

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

position を含む実際の例については、組み込み地図の例の手順を追っての説明をご覧ください。