Show / Hide Table of Contents

Method FromUsng

FromUsng(String, SpatialReference)

Parses a coordinate in United States National Grid (USNG) notation and returns a MapPoint representing that location.

Declaration
public static MapPoint FromUsng(string coordinates, SpatialReference spatialReference)
Parameters
Type Name Description
System.String coordinates

The USNG notation string for the coordinate.

SpatialReference spatialReference

An optional SpatialReference that defines the datum and ellipsoid referenced by the USNG coordinate.

Returns
Type Description
MapPoint

A MapPoint with the location from the USNG string in the spatial reference provided.

Remarks

The provided spatialReference parameter must have an ellipsoid and datum matching those used by the source of the USNG string. If no SpatialReference is provided and the USNG string is suffixed with "(NAD 27)", it is assumed the USNG string is referenced to NAD 27. If no spatial reference is provided and no such suffix exists, it is assumed the USNG string is referenced to Wgs84. The USNG string can contain leading and trailing whitespace and can have whitespace between the grid zone designator, the 100km square identifier, and the numerical eastings and northings.

USNG notation examples
13TFJ 23 59
13TFJ2374159574

Exceptions
Type Condition
System.ArgumentException

coordinates is null.

ArcGISRuntimeException

Given coordinates could not be parsed or converted.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.3 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.1 - 200.7
Xamarin.Android100.1 - 100.15
Xamarin.iOS100.1 - 100.15
UWP100.1 - 200.7
Relevant samples
Format coordinates: Format coordinates in a variety of common notations.
In This Article
Back to top Copyright © 2022 Esri.