Get Current Position Activity

Description

The Get Current Position activity gets the current position of the device running the workflow.

Usage

You may need to get the current location of the user. You could get the user's current position using the Get Current Position activity then use the Set Map Extent activity to center the map on the user's location.

Offline Support

This activity works when the device is offline.

Inputs

Enable High Accuracy

Optional

Type: Boolean

Whether to request the best possible location data.

Maximum Age

Optional

Type: Number

The maximum age (in milliseconds) of a cached position that will be accepted.

If not specified, the activity obtains a fresh location.

Timeout

Optional

Type: Number

The amount of time (in milliseconds) to wait for a location.

The default is 20000 (20 seconds).

Use Multiple Readings

Optional

Type: Boolean

Whether to use multiple readings to improve the accuracy of the geolocation result.

Accuracy Threshold

Optional

Type: Number

The device-reported accuracy in meters that must be reached before a reading is considered valid. This value is only used when Use Multiple Readings is true.

The default is 10 meters.

If the Timeout is reached before a valid reading is obtained, the best reading obtained prior to the Timeout is provided.

Outputs

position

Type: esri.Point (3.x, 4.x)*

The position in WGS84.

accuracy

Type: Number

Represents the accuracy of the latitude and longitude properties, expressed in meters.

altitude

Type: Number

Represents the position's altitude in metres, relative to sea level.

This value can be Null if the implementation cannot provide the data.

altitudeAccuracy

Type: Number

Represents the position's altitude in metres, relative to sea level.

This value can be Null if the implementation cannot provide the data.

heading

Type: Number

Represents the direction in which the device is traveling.

This value, specified in degrees, indicates how far off from heading true north the device is.

If the device is unable to provide heading information, this value is Null.

latitude

Type: Number

Represents the position's latitude in decimal degrees.

longitude

Type: Number

Represents the position's longitude in decimal degrees.

speed

Type: Number

Represents the velocity of the device in meters per second.

This value can be Null.

timestamp

Type: [Number

Represents the time (in Unix Epoch milliseconds) at which the location was retrieved.

errorCode

Type: Number

Represents the reason of an error occurring when using the geolocating device.

This value will be defined if there was an error.

errorMessage

Type: String

Represents the reason of an error occurring when using the geolocating device. This value will be defined if there was an error.

* Geocortex Workflow uses different versions of Esri's ArcGIS API for JavaScript depending on the type of application. Web AppBuilder 2D apps and Geocortex HTML5 viewers use version 3.x of the JavaScript API. Web AppBuilder 3D apps use version 4.x.

Properties

For information about the ID, Display Name, and Description properties, see Properties Common to all Activities.

Version Information

Supported from: Geocortex Viewer for HTML5 2.9, Web AppBuilder for ArcGIS 2.4.

© 2018 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.9