ジオロケーション

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

getCurrentPosition(successCallback, errorCallback, options) メソッドの手順は以下の通りです：

1. もし現在の設定オブジェクトの 関連グローバルオブジェクトの 関連付けられたDocument が 完全にアクティブでない場合： もし this の 関連グローバルオブジェクトの 関連付けられたDocument が 完全にアクティブでない場合：
   1. エラーでコールバック errorCallback と POSITION_UNAVAILABLE を渡す。
   2. このアルゴリズムを終了する。
2. 位置をリクエストし、this、successCallback, errorCallback, options を渡す。

watchPosition(successCallback, errorCallback, options) メソッドの手順は以下の通りです：

1. もし現在の設定オブジェクトの 関連グローバルオブジェクトの 関連付けられたDocument が 完全にアクティブでない場合： もし this の 関連グローバルオブジェクトの 関連付けられたDocument が 完全にアクティブでない場合：
   1. エラーでコールバック（errorCallback と POSITION_UNAVAILABLE を渡す）。
   2. 0を返す。
2. watchId を 0 より大きい実装定義の unsigned longとして生成する。
3. watchIdを[[watchIDs]]に追加する。
4. 位置をリクエストし、this、successCallback, errorCallback, options、および watchId を渡す。
5. watchId を返す。

clearWatch()が呼び出されたとき、ユーザーエージェントは必須で以下を実行します：

1. watchIdをthisの [[watchIDs]]から削除する。

位置をリクエストするには、Geolocation geolocation、PositionCallback successCallback、PositionErrorCallback? errorCallback、PositionOptions options、およびオプションのwatchIdを渡します：

1. watchIDsをgeolocationの [[watchIDs]]に設定する。
2. documentをgeolocationの 関連グローバルオブジェクトの関連付けられたDocumentに設定する。
3. もしdocumentが"geolocation"機能の使用が許可されていない場合：
   1. もしwatchIdが渡された場合、watchIdを watchIDsから削除する。
   2. エラーでコールバックし、errorCallbackと PERMISSION_DENIEDを渡す。
   3. このアルゴリズムを終了する。
4. もしgeolocationのenvironment settings objectが 非セキュアなコンテキストの場合：
   1. もしwatchIdが渡された場合、watchIdを watchIDsから削除する。
   2. エラーでコールバックし、errorCallbackと PERMISSION_DENIEDを渡す。
   3. このアルゴリズムを終了する。
5. もしdocumentのvisibility stateが "hidden"の場合、以下のページ可視性変更手順が実行されるまで待機する：
   1. Assert: documentのvisibility stateは "visible"である。
   2. 以下の手順へ進む。
6. descriptorを新しいPermissionDescriptorとし、 nameに"geolocation"を設定する。
7. 並列で以下を実行する：
   1. permissionをrequest permission to use descriptorに設定する。
   2. もしpermissionが"denied"なら：
      1. もしwatchIdが渡された場合、watchIdを watchIDsから削除する。
      2. エラーでコールバックし、errorCallback と PERMISSION_DENIEDを渡す。
      3. このアルゴリズムを終了する。
   3. 位置を取得し、 successCallback、 errorCallback、options、watchIdを渡して待機する。
   4. もしwatchIdが渡されなかった場合、このアルゴリズムを終了する。
   5. watchIDsがwatchIdを含む間：
      1. 地理的位置が大きく変化するまで待機する。何が「大きく変化する」かは実装依存です。ユーザーエージェントは位置変化の報告頻度にレート制限を課してもよいです。ユーザーエージェントは必須でset emulated position dataの呼び出しを「大きな変化」とみなすこと。
      2. documentが完全にアクティブでない、 またはvisibility stateが "visible"でない場合、前の手順に戻り再度 地理的位置が大きく変化するまで待機する。
         注意: 位置更新は完全にアクティブかつ可視なドキュメントだけに限定
      3. 位置を取得し、 successCallback、 errorCallback、options、watchIdを渡して待機する。

位置を取得するには、 PositionCallback successCallback、 PositionErrorCallback? errorCallback、 PositionOptions options、およびオプションの watchIdを渡します。

