W3C home > Mailing lists > Public > public-geolocation@w3.org > June 2009

WebIDL, optional attributes

From: Marcin Hanclik <Marcin.Hanclik@access-company.com>
Date: Wed, 10 Jun 2009 11:40:16 +0200
To: public-geolocation <public-geolocation@w3.org>
Message-ID: <FAA1D89C5BAF1142A74AF116630A9F2C2890AF7869@OBEEX01.obe.access-company.com>
Hi Andrei,

A couple of editorial suggestions:

WebIDL:
a)The definition of the Geolocation interface could be shortened based on the WebIDL spec:

interface Geolocation {
    void getCurrentPosition(in PositionCallback successCallback, [Optional] in PositionErrorCallback errorCallback, [Optional] in PositionOptions options);

    int watchPosition(in PositionCallback successCallback, [Optional] in PositionErrorCallback errorCallback, in [Optional] PositionOptions options);

    void clearWatch(in int watchId);
  };

b) interface Coordinates uses type "double".
WebIDL does not know this type. Could we use "float"?
Or if we need more precision maybe {long, long} (a new interface) should be used?

Optional attributes:
The word "optional" has two meanings in the spec:
1. "The coords attribute contains a set of geographic coordinates together with their associated accuracy, as well as a set of other optional attributes such as altitude and speed."
"The altitude attribute denotes the height of the position, specified in meters above the [WGS84] ellipsoid. If the implementation cannot provide altitude information, the value of this attribute must be null."
"The speed attribute denotes the current ground speed of the hosting device and is specified in meters per second. If the implementation cannot provide speed information, the value of this attribute must be null."
This is ok. "Optional" means that the value is to be set to null by the implementation.

2. "The enableHighAccuracy, timeout and maximumAge attributes are all optional."
PositionOptions is used as associative array (NoInterfaceObject) that is specified by the JS developer.

I think that the statement "... are all optional" could get more clarification since the meaning of "optional" is different here.

Thanks.

Kind regards,
Marcin

Marcin Hanclik
ACCESS Systems Germany GmbH
Tel: +49-208-8290-6452  |  Fax: +49-208-8290-6465
Mobile: +49-163-8290-646
E-Mail: marcin.hanclik@access-company.com


________________________________________

Access Systems Germany GmbH
Essener Strasse 5  |  D-46047 Oberhausen
HRB 13548 Amtsgericht Duisburg
Geschaeftsfuehrer: Michel Piquemal, Tomonori Watanabe, Yusuke Kanda

www.access-company.com

CONFIDENTIALITY NOTICE
This e-mail and any attachments hereto may contain information that is privileged or confidential, and is intended for use only by the
individual or entity to which it is addressed. Any disclosure, copying or distribution of the information by anyone else is strictly prohibited.
If you have received this document in error, please notify us promptly by responding to this e-mail. Thank you.
Received on Wednesday, 10 June 2009 09:40:57 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:50:56 UTC