OPUS API distributes limited attributes from OPUS shared solutions.
A 6-character alphanumeric ID associated with a survey mark. One or more PIDs may be queried using a comma delimiter.
https://geodesy.noaa.gov/api/opus/pid?pid=BBBH86
https://geodesy.noaa.gov/api/opus/pid?pid=BBBH86,BBCH69
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
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
https://geodesy.noaa.gov/api/opus/radial?lat=40.0&lon=-80.0&radius=5.25
https://geodesy.noaa.gov/api/opus/radial?lat=40.0&lon=-80.0&radius=400&units=METER
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
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
Example: decimal degrees: -80.75 DMS format W0804500.0
Example: decimal degrees: -80.75 DMS format W0804500.0; maxlon > minlon
http://geodesy.noaa.gov/api/opus/bounds?minlat=40.0&minlon=-80.0&maxlat=40.01&maxlon=-79.9
Sample Response
{
"pid": "BBCH69",
"ts": "11115183347",
"designation": "HOWARD 2010",
"stCounty": "PA,Centre County",
"refFrame": "NAD_83(2011)",
"epoch": "2010.0000",
"lat": "41.0199440361",
"latDms": "N410111.79853",
"latP2p": "0.006",
"lon": "-77.6537193167",
"lonDms": "W0773913.38954",
"lonP2p": "0.001",
"ellHt": "169.764",
"ellHtP2p": "0.005",
"datum": "NAVD88 (Computed using GEOID12B)",
"orthoHt": "203.029",
"orthoHtP2p": "0.015",
"observed": "2010-11-23T13:24:00Z",
"agency": "US Army Corps of Engineers",
"monumentType": "Disk",
"stamping": "HOWARD 2010",
"stability": " Monument will probably hold position well",
"setting": " Light structures (other than listed below)",
"condition": "G"
}
This service returns PID, designation, lat-longs, and distance in meters of a nearest publishable point from a given lat-long. Lat-longs may be entered in decimal degrees, DMS, or mixed format.
Sample Response
{
"pid": "JV2187",
"lat": "39.1366666667",
"latDms": "N390812.00000",
"lon": "-77.1775000000",
"lonDms": "W0771039.00000",
"designation": "WASHINGTON GROVE BORR",
"distance": "72.256"
}
This service returns a country, state, and city for a given lat-long. Lat-longs may be entered in decimal degrees, DMS, or mixed format.
Sample Response
{
"country": "Canada",
"state": "Ontario",
"city": "Lake Ontario"
}
The following URL provides metadata for various parameters used in the JSON response: https://geodesy.noaa.gov/api/opus/meta