# Nearby Weather Stations

This endpoint enables users to find nearby 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, just set the radius parameter to any integer value.

# Endpoint

The endpoint is available through this URL:

GET https://meteostat.p.rapidapi.com/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 10
radius The radius of the query in meters Integer No 100000

# Response

The response body includes the following properties.

Parameter Description Type
id The Meteostat ID of the weather station String
name Name of the weather station in different languages Object
distance The distance to the provided geo location in meters Float

# Example

This example requires the cURL command-line interface. Alternatively, you can use an API client like Postman.

curl --request GET \
	--url 'https://meteostat.p.rapidapi.com/stations/nearby?lat=51.5085&lon=-0.1257&limit=5' \
	--header 'x-rapidapi-host: meteostat.p.rapidapi.com' \
	--header 'x-rapidapi-key: {key}'

Please replace {key} with your personal API key.

# Data Response

The response should look like that:

{
    "meta": {
        "exec_time": 0.172,
        "generated": "2021-06-23 18:36:46"
    },
    "data": [
        {
            "id": "03779",
            "name": {
                "en": "London Weather Centre"
            },
            "distance": 1104.3
        },
        {
            "id": "EGLC0",
            "name": {
                "en": "London / Abbey Wood"
            },
            "distance": 16804.1
        },
        {
            "id": "03672",
            "name": {
                "en": "Northolt"
            },
            "distance": 20652.3
        },
        {
            "id": "03772",
            "name": {
                "en": "London Heathrow Airport"
            },
            "distance": 22624.4
        },
        {
            "id": "03781",
            "name": {
                "en": "Kenley"
            },
            "distance": 23370
        }
    ]
}