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.
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>
TagLib Documentation
This section covers attributes involved in the typical use-cases for this component.
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'").
None.
None.
None.
Standard keyboard actions for HTML buttons are supported, such as tabindex and pressing the enter or space keys to activate the button.
None.
This component appears in the following ICEfaces sample applications: