ArcGIS REST API - ArcGIS Services - From GeoCoordinateString

URL:https://<geometry service url>/fromGeoCoordinateString
Related Resources:To GeoCoordinateString
Version Introduced:10.3

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


Parameter	Details
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
 ]
]}