仕様書

GeolocationPosition

[6] GeolocationPosition インターフェイスは、 文書環境に晒され、 保安文脈で利用可能です。 >>3

[7] GeolocationPosition オブジェクトは 1対の位置情報を表します。

[9] GeolocationPosition インターフェイスメンバー

[8] getCurrentPosition や watchPosition で作成されます。作成後の状態の変更はできません。

[11] GeolocationPosition オブジェクトの状態
coordsGeolocationCoordinates
GeolocationCoordinates
timestampGeolocationPosition
GeolocationPosition を取得した時刻を表す DOMTimeStamp >>3。

[10] GeolocationPosition インターフェイスの coordsGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [12] 文脈オブジェクトの coordsGeolocationCoords を返します。

[13] GeolocationPosition インターフェイスの timestampGeolocationPosition IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [14] 文脈オブジェクトの timestampGeolocationPosition を返します。

[5] 将来の版では住所など他の情報が追加され得ると想定されていました。 >>3

GeolocationCoordinates

[15] GeolocationCoordinates インターフェイスは、 文書環境に晒され、 保安文脈で利用可能です。 >>3

[16] GeolocationCoordinates インターフェイスメンバー

[17] getCurrentPosition や watchPosition で作成されます。作成後の状態の変更はできません。

[18] GeolocationCoordinates オブジェクトの状態
latitudeGeolocationCoordinates
longitudeGeolocationCoordinates
accuracyGeolocationCoordinates
altitudeGeolocationCoordinates
altitudeAccuracyGeolocationCoordinates
headingGeolocationCoordinates
speedGeolocationCoordinates

[33] latitudeGeolocationCoordinates は、 WGS84 緯度を十進度で double で表したものです。 longitudeGeolocationCoordinates は、 WGS84 経度を十進度で double で表したものです。 >>3

[35] accuracyGeolocationCoordinates は、 緯度・経度の正確度を表すものです。 メートル単位の非負実数で double で表したものです。 95%信頼区間に相当する値とするべきです。 >>3

[19] GeolocationCoordinates インターフェイスの latitudeGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [20] 文脈オブジェクトの latitudeGeolocationCoordinates を返します。

[21] GeolocationCoordinates インターフェイスの longitudeGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [22] 文脈オブジェクトの longitudeGeolocationCoordinates を返します。

[23] GeolocationCoordinates インターフェイスの accuracyGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [24] 文脈オブジェクトの accuracyGeolocationCoordinates を返します。

[34] altitudeGeolocationCoordinates は、 WGS84楕円体上の高度をメートル単位の double で表したものです。 >>3

[36] altitudeAccuracyGeolocationCoordinates は、 高度の正確度を表すものです。 メートル単位の非負実数で double で表したものです。 95%信頼区間に相当する値とするべきです。 >>3

[37] 実装が高度情報を取得できない場合、 altitudeGeolocationCoordinates と altitudeAccuracyGeolocationCoordinates は null とします。 >>3

[25] GeolocationCoordinates インターフェイスの altitudeGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [26] 文脈オブジェクトの altitudeGeolocationCoordinates を返します。

[27] GeolocationCoordinates インターフェイスの altitudeAccuracyGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [28] 文脈オブジェクトの altitudeAccuracyGeolocationCoordinates を返します。

[38] headingGeolocationCoordinates は、 装置の進行方向を、真北から時計回りに [0, 360) の度単位の double で表したものです。 この情報を取得できない時は null とします。 装置が静止している (speedGeolocationCoordinates = 0) ときは NaN とします。 >>3

[39] 仕様書は double (≠ unrestricted double) としながら NaN を使っており、矛盾しています。どちらが正しいのか不明。

[42] 装置の方向を取得する API は他にあります。

[40] speedGeolocationCoordinates は、 装置の現在の速度の水平成分の大きさをメートル毎秒単位の非負実数で dobule で表したものです。 この情報を取得できない時は null とします。 >>3

[29] GeolocationCoordinates インターフェイスの headingGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [30] 文脈オブジェクトの headingGeolocationCoordinates を返します。

[31] GeolocationCoordinates インターフェイスの speedGeolocationCoordinates IDL属性 >>3 の取得器は、 次のようにしなければなりません。

  1. [32] 文脈オブジェクトの speedGeolocationCoordinates を返します。

実装

[41] Windows の Chrome では、 緯度と経度とその正確度だけ得られ、他は null でした。 といっても当該装置で利用できるセンサーの種類によってどの値が得られるのかは変わってくると思われます。

歴史

[4] 当初のインターフェイス名は Position、 Coordinates でした。

[1] Geolocation API Specification ( ( 版)) http://www.w3.org/TR/geolocation-API/#position_interface

[2] Geolocation API Specification ( ( 版)) http://www.w3.org/TR/geolocation-API/#coordinates_interface