NAiOS IconNAiOS Logo
Volver al catálogo

OpenWeather API

openweather_api

Provides access to current weather data, forecasts, and historical weather data for any location worldwide.

Acciones
17
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (17)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Delete Weather StationOPENWEATHER_API_DELETE_WEATHER_STATIONAcción

Tool to delete a registered weather station. use after identifying a station to remove. returns confirmation message upon success.

Parámetros de entrada

  • station_idstringObligatorio

    The unique ID of the weather station to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get 5 Day ForecastOPENWEATHER_API_GET5_DAY_FORECASTAcción

Tool to get a 5-day forecast every 3 hours. use after specifying location.

Parámetros de entrada

  • qstring

    City name and optional country code, e.g. 'London,uk'

  • idinteger

    OpenWeatherMap city ID

  • latnumber

    Latitude in degrees

  • lonnumber

    Longitude in degrees

  • zipstring

    Zip code with country code, e.g. '94040,us'

  • langstring

    Language code (ISO 639-1)

  • modestringenum

    Response format

    jsonxmlhtml
  • unitsstringenum

    Units of measurement (standard, metric, imperial)

    standardmetricimperial

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Current Air Pollution DataOPENWEATHER_API_GET_AIR_POLLUTION_CURRENTAcción

Tool to fetch current air pollution data for a location. use when you need real-time air quality details by latitude and longitude.

Parámetros de entrada

  • latnumberObligatorio

    Latitude of the location, between -90 and 90

  • lonnumberObligatorio

    Longitude of the location, between -180 and 180

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Air Pollution ForecastOPENWEATHER_API_GET_AIR_POLLUTION_FORECASTAcción

Tool to get forecasted air pollution data for a specific location. use after confirming latitude and longitude.

Parámetros de entrada

  • latnumberObligatorio

    Geographical latitude in decimal degrees (range -90 to 90)

  • lonnumberObligatorio

    Geographical longitude in decimal degrees (range -180 to 180)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Air Pollution HistoryOPENWEATHER_API_GET_AIR_POLLUTION_HISTORYAcción

Tool to retrieve historical air pollution data. use when you need past air quality levels for a specific latitude/longitude and time range.

Parámetros de entrada

  • endintegerObligatorio

    End UNIX timestamp (UTC seconds); must be >= start

  • latnumberObligatorio

    Latitude of the location (range: -90 to 90)

  • lonnumberObligatorio

    Longitude of the location (range: -180 to 180)

  • startintegerObligatorio

    Start UNIX timestamp (UTC seconds); must be <= end

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Circle City WeatherOPENWEATHER_API_GET_CIRCLE_CITY_WEATHERAcción

Tool to search for current weather data in cities around a geographic point. use when you need to fetch weather within a radius circle after confirming latitude and longitude.

Parámetros de entrada

  • cntinteger

    Number of cities to return within the circle (1–50). Default is 10.

  • latnumberObligatorio

    Latitude of the circle center in degrees (-90 to 90)

  • lonnumberObligatorio

    Longitude of the circle center in degrees (-180 to 180)

  • langstring

    Language of the response (ISO 639-1)

  • modestringenum

    Response format: 'json' or 'xml'

    jsonxml
  • unitsstringenum

    Units of measurement: standard, metric, or imperial

    standardmetricimperial

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Current WeatherOPENWEATHER_API_GET_CURRENT_WEATHERAcción

Tool to retrieve current weather data for a location. use when you need up-to-the-minute weather info.

Parámetros de entrada

  • qstring

    City name, state code and country code, e.g., 'London,uk'

  • idinteger

    City ID, e.g., 2172797

  • latnumber

    Geographic coordinate latitude, e.g., 35.0

  • lonnumber

    Geographic coordinate longitude, e.g., 139.0

  • zipstring

    Zip code and country code, e.g., '94040,us'

  • langstring

    Language for the response (ISO 639-1 code, e.g., 'en')

  • unitsstringenum

    Units of measurement. 'standard' (default), 'metric', or 'imperial'

    standardmetricimperial

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Direct GeocodingOPENWEATHER_API_GET_GEOCODING_DIRECTAcción

Tool to convert a location name into geographic coordinates. use when you need latitude and longitude for a given location after confirming the precise name.

Parámetros de entrada

  • qstringObligatorio

    Location query including city name, state code and country code separated by commas (e.g., 'London,UK').

  • limitinteger

    Number of results to return (1 to 5). Defaults to 5.

Parámetros de salida

  • dataobject[]Obligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Reverse GeocodingOPENWEATHER_API_GET_GEOCODING_REVERSEAcción

Tool to convert geographic coordinates into a location name. use when you need city, state, and country info from latitude and longitude.

