API for NGS Data Explorer

Purpose

This web service is designed to distribute limited attributes from publishable data sheets for varying types of survey control. The primary purpose of this web service is to provide location and metadata for the many survey control marks throughout the nation and territories.

Background

Text datasheets have been the primary means of getting detailed information on survey control in the past. Shapefiles and been created with a limited amount of important information from the datasheet to limit the file size. This web service provides an even smaller set of the attributes served up over the web. The best place to get comprehensive information will still be the text datasheet.

PID Service

Query Parameter

Description

pid *

A 6-character alphanumeric ID associated with a survey mark. One or more PIDs may be queried using a comma delimiter.

Example:

Single PID:

https://geodesy.noaa.gov/api/nde/pid?pid=AB1234

Multiple PIDs:

https://geodesy.noaa.gov/api/nde/pid?pid=AB1234,JV2187

Bounding Box Service

Query Parameter

Description

minlat *

Minimum latitude of the bounding box in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (N or S) and use DDDMMSS.ssssss format; decimal seconds are optional.

Example: decimal degrees: 40.75 DMS format N404500.0

maxlat *

Maximum latitude of the bounding box in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (N or S) and use DDMMSS.ssssss format; decimal seconds are optional.

Example: decimal degrees: 40.75 DMS format N404500.0; maxlat > minlat

minlon *

Minimum longitude of the bounding box in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (E or W) and use DDDMMSS.ssssss format; decimal seconds are optional. For decimal degrees, negative west longitude convention is used.

Example: decimal degrees: -80.75 DMS format W0804500.0

maxlon *

Maximum longitude in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (E or W) and use DDDMMSS.ssssss format; decimal seconds are optional. For decimal degrees, negative west longitude convention is used.

Example: decimal degrees: -80.75 DMS format W0804500.0; maxlon > minlon

Note: A maximum limit of 500 is set for the number of sets returned. Adjust the bounds accordingly so that a complete set is returned for the search.

Example:

http://geodesy.noaa.gov/api/nde/bounds?minlat=40.0&maxlat=N403030.0&minlon=W0800000.0&maxlon=-79.5

Radial Search Service

Query Parameter

Description

lat *

Latitude in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (N or S) and use DDMMSS.ssssss format; decimal seconds are optional.

Example: decimal degrees: 40.75 DMS format N404500.0

lon *

Longitude in decimal degrees or degrees-minutes-seconds(DMS) format; if DMS format is used, prefix the value with a hemisphere designator (E or W) and use DDDMMSS.ssssss format; decimal seconds are optional. For decimal degrees, negative west longitude convention is used.

Example: decimal degrees: -80.75 DMS format W0804500.0

radius *

Search radius, a numeric value

units

Units of radius; defaults to MILE, if not specified. Other units available for use are METER, KILOMETER, FOOT

Note: A maximum limit of 500 is set for the number of sets returned. Adjust the radius accordingly so that a complete set is returned for the search.

Where lat-longs are in decimal degrees, DMS, or mixed format. West longitudes are negative for decimal degrees. Units of radius is miles

Examples:

https://geodesy.noaa.gov/api/nde/radial?lat=40.0&lon=-80.0&radius=0.5

Using METER as units

https://geodesy.noaa.gov/api/nde/radial?lat=40.0&lon=-80.0&radius=400&units=METER

Sample Result Set:

{
"pid": "KX2493",
"name": "MR 63 LB",
"lat": "40.00258",
"lon": "-79.99739",
"ellipHeight": " ",
"posDatum": "NAD 83(1986)",
"posSource": "HD_HELD1",
"posOrder": " ",
"orthoHt": "239.017",
"vertDatum": "NAVD 88",
"vertSource": "ADJUSTED",
"vertOrder": "2"
}