API for U.S. National Grid (USNG) Service
Query Parameter
Description
USNG coordinate (one meter resolution; see below for a sample)
Datum of input coordinate;to be chosen from Regional Datums defined above, required for datum transformation and SPC; not required for coordinates outside the regions defined in Regional Datums
Datum of output coordinate;to be chosen from Regional Datums defined above,required for datum transformation and SPC;not required for coordinates outside the regions defined in Regional Datums
A 4-digit SPC zone to be used for SPC conversion, where applicable; SPC zone is automatically determined based on a given USNG; you may optionally override this by specifying your own 4-digit SPC zone
Equatorial radius in meters; needed for an international coordinate outside the regions defined above
Inverse of flattening; needed for an international coordinate outside the regions defined above
Ellipsoid height in meters; defaults to undefined if the parameter is not used. Combined factors and XYZ are not returned, if no height is specified
Geopotential Datum of input orthometric height; to be chosen from Regional Geopotential Datums defined above
Geopotential Datum of output orthometric height; to be chosen from Regional Geopotential Datums defined above
Orthometric height chosen for transformation
* Required Field
** Optional Field, to override defaults
Examples:
https://geodesy.noaa.gov/api/ncat/usng?usng=56HLH3436850935&a=6378160.0&invf=298.25
Sample Result Set
{
"ID": "1569252505661",
"nadconVersion": "5.0",
"vertconVersion": "3.0",
"srcDatum": "NAD83(2011)",
"destDatum": "NAD83(2011)",
"srcVertDatum": "NGVD29",
"destVertDatum": "NAVD88",
"srcLat": "40.0000000000",
"srcLatDms": "N400000.00000",
"destLat": "40.0000000000",
"destLatDms": "N400000.00000",
"sigLat": "0.000000",
"srcLon": "-80.0000000000",
"srcLonDms": "W0800000.00000",
"destLon": "-80.0000000000",
"destLonDms": "W0800000.00000",
"sigLon": "0.000000",
"srcEht": "N/A",
"destEht": "N/A",
"sigEht": "N/A",
"srcOrthoht": "20.000",
"destOrthoht": "19.848",
"sigOrthoht": "0.005",
"spcZone": "PA S-3702",
"spcNorthing_m": "76,470.584",
"spcEasting_m": "407,886.482",
"spcNorthing_usft": "250,887.243",
"spcEasting_usft": "1,338,207.567",
"spcNorthing_ift": "250,887.744",
"spcEasting_ift": "1,338,210.244",
"spcConvergence": "-01 27 35.22",
"spcScaleFactor": "0.99999024",
"spcCombinedFactor": "N/A",
"utmZone": "UTM Zone 17",
"utmNorthing": "4,428,236.065",
"utmEasting": "585,360.462",
"utmConvergence": "00 38 34.17",
"utmScaleFactor": "0.99968970",
"utmCombinedFactor": "N/A",
"x": "N/A",
"y": "N/A",
"z": "N/A",
"usng": "17TNE8536028236"
}
