ジオロケーション

The geolocation 属性は Geolocation API にアクセスするためのエントリポイントを提供します。

Geolocation のインスタンスは以下の表に示す内部スロットで作成されます:

The getCurrentPosition(successCallback, errorCallback, options) メソッドの手順は次のとおりです:

1. If this's relevant global object's associated Document is not fully active:
   1. Call back with error errorCallback and POSITION_UNAVAILABLE.
   2. Terminate this algorithm.
2. Request a position passing this, successCallback, errorCallback, and options.

The watchPosition(successCallback, errorCallback, options) メソッドの手順は次のとおりです:

1. If this's relevant global object's associated Document is not fully active:
   1. Call back with error passing errorCallback and POSITION_UNAVAILABLE.
   2. Return 0.
2. Let watchId be an implementation-defined unsigned long that is greater than zero.
3. Append watchId to this's [[watchIDs]].
4. Request a position passing this, successCallback, errorCallback, options, and watchId.
5. Return watchId.

When clearWatch() is invoked, the user agent MUST:

1. Remove watchId from this's [[watchIDs]].

位置を 要求する には、Geolocation geolocation、PositionCallback の successCallback、PositionErrorCallback? の errorCallback、PositionOptions の options、および省略可能な watchId を渡します:

1. Let watchIDs be geolocation's [[watchIDs]].
2. Let document be the geolocation's 関連するグローバルオブジェクト の 関連付けられた Document.
3. If document is not 使用が許可されている the "geolocation" feature:
   1. If watchId was passed, remove watchId from watchIDs.
   2. エラーでコールバックを呼び出す として errorCallback に PERMISSION_DENIED を渡します。
   3. このアルゴリズムを終了します。
4. If geolocation's 環境設定オブジェクト is a 非セキュアコンテキスト:
   1. If watchId was passed, remove watchId from watchIDs.
   2. エラーでコールバックを呼び出す として errorCallback に PERMISSION_DENIED を渡します。
   3. このアルゴリズムを終了します。
5. If document's 可視性状態 is "hidden", wait for the following ページ可視性変更手順 to run:
   1. Assert: document's 可視性状態 is "visible".
   2. 以下の次の手順に進みます。
6. Let descriptor be a new PermissionDescriptor whose name is "geolocation".
7. 並列で:
   1. Set permission to 許可の要求 for descriptor.
   2. If permission is "denied", then:
      1. If watchId was passed, remove watchId from watchIDs.
      2. エラーでコールバックを呼び出す として errorCallback に PERMISSION_DENIED を渡します。
      3. このアルゴリズムを終了します。
   3. Wait to 位置を取得する ために successCallback, errorCallback, options, および watchId を渡します。
   4. If watchId was not passed, terminate this algorithm.
   5. While watchIDs contains watchId:
      1. 位置の大きな変化を待機する。何が「位置の大きな変化」に相当するかは実装に委ねられます。ユーザーエージェントは報告頻度にレート制限を課すことが MAY あります。ユーザーエージェントは MUST、エミュレート位置データの設定 を重大な変化として考慮する必要があります。
      2. If document is not 完全にアクティブ または 可視性状態 が "visible" でない場合、前のステップに戻り再び 位置の大きな変化を待機する。
         注: 位置の更新は完全にアクティブで可視なドキュメントに限られる
      3. Wait to 位置を取得する ために successCallback、 errorCallback、options、および watchId を渡します。

位置を 取得する には、PositionCallback の successCallback、PositionErrorCallback? の errorCallback、 PositionOptions の options、および省略可能な watchId を渡します。

