HTML5 PositionError

The PositionError is reflecting the reason for the failure.

Learning Resources:

Sample - Using HTML5 Geolocation Sample that demonstrates how to use the HTML5 Geolocation API [BlackBerry Developer Resource Center].
How To - Enable GPS on PlayBook How to enable GPS capability when using the BlackBerry WebWorks SDK for Tablet OS [BlackBerry Developer Resource Center].

Supported Platform(s)

- BlackBerry OS 5.0+
- BlackBerry PlayBook
- Ripple Emulator

View Supported Platform Table

APIOS 5.0OS 6.0OS 7.0PlayBookRipple
code Y Y Y YY
message Y Y Y YY
PERMISSION_DENIED Y Y Y YY
POSITION_UNAVAILABLE Y Y Y YY
TIMEOUT Y Y Y YY

Configuration Document Settings

To use all of the API described for this object, you must ensure the following settings are in your configuration document:

This API does not require a <feature> element to be declared in the configuration document of your BlackBerry WebWorks Application.

Permission Elements (PlayBook Only)
This API does not require a <permission> element to be declared in the configuration document of your BlackBerry WebWorks Application.

API Summary


Properties


Properties:


Property Type Description Supported Platform(s)
code Number Error code. One of the PERMISSION_DENIED, POSITION_UNAVAILABLE or TIMEOUT
 - BlackBerry OS 5.0+
 - BlackBerry PlayBook
 - Ripple Emulator
message String Error message describing the details of the error encountered.
 - BlackBerry OS 5.0+
 - BlackBerry PlayBook
 - Ripple Emulator

Constants:


Property Type Description Supported Platform(s)
PERMISSION_DENIED default: 1 Number The location acquisition process failed because the document does not have permission to use the Geolocation API.
 - BlackBerry OS 5.0+
 - BlackBerry PlayBook
 - Ripple Emulator
POSITION_UNAVAILABLE default: 2 Number The position of the device could not be determined.
 - BlackBerry OS 5.0+
 - BlackBerry PlayBook
 - Ripple Emulator
TIMEOUT default: 3 Number The length of time specified by the PositionOptions.timeout property has elapsed.
 - BlackBerry OS 5.0+
 - BlackBerry PlayBook
 - Ripple Emulator

Documentation generated by JsDoc Toolkit 2.4.0 on Sun Dec 30 2012 13:31:19 GMT-0500 (EST)