Skip To Content
ArcGIS Developers
Dashboard

From GeoCoordinateString

Description

The fromGeoCoordinateString operation is performed on a geometry service resource. The operation converts an array of well-known strings into x,y coordinates based on the conversion type and spatial reference supplied by the user. An optional conversion mode parameter is available for some conversion types.

Request parameters

ParameterDetails
f

The response format. The default response format is html.
Values:   html | json

sr

The well-known ID of the spatial reference or a spatial reference json object. For a list of valid WKID values, see Projected coordinate Systems and Geographic coordinate Systems.

strings

An array of strings formatted as specified by conversionType.

Syntax: [<string1>,...,<stringN>]

Example: ["01N AA 66021 00000","11S NT 00000 62155","31U BT 94071 65288"]

conversionType

Description: The conversion type of the input strings.

The following are valid conversion types:

  • MGRS - Military Grid Reference System
  • USNG - United States National Grid
  • UTM - Universal Transverse Mercator
  • GeoRef - World Geographic Reference System
  • GARS - Global Area Reference System
  • DMS - Degree Minute Second
  • DDM - Degree Decimal Minute
  • DD - Decimal Degree
conversionMode

Description: (Optional) Conversion options for MGRS, UTM and GARS conversion types.

The following are valid conversion modes for MGRS:

  • mgrsDefault - Default. Uses the spheroid from the given spatial reference.
  • mgrsNewStyle - Treats all spheroids as new, like WGS 1984. The 180 degree longitude falls into Zone 60.
  • mgrsOldStyle - Treats all spheroids as old, like Bessel 1841. The 180 degree longitude falls into Zone 60.
  • mgrsNewWith180InZone01 - Same as mgrsNewStyle except the 180 degree longitude falls into Zone 01.
  • mgrsOldWith180InZone01 - Same as mgrsOldStyle except the 180 degree longitude falls into Zone 01.

The following are valid conversion modes for UTM:

  • utmDefault - Default. No options.
  • utmNorthSouth - Uses north/south latitude indicators instead of zone numbers. Non-standard. Default is recommended.

The following are valid conversion modes for GARS:

  • garsDefault - Default. Same as garsLowerLeft. Point at the lower left corner of the box.
  • garsLowerLeft - Point at the lower left corner of the box.
  • garsCenter - Point at the center of the box.

Example usage

In this example, three strings are converted in the World Geographic Reference System (GeoRef) format to x,y coordinates.

https://<geometry service url>/fromGeoCoordinateString?sr=4326&strings=["ZGQA5999999900000000","EJCE3864000012728040","NKBH1196052000273924" ]&conversionType=GeoRef

JSON Response syntax

The output is a JSON object containing an array of x,y coordinates.

{"coordinates":[[x1,y1],...,[xN,yN]]}

JSON Response example

The output from the above example is a JSON object containing a three-element array of x,y coordinates.

{"coordinates": [
 [
  179.99999998333334,
  0
 ],
 [
  -117.356,
  34.212134
 ],
 [
  1.199342,
  52.0045654
 ]
]}