1. If watchId was passed and this's [[watchIDs]] does not contain watchId, terminate this algorithm.
2. Let acquisitionTime be a new EpochTimeStamp that represents now.
3. Let timeoutTime be the sum of acquisitionTime and options.timeout.
4. Let cachedPosition be this's [[cachedPosition]].
5. Create an implementation-specific timeout task that elapses at timeoutTime, during which it tries to acquire the device's position by running the following steps:
   1. Let permission be 現在の許可状態の取得 of "geolocation".
   2. If permission is "denied":
      1. Stop timeout.
      2. Do the ユーザーまたはシステムによる許可拒否 の失敗ケース手順。
   3. If permission is "granted":
      1. エミュレート位置を使用すべきか確認するため、以下の手順を実行します:
         1. Let emulatedPositionData be エミュレート位置データを取得 passing this.
         2. If emulatedPositionData is not null:
            1. If emulatedPositionData is a GeolocationPositionError:
               1. エラーでコールバックを呼び出す として errorCallback と emulatedPositionData の code を渡します。
               2. このアルゴリズムを終了します。
            2. Let position be 新しい GeolocationPosition を作成し、emulatedPositionData、acquisitionTime、および options.enableHighAccuracy を渡します。
            3. タスクをキューに入れる on the geolocation タスクソース で、 successCallback を « position » と "report" で呼び出す ステップを登録します。
            4. このアルゴリズムを終了します。
      2. Let position be null.
      3. If cachedPosition is not null, and options.maximumAge is greater than 0:
         1. Let cacheTime be acquisitionTime minus the value of the options.maximumAge member.
         2. If cachedPosition's timestamp's value is greater than cacheTime, and cachedPosition.[[isHighAccuracy]] equals options.enableHighAccuracy:
            1. タスクをキューに入れる on the geolocation タスクソース で、 successCallback を « cachedPosition » と "report" で呼び出す ステップを登録します。
            2. このアルゴリズムを終了します。
      4. Otherwise, if position is not cachedPosition, try to acquire position data from the underlying system, optionally taking into consideration the value of options.enableHighAccuracy during acquisition.
      5. If the timeout elapses during acquisition, or acquiring the device's position results in failure:
         1. Stop the timeout.
         2. Go to 失敗への対処.
         3. このアルゴリズムを終了します。
      6. If acquiring the position data from the system succeeds:
         1. Let positionData be a map with the following name/value pairs based on the acquired position data:

            "accuracy"

            A non-negative double that represents the accuracy value indicating the 95% confidence level in meters. Accuracy measures how close the measured coordinates are to the true position.

            "altitude"

            A double? that represents the altitude in meters above the [WGS84] ellipsoid, or null if not available. Altitude measures the height above sea level.

            "altitudeAccuracy"

            A non-negative double? that represents the altitude accuracy, or null if not available, indicating the 95% confidence level in meters. Altitude accuracy measures how close the measured altitude is to the true altitude.

            "heading"

            A double? that represents the heading in degrees, or null if not available or the device is stationary. Heading measures the direction in which the device is moving relative to true north.

            "latitude"

            A double that represents the latitude coordinates on the Earth's surface in degrees, using the [WGS84] coordinate system. Latitude measures how far north or south a point is from the Equator.

            "longitude"

            A double that represents the longitude coordinates on the Earth's surface in degrees, using the [WGS84] coordinate system. Longitude measures how far east or west a point is from the Prime Meridian.

            "speed"

            A non-negative double? that represents the speed in meters per second, or null if not available. Speed measures how fast the device is moving.

         2. Set position to 新しい GeolocationPosition を作成し、positionData、acquisitionTime、および options.enableHighAccuracy を渡します。
         3. Set this's [[cachedPosition]] to position.
      7. Stop the timeout.
      8. タスクをキューに入れる on the geolocation タスクソース で successCallback を « position » と "report" で呼び出す ステップを登録します。

   失敗への対処:

   • If acquiring a position fails, do one of the following based on the condition that matches the failure:

     ユーザーまたはシステムによる許可拒否:

     エラーでコールバックを呼び出す として errorCallback に PERMISSION_DENIED を渡します。

     注: ブラウザの許可とOSの許可の違い

     タイムアウトが経過した:

     エラーでコールバックを呼び出す として errorCallback に TIMEOUT を渡します。

     データ取得エラーまたはその他の理由:

     エラーでコールバックを呼び出す として errorCallback に POSITION_UNAVAILABLE を渡します。

エラーでコールバックを呼び出す 指示があったとき、与えられた PositionErrorCallback? の callback と unsigned short の code が与えられた場合:

1. If callback is null, return.
2. Let error be a newly created GeolocationPositionError instance whose code attribute is initialized to code.
3. タスクをキューに入れる on the geolocation タスクソース で、 callback を « error » と "report" で呼び出す ステップを登録します。

The enableHighAccuracy メンバーは、アプリケーションが できる限り正確な位置情報を受け取りたいことを示すヒントを提供します。 このメンバーの目的は、アプリケーションが高精度のジオロケーション修正を必須としないことを実装に伝え、したがって実装側が 大きな電力を消費するジオロケーションプロバイダ（例えば GPS）の使用を回避することを MAY できるようにすることです。

The timeout メンバーは、位置の取得が失効するまでの最大時間を ミリ秒単位で示します。

The maximumAge メンバーは、ウェブアプリケーションが許容する キャッシュされた位置の最大年齢をミリ秒単位で示します。

The coords 属性は地理座標を含みます。

The timestamp 属性は、デバイスの地理位置が取得された時刻を表します。

The toJSON() メソッドは、GeolocationPosition オブジェクトの JSON 表現を返します。

GeolocationPosition のインスタンスは、以下の表に示された内部スロットを持って作成されます:

本仕様で定義される次の task source があります。

geolocation task source

位置要求を実行する際に、非ブロッキングな PositionCallback および PositionErrorCallback をキューに入れるために本仕様で使用されます。

The latitude および longitude 属性は、 位置を度単位の実数で表し、[WGS84] 座標系を用います。

The accuracy 属性は、位置の精度半径をメートル単位で表します。

The altitude 属性は、位置の高さを [WGS84] 楕円体上のメートルで示します。

The altitudeAccuracy 属性は、高度の精度をメートル単位で表します（例えば 10 メートル）。

The heading 属性は、ホスティングデバイスの進行方向を角度（度）で表し、0° ≤ heading < 360° の範囲で真北に対して時計回りに測ります。

The speed 属性は、ホスティングデバイスの現在の速度の水平方向成分の大きさをメートル毎秒で示します。

The toJSON() メソッドは、GeolocationCoordinates オブジェクトの JSON 表現を返します。

新しい GeolocationPosition は、map の positionData、EpochTimeStamp の timestamp、および boolean の isHighAccuracy を用いて次の手順で構築されます:

1. Let coords be a newly created GeolocationCoordinates インスタンスにします。
2. For each key → value in positionData:
   1. Set coords's attribute named key to value.
3. Return a newly created GeolocationPosition インスタンスで、その coords 属性は coords に初期化され、 timestamp 属性は timestamp に初期化され、内部スロット [[isHighAccuracy]] は isHighAccuracy に設定されます。

PERMISSION_DENIED（数値 1）

位置要求 が、ユーザーによる API 利用の許可拒否、 または 非セキュアコンテキスト から行われたために失敗した場合。

POSITION_UNAVAILABLE（数値 2）

位置の取得 に失敗した場合。

TIMEOUT（数値 3）

timeout メンバーで指定された時間が経過しても、ユーザーエージェントが正常に 位置を取得 できなかった場合。

code 属性は、エラーでコールバックを呼び出すときに初期化された値 を返します（可能な値は 10.1 定数 を参照）。

message 属性は、code 属性の開発者向けの テキストによる説明です。