BBjGeolocation

Description

In BBj 11.00 and higher, the BBjGeolocation object provides an interface to the browser's geolocation subsystem.

Creation

The BBjGeolocation object is accessed using the following BBjSysGui method:

Return Value	Method
BBjGeolocation	getGeolocation()

Methods of BBjGeolocation

Return Value	Method
void	clearCallback(int `eventType)`
void	getCurrentPosition()
double	getMaximumAge()
double	getTimeout()
boolean	isHighAccuracy()
void	setCallback(int `eventType`, String `gosubLabel`)
void	setCallback(int `eventType`, CustomObject `customObj`, String `methodName`)
void	setCallback(int `eventType`, Object `object`, String `methodName`)
void	setHighAccuracy(boolean `highAccuracy`)
void	setMaximumAge(double `seconds`)
void	setTimeout(double `seconds`)

Events

Callback Code	Object-oriented Event	Read Record Event	Code
ON_GEOLOCATION_POSITION	BBjGeolocationPositionEvent	Geolocation Event	G
ON_GEOLOCATION_WATCH	BBjGeolocationEvent	Geolocation Event	G

Geolocation watch events are automatically returned when the ON_GEOLOCATION_WATCH callback is registered. Geolocation position events are returned when the ON_GEOLOCATION_POSITION callback is registered, then getCurrentPosition() is invoked.

Remarks

Geolocation is only available in the BUI and DWC browser clients. Because of the sensitivity of location information, browsers only make it available in secure connections (HTTPS or localhost). Browsers explicitly request permission from the user to make location information available in the context of a specific web page. In clients other than BUI and DWC, BBjSysGui::getGeolocation() throws an error.

Example 1

rem ' Get the BBjGeolocation object

sysgui! = bbjapi().openSysGui("X0")
geolocation! = sysgui!.getGeolocation()