The endpoint provides the user the ability to check the current weather based on geographical coordinates.
Authentication is achieved by passing a custom header named X-Api-Key
containing the API key.
https://api.nubila.ai/api/v1/weather
Parameters
lat
Yes
Latitude value for the requested area
37.2144
lon
Yes
Longitude value for the requested area
-121.8574
Example Request
Example Response (success)
Example response (error)
ok
(boolean
): Indicates whether the request was successful. true
indiciates successful request
message
(string
): In case of unsuccessful request, a message explaining why the request failed
error_code
(number
): System error code representing the error
data
(object
): Contains the weather information object
id
(string
): Unique identifier for the weather data record.
created_at
(string
, ISO 8601): Timestamp when the record was created.
updated_at
(string
, ISO 8601): Timestamp when the record was last updated.
latitude
(number
): Latitude of the location.
longitude
(number
): Longitude of the location.
location_name
(string
): Name of the location.
address
(string
): Address of the location (if available).
elevation
(number
): Elevation of the location in meters.
temperature
(number
): Current temperature in degrees Celsius.
temperature_min
(number
): Minimum recorded temperature in degrees Celsius.
temperature_max
(number
): Maximum recorded temperature in degrees Celsius.
feels_like
(number
): Perceived temperature in degrees Celsius (considering wind and humidity).
pressure
(number
): Atmospheric pressure in hPa (hectopascals).
humidity
(number
): Humidity percentage.
uv
(number
): Ultraviolet (UV) index.
luminance
(number
): Luminance level (exact unit depends on the source).
rain
(number
): Precipitation level in millimeters.
wet_bulb
(number
): Wet-bulb temperature in degrees Celsius (a measure of temperature considering humidity).
wind_speed
(number
): Wind speed in meters per second.
wind_scale
(number
): Wind scale (e.g., Beaufort scale).
wind_speed_list
(array|null
): List of wind speed values over time (if available).
wind_scale_list
(array|null
): List of wind scale values over time (if available).
wind_direction
(number
): Wind direction in degrees (0-360, where 0 represents north).
condition
(string
): General weather condition (e.g., “Clouds”, “Rain”).
condition_desc
(string
): Detailed weather description (e.g., “overcast clouds”).
condition_code
(number
): Numeric code representing the weather condition.
condition_icon
(string
): Icon identifier for the weather condition.
timestamp
(number
): Unix timestamp (seconds since epoch) representing the data retrieval time.
timezone
(number
): Timezone offset in seconds from UTC.
source
(string
): Source of the weather data (e.g., “o” for OpenWeather).
tag
(string
): Custom tag (if applicable).
is_online
(boolean
): Indicates whether the weather station or source is online.
is_malfunction
(boolean
): Indicates whether there is a malfunction in the data source.