Parámetros de entrada

  • latnumberObligatorio

    Latitude of the location in decimal degrees

  • lonnumberObligatorio

    Longitude of the location in decimal degrees

  • limitinteger

    Number of results to return (1 to 5)

Parámetros de salida

  • dataobject[]Obligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Current UV IndexOPENWEATHER_API_GET_UV_INDEXAcción

Tool to retrieve current uv index for a location. use when you need up-to-the-minute uv index by latitude and longitude.

Parámetros de entrada

  • latnumberObligatorio

    Latitude of the location, between -90 and 90

  • lonnumberObligatorio

    Longitude of the location, between -180 and 180

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get UV Index ForecastOPENWEATHER_API_GET_UV_INDEX_FORECASTAcción

Tool to retrieve uv index forecast for a specific location. use when you need upcoming uv index values after confirming latitude and longitude. returns up to 8 days of data.

Parámetros de entrada

  • cntinteger

    Number of days to return (1-8); defaults to 8 if not specified

  • latnumberObligatorio

    Latitude of the location, between -90 and 90

  • lonnumberObligatorio

    Longitude of the location, between -180 and 180

Parámetros de salida

  • dataobject[]Obligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get UV Index HistoryOPENWEATHER_API_GET_UV_INDEX_HISTORYAcción

Tool to retrieve historical uv index data for a specified location and time range. use when you need to analyze past uv exposure trends after confirming coordinates and time period.

Parámetros de entrada

  • endintegerObligatorio

    End UNIX timestamp (UTC seconds); must be >= start

  • latnumberObligatorio

    Latitude of the location (range: -90 to 90)

  • lonnumberObligatorio

    Longitude of the location (range: -180 to 180)

  • startintegerObligatorio

    Start UNIX timestamp (UTC seconds); must be <= end

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Weather Map Tile (2.0)OPENWEATHER_API_GET_WEATHER_MAP_TILEAcción

Tool to fetch weather maps 2.0 tile images. use when you need dynamic weather layers at specific zoom and coordinates with advanced styling options.

Parámetros de entrada

  • xintegerObligatorio

    Tile X coordinate (non-negative integer).

  • yintegerObligatorio

    Tile Y coordinate (non-negative integer).

  • zintegerObligatorio

    Zoom level of the tile (non-negative integer).

  • fillstring

    Color for empty-data fill areas (hex or named).

  • colorstring

    Color schema of the tiles, e.g., 'original', 'black'.

  • layerstringObligatorioenum

    Weather layer name. Options: clouds, clouds_new, precipitation, precipitation_new, pressure, pressure_new, wind, wind_new, temp, temp_new.

    cloudsclouds_newprecipitationprecipitation_newpressurepressure_newwindwind_newtemptemp_new
  • scaleintegerenum

    Tile scale factor: 1 or 2 for retina.

    12
  • formatstring

    Image format; only 'png' is supported.

  • opacitynumber

    Tile opacity value between 0.0 and 1.0.

  • palettestring

    Custom palette definition (comma-separated or JSON).

  • fill_boundboolean

    Fill tiles outside data coverage if true.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Weather StationsOPENWEATHER_API_GET_WEATHER_STATIONSAcción

Tool to list all weather stations added to your account. use after setting up your openweather api key.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Weather TriggersOPENWEATHER_API_GET_WEATHER_TRIGGERSAcción

Tool to retrieve weather triggers for specific conditions. use after defining trigger criteria.

Parámetros de entrada

  • triggersobject[]Obligatorio

    List of weather trigger definitions

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Add Weather StationOPENWEATHER_API_POST_ADD_WEATHER_STATIONAcción

Tool to add a new weather station to your account. use when you need to register a station before sending custom data.

Parámetros de entrada

  • namestringObligatorio

    Station name

  • altitudenumberObligatorio

    Station altitude in meters above sea level

  • latitudenumberObligatorio

    Station latitude, range -90 to 90 degrees

  • longitudenumberObligatorio

    Station longitude, range -180 to 180 degrees

  • external_idstringObligatorio

    External station ID (your own reference)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Weather StationOPENWEATHER_API_UPDATE_WEATHER_STATIONAcción

Tool to update weather station details. use when you need to modify the name, location, or external id of an existing station.

Parámetros de entrada

  • namestring

    Human-readable name for the station

  • altitudenumber

    Altitude of the station above sea level in meters

  • latitudenumberObligatorio

    Latitude of the station in degrees, between -90 and 90

  • longitudenumberObligatorio

    Longitude of the station in degrees, between -180 and 180

  • station_idstringObligatorio

    Unique identifier of the weather station to update

  • external_idstring

    Custom user-provided external identifier for the station

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not