diff --git a/index.html b/index.html index 40ca33b..47bb80e 100644 --- a/index.html +++ b/index.html @@ -35,9 +35,9 @@ }, ], group: [ "das", "webapps" ], - previousPublishDate: "2022-02-17", - crEnd: "2022-03-18", - previousMaturity: "CR", + previousPublishDate: "2025-12-12", + crEnd: "2026-03-18", + previousMaturity: "REC", github: "w3c/geolocation", caniuse: "geolocation", testSuiteURI: "https://wpt.live/geolocation/", @@ -56,27 +56,7 @@ associated with the hosting device.

-
- -

- Since this specification become a W3C Recommendation on 01 September - 2022, the following substantive additions and/or corrections have been - proposed: -

-

- A more detailed list of changes can be found in section - [[[#changelog]]]. Reviewers of the document can identify candidate - additions and/or corrections by their distinctive styling in the - document. -

-
+

Introduction @@ -580,16 +560,8 @@

method steps are:

    -
  1. - If the [=current settings object=]'s - [=relevant global object=]'s [=associated `Document`=] is not - [=Document/fully active=]: If [=this=]'s - [=relevant global object=]'s [=associated `Document`=] is not - [=Document/fully active=]: +
  2. If [=this=]'s [=relevant global object=]'s [=associated + `Document`=] is not [=Document/fully active=]:
    1. [=Call back with error=] |errorCallback| and {{GeolocationPositionError/POSITION_UNAVAILABLE}}. @@ -614,16 +586,8 @@

      method steps are:

        -
      1. - If the [=current settings object=]'s - [=relevant global object=]'s [=associated `Document`=] is not - [=Document/fully active=]: If [=this=]'s - [=relevant global object=]'s [=associated `Document`=] is not - [=Document/fully active=]: +
      2. If [=this=]'s [=relevant global object=]'s [=associated + `Document`=] is not [=Document/fully active=]:
        1. [=Call back with error=] passing |errorCallback| and {{GeolocationPositionError/POSITION_UNAVAILABLE}}. @@ -689,12 +653,8 @@

      3. -
      4. - If |geolocation|'s [=environment settings - object=] is a [=non-secure context=]: +
      5. If |geolocation|'s [=environment settings object=] is a + [=non-secure context=]:
        1. If |watchId| was passed, [=List/remove=] |watchId| from |watchIDs|. @@ -704,7 +664,7 @@

        2. Terminate this algorithm.
        3. -
        +

    2. If |document:Document|'s [=Document/visibility state=] is "hidden", wait for the following [=page visibility change steps=] to @@ -868,20 +828,11 @@

      value of the |options|.{{PositionOptions/maximumAge}} member.

    3. -
    4. - If |cachedPosition|'s - {{GeolocationPosition/timestamp}}'s value is greater - than |cacheTime|, and - |cachedPosition|.{{GeolocationPosition/[[isHighAccuracy]]}} - equals - |options|.{{PositionOptions/enableHighAccuracy}}, - set |position| to |cachedPosition|. : +
    5. If |cachedPosition|'s + {{GeolocationPosition/timestamp}}'s value is greater than + |cacheTime|, and + |cachedPosition|.{{GeolocationPosition/[[isHighAccuracy]]}} + equals |options|.{{PositionOptions/enableHighAccuracy}}:
      1. [=Queue a task=] on the [=geolocation task source=] with a step that [=invokes=] @@ -890,7 +841,7 @@

      2. Terminate this algorithm.
      3. -
      +
@@ -914,16 +865,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: @@ -993,16 +934,7 @@

    2. Set [=this=]'s {{Geolocation/[[cachedPosition]]}} to |position|.
    3. -

    -
      -
    1. Set |position| to [=a new `GeolocationPosition`=] - passing |acquisitionTime| and - |options|.{{PositionOptions/enableHighAccuracy}}. -
    2. -
    3. Set [=this=]'s {{Geolocation/[[cachedPosition]]}} to - |position|. -
    4. -
    +
  • Stop the |timeout|.
  • @@ -1184,15 +1116,9 @@

    `toJSON()` method

    -

    - The toJSON() method returns a JSON - representation of the {{GeolocationPosition}} object. + The toJSON() method returns a JSON representation of the + {{GeolocationPosition}} object.

    @@ -1264,26 +1190,11 @@

    `latitude`, `longitude`, and `accuracy` attributes

    - -

    - The latitude and - longitude attributes are geographic coordinates - specified in decimal degrees. The - latitude and longitude attributes denote the - position, specified as a real number of degrees, in the [[WGS84]] - coordinate system. The accuracy - attribute denotes the position accuracy radius in meters. + The latitude and longitude attributes denote + the position, specified as a real number of degrees, in the [[WGS84]] + coordinate system. The accuracy attribute denotes the + position accuracy radius in meters.

    @@ -1323,27 +1234,15 @@

    `toJSON()` method

    -

    - The toJSON() method returns a JSON - representation of the {{GeolocationCoordinates}} object. + The toJSON() method returns a JSON representation of the + {{GeolocationCoordinates}} object.

    Constructing a `GeolocationPosition`

    -

    A new `GeolocationPosition` is constructed with [=map=] |positionData|, {{EpochTimeStamp}} |timestamp:EpochTimeStamp| and @@ -1365,58 +1264,7 @@

    |timestamp|, and its {{GeolocationPosition/[[isHighAccuracy]]}} internal slot set to |isHighAccuracy|. - -

    - A new `GeolocationPosition` is constructed with - {{EpochTimeStamp}} |timestamp:EpochTimeStamp| and boolean - |isHighAccuracy| by performing the following steps: -

    -
      -
    1. Let |coords:GeolocationCoordinates| be a newly created - {{GeolocationCoordinates}} instance: -
        -
      1. Initialize |coord|'s {{GeolocationCoordinates/latitude}} - attribute to a geographic coordinate in decimal degrees. -
      2. -
      3. Initialize |coord|'s {{GeolocationCoordinates/longitude}} - attribute to a geographic coordinate in decimal degrees. -
      4. -
      5. Initialize |coord|'s {{GeolocationCoordinates/accuracy}} - attribute to a non-negative real number. The value SHOULD - correspond to a 95% confidence level with respect to the - longitude and latitude values. -
      6. -
      7. Initialize |coord|'s {{GeolocationCoordinates/altitude}} - attribute in meters above the [[WGS84]] ellipsoid, or `null` if - the implementation cannot provide altitude information. -
      8. -
      9. Initialize |coord|'s - {{GeolocationCoordinates/altitudeAccuracy}} attribute as - non-negative real number, or to `null` if the implementation - cannot provide altitude information. If the altitude accuracy - information is provided, it SHOULD correspond to a 95% confidence - level. -
      10. -
      11. Initialize |coord|'s {{GeolocationCoordinates/speed}} - attribute to a non-negative real number, or as `null` if the - implementation cannot provide speed information. -
      12. -
      13. Initialize |coord|'s {{GeolocationCoordinates/heading}} - attribute in degrees, or `null` if the implementation cannot - provide heading information. If the hosting device is stationary - (i.e., the value of the {{GeolocationCoordinates/speed}} - attribute is 0), then initialize the - {{GeolocationCoordinates/heading}} to `NaN`. -
      14. -
      -
    2. -
    3. Return a newly created {{GeolocationPosition}} instance with its - {{GeolocationPosition/coords}} attribute initialized to |coords| and - {{GeolocationPosition/timestamp}} attribute initialized to - |timestamp|, and its {{GeolocationPosition/[[isHighAccuracy]]}} - internal slot set to |isHighAccuracy|. -
    4. -
    +

    PERMISSION_DENIED (numeric value 1)
    - [=Request a position=] failed because the user denied - permission to use the API or the request was made - from an [=non-secure context=]. + [=Request a position=] failed because the user denied permission to + use the API or the request was made from an [=non-secure context=].
    POSITION_UNAVAILABLE (numeric value 2) @@ -1596,10 +1438,6 @@

    Change log

    -

    - Since First Public Working Draft in 2021, Geolocation has - received the following normative changes: -

    +

    + Since the previous publication of this specification as a + Recommendation in 2022, the following changes have been made: +

    +

    + Since First Public Working Draft in 2021, Geolocation has + received the following normative changes: +

    Since publication of the Second Edition in 2016, this specification