1. もしwatchIdが渡されていて、thisの [[watchIDs]]がwatchIdを含まない場合、 このアルゴリズムを終了する。
2. acquisitionTimeを、現在時刻を表す新しいEpochTimeStampとして設定する。
3. timeoutTimeをacquisitionTimeと options.timeoutの合計値に設定する。
4. cachedPositionをthisの [[cachedPosition]]に設定する。
5. 実装依存のtimeoutタスクをtimeoutTimeで期限切れになるよう作成し、その間に以下の手順でデバイスの位置取得を試みる：
   1. permissionを現在の権限状態を取得し、 "geolocation"に対して設定する。
   2. もしpermissionが"denied"なら：
      1. timeoutを停止する。
      2. ユーザーまたはシステムが権限を拒否の失敗ケース手順を実行する。
   3. もしpermissionが"granted"なら：
      1. エミュレートされた位置を使用すべきか以下の手順でチェックする：
         1. emulatedPositionDataをget emulated position dataでthisを渡して取得する。
         2. もしemulatedPositionDataがnullでない場合：
            1. もしemulatedPositionDataが GeolocationPositionErrorの場合：
               1. エラーでコールバックし、 errorCallbackと emulatedPositionData.codeを渡す。
               2. このアルゴリズムを終了する。
            2. positionを新しい GeolocationPositionとして emulatedPositionData、acquisitionTime、 options.enableHighAccuracyを渡して生成する。
            3. タスクをキューに追加し、 geolocation task sourceで successCallbackを呼び出す （«position»と"report"を渡す）。
            4. このアルゴリズムを終了する。
      2. positionをnullに設定する。
      3. もしcachedPositionがnullでなく、 options.maximumAgeが0より大きい場合：
         1. cacheTimeを acquisitionTimeから options.maximumAgeの値を引いた値に設定する。
         2. もしcachedPositionの timestamp値が cacheTimeより大きく、 cachedPosition.[[isHighAccuracy]]が options.enableHighAccuracyと等しい場合：
            1. タスクをキューに追加し、 geolocation task sourceで successCallbackを呼び出す （«cachedPosition»と"report"を渡す）。
            2. このアルゴリズムを終了する。
      4. それ以外の場合、もしpositionがcachedPositionでないなら、基盤システムから位置データを取得する（可能なら options.enableHighAccuracyを考慮）。
      5. 取得中にtimeoutが期限切れになるか、位置取得が失敗した場合：
         1. timeoutを停止する。
         2. 失敗時の処理へ進む。
         3. このアルゴリズムを終了する。
      6. システムからの位置データ取得が成功した場合：
         1. positionDataを以下の取得位置データに基づくマップとして生成：

            "longitude"

            double 地球表面の経度座標（度）、[WGS84]座標系。経度は本初子午線からの東西距離。

            "altitude"

            double? [WGS84]楕円体上の高度（メートル）、利用不可ならnull。高度は海抜を表す。

            "accuracy"

            非負のdouble 95%信頼水準での精度値（メートル）。精度は測定座標が真の位置にどれだけ近いかを示す。

            "altitudeAccuracy"

            非負のdouble? 95%信頼水準での高度精度（メートル）、利用不可ならnull。高度精度は測定高度が真の高度にどれだけ近いかを示す。

            "speed"

            非負のdouble? 速度（メートル/秒）、利用不可ならnull。速度はデバイスの移動速度。

            "heading"

            double? 進行方向（度）、利用不可またはデバイスが静止時はnull。進行方向は真北に対する移動方向。

         2. positionを新しい GeolocationPositionとして positionData、acquisitionTime、 options.enableHighAccuracyを渡して生成する。
         3. thisの[[cachedPosition]]に positionを設定する。
      7. timeoutを停止する。
      8. タスクをキューに追加し、geolocation task sourceで successCallbackを呼び出す（«position»と"report"を渡す）。

   失敗時の処理:

   • 位置取得に失敗した場合、状況に応じて以下のいずれかを実行する：

     ユーザーまたはシステムが権限を拒否:

     エラーでコールバックし、errorCallbackと PERMISSION_DENIEDを渡す。

     注意: ブラウザーの権限VS OSの権限

     タイムアウト発生:

     エラーでコールバック（errorCallbackと TIMEOUTを渡す）。

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

     エラーでコールバック（errorCallbackと POSITION_UNAVAILABLEを渡す）。

エラーでコールバックするよう指示された場合、 PositionErrorCallback? callbackと unsigned short codeを受け取ります：

1. callbackがnullの場合、何もせず戻る。
2. errorを新しく作成し、 GeolocationPositionErrorインスタンスで code属性をcodeで初期化する。
3. タスクをキューに追加し、 geolocation task sourceで callback（« error »と"report"）を呼び出す。

enableHighAccuracy メンバーは、 アプリケーションができるだけ正確な位置情報を受け取りたいというヒントを実装に伝えます。 このメンバーの目的は、アプリケーションが高精度のジオロケーション修正を必要としないことを実装に知らせ、 実装が多くの電力を消費する位置情報プロバイダー（例：GPS）の使用を避けてもよいようにすることです。

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

maximumAgeメンバーは、Webアプリが指定したミリ秒以内のキャッシュ位置を受け入れる意思があることを示します。

coords 属性は地理座標を保持します。

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

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

GeolocationPositionError のインスタンスは 以下の表の内部スロットで生成されます：

この仕様で次の タスクソース を定義します。

geolocation task source

本仕様は、非同期で PositionCallback および PositionErrorCallback を 位置リクエストの際にキューに登録するために使用します。

The latitude and longitude attributes are geographic coordinates specified in decimal degrees. latitude属性とlongitude属性は、[WGS84] 座標系における度の実数で位置を示します。 accuracy 属性は位置精度の半径（メートル単位）を示します。

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

altitudeAccuracy属性は、高度の精度（メートル単位、例：10メートル）を示します。

heading属性はホストデバイスの進行方向を度単位で示し、0° ≤ heading < 360°、真北を基準に時計回りです。

speed属性は、ホストデバイスの現在の速度の水平成分の大きさ（メートル/秒）を示します。

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

PERMISSION_DENIED (数値 1)

位置リクエストが、ユーザーがAPI利用を拒否したため、または 非セキュアなコンテキストからリクエストされたため失敗した。

POSITION_UNAVAILABLE (数値 2)

位置取得に失敗した。

TIMEOUT (数値 3)

timeout メンバーで指定された時間内に、ユーザーエージェントが正常に 位置取得できなかった。

code 属性は、初期化時に設定された値を返します（可能な値は 10.1 定数 を参照）。

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