# Nearby Weather Stations

The nearby endpoint enables users to find weather stations by geo location. When calling this endpoint make sure to provide valid geographic coordinates (decimal degrees) using the lat (latitude) and lon (longitude) parameters. The limit parameter allows us to specify the maximum number of weather stations returned by this endpoint.

By default, the endpoint only returns weather stations which are closer than 100 kilometers to the specified geo location. If you want to limit your query to a certain radius in kilometers, just set the radius parameter to any integer value.

# Endpoint

The endpoint is available through this URL:

GET https://api.meteostat.net/v2/stations/nearby

# Parameters

When calling this endpoint please refer to the following parameters.

Parameter Description Types Required Default
lat The latitude of the location Float Yes undefined
lon The longitude of the location Float Yes undefined
limit The maximum number of results Integer No 8
radius The radius of the query in kilometers Integer No 100

# Response

The response body includes the following properties.

Parameter Description Type
id The Meteostat ID of the weather station String
name Object containing the name of the weather stations in different languages Object
active A boolean value which is true if the weather station reported data within the previous 90 days Boolean
distance The distance to the geo location defined in the request Float

# Example

The following example returns the five closest weather stations to Singapore. It requires the cURL command-line interface. Alternatively, you can use an API client like Postman.

curl --header "x-api-key: {key}" "https://api.meteostat.net/v2/stations/nearby?lat=1.28&lon=103.83&limit=3"

Please replace {key} with your personal API key.

# Data Response

The response should look like that:

{
    "meta": {
        "exec_time": 0.022,
        "generated": "2020-06-12 12:24:59"
    },
    "data": [
        {
            "id": "48694",
            "name": {
                "en": "Singapore / Paya Lebar"
            },
            "active": true,
            "distance": 15.3
        },
        {
            "id": "48692",
            "name": {
                "en": "Singapore / Seletar"
            },
            "active": true,
            "distance": 18.4
        },
        {
            "id": "48698",
            "name": {
                "en": "Singapore / Changi Airport"
            },
            "active": true,
            "distance": 20.8
        }
    ]
}
Last Updated: 10/28/2020, 10:39:57 AM