ws-dottie
Version:
Your friendly TypeScript companion for Washington State transportation APIs - WSDOT and WSF data with smart caching and React Query integration
146 lines • 5.37 kB
JSON
{
"openapi": "3.0.0",
"info": {
"title": "Wsdot Weather Stations API",
"version": "1.0.0",
"description": "Wsdot Weather Stations API - Washington State Department of Transportation APIs"
},
"servers": [
{
"url": "https://wsdot.wa.gov/traffic/api/WeatherStations/WeatherStationsREST.svc",
"description": "Production server"
}
],
"components": {
"schemas": {
"RoadwayLocation": {
"type": "object",
"properties": {
"Description": {
"type": "string",
"nullable": true,
"description": "Human-readable description of the roadway location, such as interchange names or cross streets."
},
"Direction": {
"type": "string",
"nullable": true,
"description": "Traffic direction designation: N, S, B, NB, or SB, indicating which side of the highway is affected."
},
"Latitude": {
"type": "number",
"description": "Latitude of the roadway location in decimal degrees."
},
"Longitude": {
"type": "number",
"description": "Longitude of the roadway location in decimal degrees."
},
"MilePost": {
"type": "number",
"description": "Milepost marker along the highway corridor, with 0 indicating route terminus."
},
"RoadName": {
"type": "string",
"nullable": true,
"description": "Highway or route designation code, such as '005' for I-5 or '090' for I-90."
}
},
"required": [
"Description",
"Direction",
"Latitude",
"Longitude",
"MilePost",
"RoadName"
],
"description": "Roadway location information including route, milepost, coordinates, and direction."
}
},
"parameters": {}
},
"paths": {
"/GetCurrentStationsAsJson": {
"get": {
"summary": "List weather station metadata for all stations statewide.",
"operationId": "fetchWeatherStations",
"tags": [
"weather-stations"
],
"x-codeSamples": [
{
"lang": "JavaScript",
"source": "import { fetchWeatherStations } from 'ws-dottie/wsdot-weather-stations/core';\n\nconst data = await fetchWeatherStations({\n fetchMode: 'native',\n validate: true\n});\n\nconsole.log(data);"
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Latitude": {
"type": "number",
"description": "Latitude of the weather station in decimal degrees."
},
"Longitude": {
"type": "number",
"description": "Longitude of the weather station in decimal degrees."
},
"StationCode": {
"type": "integer",
"description": "Numeric ID of the weather station."
},
"StationName": {
"type": "string",
"nullable": true,
"description": "Display name of the weather station."
}
},
"required": [
"Latitude",
"Longitude",
"StationCode",
"StationName"
],
"description": "Weather station metadata including station identifier, name, and location coordinates for WSDOT Road Weather Information System stations."
}
},
"examples": {
"sampleResponse": {
"summary": "Sample response",
"description": "Example of a successful response from the API (showing first item of 131 total)",
"value": [
{
"Latitude": 47.4748,
"Longitude": -122.2704,
"StationCode": 1909,
"StationName": "S 144th St on SB I-5 at mp 155.32"
}
]
}
}
}
}
}
}
}
}
},
"tags": [
{
"name": "weather-stations",
"description": "Weather station metadata and location information for WSDOT Road Weather Information System stations statewide.",
"x-description": "Station identifiers, names, and location coordinates for weather stations that collect atmospheric and pavement condition data.",
"x-cacheStrategy": "FREQUENT",
"x-useCases": [
"Discover weather stations by location for weather data queries.",
"Identify station identifiers and names for weather data lookups.",
"Support location-based weather station searches."
],
"x-updateFrequency": "daily"
}
]
}