diff --git a/index.html b/index.html index e34011b..9a924f9 100644 --- a/index.html +++ b/index.html @@ -129,8 +129,8 @@
+ The Geolocation API is a [=default powerful feature=]. +
++ When checking permission + to use the API, a user agent MAY suggest time-based [=permission=] + [=permission/lifetimes=], such as "24 hours", "1 week", or choose to + remember the permission [=permission/grant=] indefinitely. However, + it is RECOMMENDED that a user agent prioritize restricting the + [=permission=] [=permission/lifetime=] to a single session: This can + be, for example, until the [=environment settings object/realm=] is + destroyed, the end-user [=navigates=] away from the [=origin=], or + the relevant browser tab is closed. +
+The getCurrentPosition(|successCallback:PositionCallback|, - |errorCallback:PositionErrorCallback|, |options:PositionOptions|) + |errorCallback:PositionErrorCallback?|, |options:PositionOptions|) method steps are:
The watchPosition(|successCallback:PositionCallback|, - |errorCallback:PositionErrorCallback|, |options:PositionOptions|) + |errorCallback:PositionErrorCallback?|, |options:PositionOptions|) method steps are:
- Request position by passing a {{PositionCallback}} - |successCallback:PositionCallback|, a {{PositionErrorCallback}}`?` - |errorCallback:PositionErrorCallback|, {{PositionOptions}} - |options:PositionOptions|, a {{boolean}} |repeats:boolean|, and - optionally (and only if |repeats| is true) a |previousId:long|. + To request a position, pass a {{PositionCallback}} + |successCallback:PositionCallback|, a {{PositionErrorCallback?}} + |errorCallback:PositionErrorCallback?|, {{PositionOptions}} + |options:PositionOptions|, and an optional |watchId:unsigned long|:
- [=Call back with error=] passing |errorCallback| - and - {{GeolocationPositionError/PERMISSION_DENIED}}. -
- -- The Geolocation API is a [=default powerful feature=]. -
-- The user agent MAY suggest time-based [=permission=] - [=permission/lifetimes=], such as "24 hours", "1 week", or choose to - remember the permission [permission/grant=] indefinitely. However, it - is RECOMMENDED that a user agent prioritize restricting the - [=permission=] [=permission/lifetime=] to a single session: This can - be, for example, until the [=environment settings object/realm=] is - destroyed, the end-user [=navigates=] away from the [=origin=], or - the relevant browser tab is closed. -
-- When instructed to check permission, given a - {{PositionErrorCallback}}`?` |errorCallback:PositionErrorCallback|: + To acquire a position, + passing {{PositionCallback}} |successCallback:PositionCallback|, a + {{PositionErrorCallback?}} |errorCallback:PositionErrorCallback?|, + {{PositionOptions}} |options:PositionOptions|, and an optional + |watchId:unsigned long|.
+ [=Call back with error=] passing |errorCallback| and + {{GeolocationPositionError/PERMISSION_DENIED}}. +
+ +When instructed to call back with error, given an - {{PositionErrorCallback}}`?` |callback:PositionErrorCallback| and an + {{PositionErrorCallback?}} |callback:PositionErrorCallback?| and an {{unsigned short}} |code:unsigned short|:
+
The time spent waiting for the document to become visible and for [=check permission|obtaining permission to use the API=] is not included in the period covered by the {{PositionOptions/timeout}} member. The {{PositionOptions/timeout}} member only applies when [=acquiring a position=] begins.
+