Find Nearby Weather Stations (by Coordinates or Station ID)

{
  "type": "object",
  "required": [
    "locations"
  ],
  "properties": {
    "locations": {
      "type": "string",
      "description": "JSON array of input location objects. Each object has either lat/lon (e.g. {\"lat\":51.5,\"lon\":-0.12}) or station_id (e.g. {\"station_id\":\"KJFK\"}). ICAO codes and PWS IDs are supported."
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius in kilometres. Stations beyond this distance are excluded."
    },
    "station_type": {
      "type": "string",
      "description": "Filter by station type. Set to 'official' to return only professionally operated stations (airport, METAR, SYNOP). When omitted, all station types are returned including personal weather stations."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "stations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The station or site's public name, e.g. 'Central Park', 'La Guardia Arpt.' -- a facility/place name, not a person's name."
              },
              "pws_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Set for personal-weather-station entries (mirrors station_id in that case); null for airport/METAR/buoy/cman entries."
              },
              "latitude": {
                "type": "number"
              },
              "icao_code": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Set for airport/METAR stations with an ICAO code; null otherwise."
              },
              "longitude": {
                "type": "number"
              },
              "station_id": {
                "type": "string",
                "description": "The station's own identifier: an ICAO code (e.g. 'KJFK'), a PWS house id (e.g. 'KNYNEWYO2008'), or a synthesized 'airport_<name>_<lat>_<lon>' string for unofficial airport-type entries with no ICAO code. Some PWS ids are digit-heavy and can superficially resemble a phone number, but every observed value is a device/site identifier assigned by the station network, not a person's contact number."
              },
              "distance_km": {
                "type": "number",
                "description": "Distance from the input location, in kilometres (tested only with a single-element `locations` array; multi-location behavior is unconfirmed)."
              },
              "near_inputs": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "distance_km": {
                      "type": "number"
                    },
                    "input_identifier": {
                      "type": "string",
                      "description": "Echoes the input location, e.g. '40.758,-73.9855'."
                    }
                  },
                  "additionalProperties": true
                },
                "description": "Which input location(s) this station is near, and at what distance."
              },
              "station_type": {
                "type": "string",
                "description": "Observed values: 'pws', 'airport', 'metar', 'buoy', 'cman'. Other values may exist (the source also documents 'official'/'synop' filtering) but have not been observed."
              }
            },
            "additionalProperties": true
          },
          "description": "Sorted by distance from the input location. Empty when nothing falls within the requested radius (e.g. a 5km radius over open Pacific ocean) -- not an error in that case."
        },
        "provenance": {
          "type": "object",
          "properties": {
            "complete": {
              "type": "boolean",
              "description": "False when the data source had a partial failure (e.g. a search over open ocean)."
            },
            "warnings": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Empty on a normal call; carries a warning string (e.g. a source 404 for a given product) on a degraded call, such as a search over open ocean."
            },
            "retrieved_at": {
              "type": "string",
              "description": "ISO 8601 UTC timestamp of the data fetch."
            },
            "data_source_note": {
              "type": "string",
              "description": "A fixed caveat string from the data source, typically identical across calls."
            },
            "source_product_name": {
              "type": "string",
              "description": "The upstream data product's own name, e.g. 'TWC Location Near API v3'."
            }
          },
          "description": "Metadata about the upstream fetch, not station data itself.",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed."
    }
  },
  "description": "The station search result.",
  "additionalProperties": true
}