Get Geocoordinate String From Coordinates Activity

Description

The Get Geocoordinate String From Coordinates activity converts an array of XY-coordinates into well-known strings based on the conversion type and spatial reference supplied by the user.

Usage

You may need to convert coordinates to a geocoordinate string. You could get the user's current location, using the Get Current Position activity, then use the Get Geocoordinate String From Coordinates activity to display the current position to the user in an Alert activity.

Inputs

Url

Required

Type: String

The URL of the ArcGIS geometry service.

For example, https://utility.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer.

Spatial Reference

Optional

Type: String | Number | esri.SpatialReference (3.x, 4.x)*

The spatial reference (or WKID of the spatial reference) of the XY-coordinates to be converted.

Coordinates

Optional

Type: Number[][]

An array of XY-coordinates (in JSON format) to be converted.

Conversion Type

Optional

Type: "mgrs" | "usng" | "utm" | "geo-ref" | "gars" | "dms" | "ddm" | "dd" | String

The conversion type of the input strings.

Possible values: mgrs | usng | utm | geo-ref | gars | dms | ddm | dd.

Conversion Mode

Optional

Type: String

Conversion options for mgrs and utm conversion types.

Num Of Digits

Optional

Type: Number

The number of digits to output for each of the numerical portions of the string.

The default value depends on Conversion Type.

Rounding

Optional

Type: Boolean

If true, then numeric portions of the string are rounded to the nearest whole magnitude as specified by Num Of Digits.

Otherwise, numeric portions of the string are truncated.

The Rounding parameter applies only to conversion types mgrs, usng, and geo-ref.

The default is true.

Add Spaces

Optional

Type: Boolean

If true, then spaces are added between components of the string.

The Add Spaces parameter applies only to conversion types mgrs, usng, and utm.

The default value for mgrs is false, while the default value for both usng and utm is true.

* VertiGIS Studio Workflow uses different versions of Esri's ArcGIS API for JavaScript depending on the type of host application. See Underlying Technologies for information.

Outputs

strings

Type: String[]

The array of well-known geocoordinate strings.

Properties

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

Connectivity Requirements

This activity does not work when the device has intermittent connectivity to the network.

Version Information

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