W3C Geolocation API Errata

interface Geolocation { 
   void getCurrentPosition(PositionCallback successCallback,
                           optional PositionErrorCallback errorCallback,
                           optional PositionOptions options);

   long watchPosition(PositionCallback successCallback,
                      optional PositionErrorCallback errorCallback,
                      optional PositionOptions options);

   void clearWatch(long watchId);
 };

WebIDL improvements

Given the evolution of WebIDL, the following changes would better match

1. the interface PositionOptions would be better written as a dictionary with default values matching the prose description of 5.2; the said prose can then be reduced
2. the interface Position would be better written as a dictionary
3. the interface Coordinates would be better written as a dictionary

Proposed correction:

1. The WebIDL declaration of PositionOptions should be changed to:

   dictionary PositionOptions {
       boolean enableHighAccuracy = false;
       [Clamp] unsigned long timeout = Infinity;
       long maximumAge = 0;
     };
   

   In 5.1, the pre-processing steps of getCurrentPosition and “watch process” are removed. In 5.2, the text describing the default values of enableHighAccuracy, timeout and maximumAge (paragraphs 5, 7 and 10 in that section) are removed.

2. Unclear yet
3. Unclear yet

Conformance requirements

1. The sentence starting with “Objects implementing the Navigator interface” is redundant with WebIDL and can be removed;
2. the getCurrentPosition and “watch process” algorithms are indicated as “should execute the following set of steps”; the steps in the algoritms are in fact mandatory.

Proposed corrections:

1. Remove second paragraph of section 5.1
2. Replace “should execute” with “must execute” in the getCurrentPosition and “watch process” algorithms

References

1. The list editors for the [BROWSINGCONTEXT] and [NAVIGATOR] references (linked to HTML5) is incorrect;
2. The full stop after the title of the URI spec should be moved before the space;
3. Instead of The DOMTimeStamp Type, a more useful reference is the one defined in WebIDL
4. RFC3066 is listed in the references, but not used in the specification, and should be removed