ArcGIS REST API - ArcGIS Services - From GeoCoordinateString

URL:http://<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 xy-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	Description: (Optional) The response format. The default response format is html. Values: html \| json
sr	Description: 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. Valid conversion types are: 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. Valid conversion modes for MGRS are: 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. Valid conversion modes for UTM are: utmDefault - Default. No options. utmNorthSouth - Uses north/south latitude indicators instead of zone numbers. Non-standard. Default is recommended. Valid conversion modes for GARS are: 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 we convert three strings in the World Geographic Reference System (GeoRef) format to xy-coordinates.

http://<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 xy-coordinates.

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

JSON Response Example

The output from the above example is a JSON object containing a 3-element array of xy-coordinates.

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