地理位置

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 为一个 实现定义的 unsigned long，其值大于 0。
3. 将 watchId 附加到 this 的 [[watchIDs]]。
4. 请求位置，传递 this，successCallback， errorCallback，options，以及 watchId。
5. 返回 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. 将 position 设置为 null。
      2. 如果 cachedPosition 不为 null，且 options 的 maximumAge 大于 0：
         1. 将 cacheTime 设置为 acquisitionTime 减去 options 的 maximumAge 成员的值。
         2. 如果 cachedPosition 的 timestamp 的值大于 cacheTime，且 cachedPosition 的[[isHighAccuracy]] 等于 options 的 enableHighAccuracy， 将 position 设置为 cachedPosition。 :
            1. 在地理定位任务源上排队一个任务， 其步骤是调用 successCallback 并传递 « cachedPosition » 和 "report"。
            2. 终止该算法。
      3. 否则，如果 position 不为 cachedPosition，则尝试从底层系统获取位置信息，选择性地考虑 options 的enableHighAccuracy 值在获取过程中。
      4. 如果在获取过程中 timeout 到期或获取设备位置信息失败：
         1. 停止 timeout。
         2. 转到处理失败。
         3. 终止该算法。
      5. 如果从系统获取位置信息成功：
         1. 将 positionData 设置为根据获取的位置信息数据创建的一个有序映射，其包含以下名称/值对：

            "longitude"

            一个double， 表示地球表面的经度坐标，以度为单位，使用 [WGS84] 坐标系统。 经度衡量一个点距离本初子午线的远近。

            "altitude"

            一个double?， 表示海拔高度，以米为单位，参考 [WGS84] 椭球，或如果不可用则为 null。 海拔高度衡量海平面以上的高度。

            "accuracy"

            一个非负的double， 表示以米为单位的 95% 置信度的精度值。精度衡量测得的坐标与真实位置的接近程度。

            "altitudeAccuracy"

            一个非负的double?， 表示海拔高度的精度，或如果不可用则为 null，以米为单位，表示 95% 的置信度。 海拔精度衡量测得的海拔高度与真实海拔的接近程度。

            "speed"

            一个非负的double?， 表示速度，以米每秒为单位，或如果不可用则为 null。速度衡量设备的移动速度。

            "heading"

            一个double?， 表示航向，以度为单位，或如果不可用或设备静止不动则为 null。航向衡量设备相对于真北的移动方向。

         2. 将 position 设置为一个新的 GeolocationPosition，传递 positionData，acquisitionTime 和 options 的enableHighAccuracy。
         3. 将 this 的 [[cachedPosition]] 设置为 position。
         1. 将 position 设置为新的 GeolocationPosition，传递 acquisitionTime 和 options。enableHighAccuracy。
         2. 将 当前对象的[[cachedPosition]] 设置为 position。
      6. 停止 timeout。
      7. 在地理定位任务源上排队一个任务， 其步骤是调用successCallback 并传递 « position » 和 "report"。

   处理失败：

   • 如果获取位置失败，则根据匹配失败的条件执行以下操作之一：

     用户或系统拒绝权限：

     调用错误回调，传递 errorCallback 和 PERMISSION_DENIED。

     注意: 浏览器权限 VS 操作系统权限

     超时已到：

     调用错误回调，传递 errorCallback 和 TIMEOUT。

     数据获取错误或任何其他原因：

     调用错误回调，传递 errorCallback 和 POSITION_UNAVAILABLE。

当被指示 调用错误回调 时，给定一个 PositionErrorCallback? callback 和一个 unsigned short code：

1. 如果 callback 为 null，返回。
2. 让 error 成为一个新创建的 GeolocationPositionError 实例， 其 code 属性初始化为 code。
3. 在 地理定位任务源 上 排队一个任务，该任务包含一个步骤， 该步骤将 callback 与 « error » 和 "report" 一起 调用。

enableHighAccuracy 成员提供了一个提示， 表示应用程序希望接收最准确的位置信息。 该成员的预期用途是允许应用程序通知实现它们不需要高精度的地理位置数据，因此实现 可以 避免使用消耗大量电力的地理定位提供商 （例如 GPS）。

timeout 成员表示在获取位置超时前的最大时间， 以毫秒为单位。

maximumAge 成员指示 Web 应用程序愿意接受的缓存位置的最大时间， 以毫秒为单位。

coords 属性包含地理坐标信息。

timestamp 属性表示设备获取地理位置的时间。

toJSON() 方法返回 GeolocationPosition 对象的 JSON 表示。

实例 GeolocationPositionError 具有以下表中所示的内部槽：

本规范定义了以下 任务源。

geolocation 任务源

本规范用于在执行 位置请求时， 排队处理非阻塞的 PositionCallback 和 PositionErrorCallback。

属性 latitude 和 longitude 是以十进制度数表示的地理坐标。 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)

用户代理在指定的时间内未能成功 获取位置，超时。

code 属性返回其被初始化时的值（见10.1 常量了解可能的值）。

message 属性是关于 code 属性的开发者友好型文本描述。