Get current weather data

Retrieve the current weather conditions for a specified location using latitude and longitude coordinates.

Authorizations

appid

string

queryrequired

Query Parameters

lat

number

required

Latitude of the desired location

Required range: -90 < x < 90

lon

number

required

Longitude of the desired location

Required range: -180 < x < 180

mode

enum<string>

Response format.

Default is json if you don't use the mode parameter.

Available options:

html,

json,

xml

units

enum<string>

Units of measurement:

• standard: Kelvin for temperature, meter/sec for wind speed and wind gust
• metric: Celsius for temperature, meter/sec for wind speed and wind gust
• imperial: Fahrenheit for temperature, miles/hour for wind speed and wind gust

Default is standard if you don't use the units parameter.

Available options:

standard,

metric,

imperial

lang

string

Output language for weather description (weather.description) and city name (name) fields in the API response.

Available options:

• af: Afrikaans
• al: Albanian
• ar: Arabic
• az: Azerbaijani
• eu: Basque
• be: Belarusian
• bg: Bulgarian
• ca: Catalan
• zh_cn: Chinese Simplified
• zh_tw: Chinese Traditional
• hr: Croatian
• cs: Czech
• da: Danish
• nl: Dutch
• en: English
• fi: Finnish
• fr: French
• gl: Galician
• de: German
• el: Greek
• he: Hebrew
• hi: Hindi
• hu: Hungarian
• is: Icelandic
• id: Indonesian
• it: Italian
• ja: Japanese
• kr: Korean
• ku: Kurmanji (Kurdish)
• la: Latvian
• lt: Lithuanian
• mk: Macedonian
• no: Norwegian
• fa: Persian (Farsi)
• pl: Polish
• pt: Portuguese
• pt_br: Português Brasil
• ro: Romanian
• ru: Russian
• sr: Serbian
• sk: Slovak
• sl: Slovenian
• es: Spanish
• sv: Swedish
• se: Swedish
• th: Thai
• tr: Turkish
• uk: Ukrainian
• vi: Vietnamese
• zu: Zulu

Default is English if you don't use the lang parameter.

Response

200 - application/json

coord

object

Show child attributes

coord.lon

number

Longitude of the location

coord.lat

number

Latitude of the location

weather

object[]

Show child attributes

weather.id

integer

Weather condition identifier

weather.main

string

Group of weather parameters (Rain, Snow, Clouds etc.)

weather.description

string

Weather condition within the group

weather.icon

string

Weather icon identifier

base

string

Internal parameter

main

object

Show child attributes

main.temp

number

Temperature

main.feels_like

number

Temperature accounting for human perception

main.pressure

integer

Atmospheric pressure at sea level (hPa)

main.humidity

integer

Humidity (%)

main.temp_min

number

Minimum temperature at the moment (only for large megapolises and urban areas)

main.temp_max

number

Maximum temperature at the moment (only for large megapolises and urban areas)

main.sea_level

integer

Atmospheric pressure at sea level (hPa)

main.grnd_level

integer

Atmospheric pressure at ground level (hPa)

visibility

integer

Visibility (meters)

wind

object

Show child attributes

wind.speed

number

Wind speed

wind.deg

integer

Wind direction, degrees (meteorological)

wind.gust

number

Wind gust

clouds

object

Show child attributes

clouds.all

integer

Cloudiness (in percentage)

rain

object | null

Show child attributes

rain.1h

number

Precipitation volume for the last 1 hour (mm)

rain.3h

number

Precipitation volume for the last 3 hours (mm)

snow

object | null

Show child attributes

snow.1h

number

Precipitation volume for the last 1 hour (mm)

snow.3h

number

Precipitation volume for the last 3 hours (mm)

dt

integer

Time of data calculation, in Unix time (UTC)

sys

object

Show child attributes

sys.type

integer

Internal parameter

sys.id

integer

Internal parameter

sys.message

number

Internal parameter

sys.country

string

Country code. For example, FR for France.

sys.sunrise

integer

Sunrise time, in Unix time (UTC)

sys.sunset

integer

Sunset time, in Unix time (UTC)

timezone

integer

Shift in seconds from UTC

id

integer

City identifier

name

string

City name

cod

integer

API response status code