Get Coordinate String From Coordinates Activity

Description

The Get Coordinate 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.

Requires ArcGIS Server 10.3+.

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 Get Geocoordinate String From Coordinates activity to display the current position to the user in an Alert activity.

Offline Support

This activity does not work when the device is offline.

Inputs

Url

Required

Type: String

The URL of the ArcGIS geometry service.

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

Requires ArcGIS Server 10.3+.

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 defaults to 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.

* 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.

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.

Version Information

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

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.11