Stations
Was this helpful?
Was this helpful?
Was this helpful?
Get a list of the current GPS stations over the specified time period. The info is derived from https://www.ordnancesurvey.co.uk/documents/resources/osnet-coordinates-file.txt. Note that if the start and end date are omitted then the response will not contain the percentageComplete property.
Returns the list of stations, either as structured JSON data or a simple text file
Bad request
GET /positioning/osnet/v1/stations HTTP/1.1
Host: api.os.uk
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"stationId": "ABEP",
"stationName": "Aberporth",
"ETRS89_X": 3910361.3337,
"ETRS89_Y": -312649.7649,
"ETRS89_Z": 5012487.9118,
"ETRS89_Lat": "N 52 08 21.903992",
"ETRS89_Long": "W 004 34 16.727173",
"ETRS89_H": 188.467,
"OSGB36_E": 224134.523,
"OSGB36_N": 252130.77,
"ortho_h": 134.238,
"ortho_Datum": "Ordnance Datum Newlyn",
"tranModel": 15,
"percentageComplete": 1,
"distance": 12.34,
"links": [
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP",
"rel": "self",
"type": "application/json",
"title": "Self link",
"description": "This station"
},
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP/rinex",
"rel": "service-endpoint",
"type": "application/json",
"title": "Station data",
"description": "List the data available for this station"
},
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP/log",
"rel": "service-endpoint",
"type": "application/text",
"title": "Station log",
"description": "Link to the station log"
}
]
}
]Get an hour-by-hour breakdown of the OS Net network health for a specific date.
Date for the network health search. Please note that the date should be within the last 45 days.
2024-11-30Returns the network health for the given date. Each station in the network will be included in the response.
GET /positioning/osnet/v1/stations/health HTTP/1.1
Host: api.os.uk
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Returns the network health for the given date. Each station in the network will be included in the response.
[
{
"stationId": "ABEP",
"hourlyData": [
{
"hour": 1,
"percentageComplete": 1
}
]
}
]Get info on specified station over a specified time period. Note that if the start and end date are omitted then the response will not contain the percentageComplete property.
Specific station ID.
ABEPPattern: ^[a-zA-Z0-9]*$Returns info about the station, as structured JSON data
Bad request
Not Found
GET /positioning/osnet/v1/stations/{stationId} HTTP/1.1
Host: api.os.uk
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"stationId": "ABEP",
"stationName": "Aberporth",
"ETRS89_X": 3910361.3337,
"ETRS89_Y": -312649.7649,
"ETRS89_Z": 5012487.9118,
"ETRS89_Lat": "N 52 08 21.903992",
"ETRS89_Long": "W 004 34 16.727173",
"ETRS89_H": 188.467,
"OSGB36_E": 224134.523,
"OSGB36_N": 252130.77,
"ortho_h": 134.238,
"ortho_Datum": "Ordnance Datum Newlyn",
"tranModel": 15,
"percentageComplete": 1,
"distance": 12.34,
"links": [
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP",
"rel": "self",
"type": "application/json",
"title": "Self link",
"description": "This station"
},
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP/rinex",
"rel": "service-endpoint",
"type": "application/json",
"title": "Station data",
"description": "List the data available for this station"
},
{
"href": "https://api.os.uk/positioning/osnet/v1/stations/ABEP/log",
"rel": "service-endpoint",
"type": "application/text",
"title": "Station log",
"description": "Link to the station log"
}
]
}Get health information about a specific station
Specific station ID.
ABEPPattern: ^[a-zA-Z0-9]*$Returns the station health, on a day-by-day basis
GET /positioning/osnet/v1/stations/{stationId}/health HTTP/1.1
Host: api.os.uk
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Returns the station health, on a day-by-day basis
[
{
"date": "2024-11-30",
"hourlyData": [
{
"hour": 1,
"percentageComplete": 1
}
]
}
]Get logs for specified station
Specific station ID.
ABEPPattern: ^[a-zA-Z0-9]*$Returns the station logs
Bad request
Not Found
GET /positioning/osnet/v1/stations/{stationId}/log HTTP/1.1
Host: api.os.uk
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
text