Geolocation

Geolocation Interface (not included in alpha release)

Considerations

This feature is fully supported in iPhone Safari, but since this feature involves providing information about a user's location, it could be seen as a breach of privacy, so users must be aware that they are providing the information and be able to deny access to their location. If location is stored, then the user must be aware their location will be stored somewhere have the ability to remove their location information from stored information. Any stored location information must be secure. (this is all from W3C specifications and mostly will pertain to application developer's, but if we are creating a component for this feature, the application developer's must be able to use it according to these specifications).

API

1. getCurrentPosition() ->will not invoke successCallback without user permission.
   Will list this one first as this is the functionality required by current sample apps first being developed. When called, getCurrentPosition() must immediately return and (asynchronously) acquire a new

    Position interface includes Coordinates coords, DOMTimeStamp timestamp 

   
   object.

• successCallback(Position) gets invoked -> position.coords.latitude and position.coords.longitude objects which are geographic coordinates denoted in degrees (decimal).
  Coordinates (coords) interface that includes an accuracy attribute that is specified in meters. Do we want to build in conversion?
  Other attribites include altitude, altitude accuracy, heading (direction of travel of host/device in degrees from north and may return null if not found), speed (current ground speed in m/sec). Would have to check and see if native device supports these attributes first.
• errorCallback(PositionError) -> error.PERMISSION_DENIED, error.POSITION_UNAVAILABLE, error.TIMEOUT, as well as default (unknown error).
• PositionOptions interface -> boolean enableHighAccuracy, long timeout, long maximumAge; can be third argument in getCurrentPosition or watchPosition.