Geotrack

Table of Contents

Overview

Since 4.0
Until 4.2

As of January of 2017 the BridgeIt project has been deprecated. As a result, this component has been removed from ICEfaces as of the 4.2 release.

The mobi:geotrack component renders a button that launches the Bridgeit application on the user's device to take initiate geotracking through the device's GPS. After this is initiated, Bridgeit will periodically send geoJSON data to the server, containing the user's current location and other data.

Getting Started

To start using the GeoTrack component, simply place the mobi:geoTrack tag inside a form and bind the value to a backing bean property. Note that only application-scoped beans are supported for this component.

<h:form>
	<mobi:geoTrack 
		buttonLabel="Start GeoTracking"
		strategy="continuous"
		publish="#{applicationScopedBean.data}"
		parameters="_userId: '#{bean.randomId}'" />
</h:form>

Attributes

TagLib Documentation
This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available here.

The buttonLabel specifies the label of the button.

The strategy can either be 'continuous', 'significant' or 'stop'. When 'continuous', the location of the device will be uploaded as frequently as it changes, and when 'significant' the location is uploaded when it changes significantly. Use 'stop' to cease location tracking.

The duration attribute specifies the amount of time the geotracking will run for, expressed in hours.

The publish attribute is used to specify the application-scoped bean property where the geoJSON data and other parameters will be published to.

The parameters is used to specify custom parameters that will be echoed by Bridgeit whenever it sends geotracking data to the server. These parameters can be used to identify individual users, pages, etc. The parameters must be in correct JSON format (without the opening/closing brackets), and the names should always start with the underscore character (e.g. "_viewId: '/geotracking.jsf', _userId: '001'").

Event Listeners

None.

Client Behavior Events

None.

JavaScript API

None.

Keyboard Support

Standard keyboard actions for HTML buttons are supported, such as tabindex and pressing the enter or space keys to activate the button.

Known Issues

None.

Additional Resources

Sample Applications

This component appears in the following ICEfaces sample applications:

Tutorials

This component appears in the following ICEfaces tutorials:

None

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

© Copyright 2018 ICEsoft Technologies Canada Corp.