W3C home > Mailing lists > Public > public-geolocation@w3.org > July 2008

RE: skeleton Geolocation API

From: Shyam Habarakada <shyamh@microsoft.com>
Date: Thu, 24 Jul 2008 00:07:38 -0700
To: Aaron Boodman <aa@google.com>
CC: Chris Prince <cprince@google.com>, Doug Turner <doug.turner@gmail.com>, "public-geolocation@w3c.org" <public-geolocation@w3c.org>, Alec Berntson <alecb@windows.microsoft.com>, Andrei Popescu <andreip@google.com>
Message-ID: <F2726D43C21D084F81F9C887BE881BD15514FA80C7@NA-EXMSG-C105.redmond.corp.microsoft.com>


    void getPosition(successCallback, [errorCallback [, positionOptions]]);
    int watchPosition(successCallback, [errorCallback [, positionOptions]]);

    successCallback is required and must be non-null (else the method will throw at runtime).
    errorCallback is optional and may be null.
    positionOptions is optional and may be null as well.

.. would be the most aesthetically pleasing [and clean] side of the bike shed :D

Let's hear what others have to say.

-----Original Message-----
From: Aaron Boodman [mailto:aa@google.com]
Sent: Wednesday, July 23, 2008 11:52 PM
To: Shyam Habarakada
Cc: Chris Prince; Doug Turner; public-geolocation@w3c.org; Alec Berntson; Andrei Popescu
Subject: Re: skeleton Geolocation API

On 7/23/08, Shyam Habarakada <shyamh@microsoft.com> wrote:
>  1. Are there use-case where errors SHOULD be ignored?

Should? No, but I can imagine use cases where a developer simply
doesn't care about errors and wants to ignore them. For example, say I
call watchPosition() to trace a user's position on a map. I might
implement it like this:

1. Show status UI telling the user we are looking for a fix, with a
button to cancel
2. Call watchPosition()
3. When we get the first fix, clear the status UI and update the position
4. For each new fix, update the position again

For this hypothetical usage, I don't really care about getting errors.

>  2. If we say errorCallback MUST be provided and a caller does not comply, what is the desired runtime behavior? Throw an exception?

Usually, if a parameter is required, then the behavior is to throw
when the function is called. That makes sense here too.

>  3. Are there error scenarios where we MUST signal the caller to invoke clearWatch(watchID)?

No. If the error is permanent, the implementation will just never call
either callback again.

- a
Received on Thursday, 24 July 2008 07:08:20 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:33:50 UTC