OpenWeatherMap Get Weather Map Tile

1 credits/call
ae_openweathermap_get_weather_map_tile

Get an OpenWeather map tile for current, forecast, or historical conditions such as temperature, precipitation, wind, pressure, humidity, cloudiness, or snow.

WeatherMapsImage
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
xintegerYesX tile coordinate number.—
yintegerYesY tile coordinate number.—
zintegerYesZoom level number. Correlates with X, Y tile coordinates and level scale.—
openum (PAC0 | PR0 | PA0 | PAR0 | PAS0 | SD0 | WS10 | WND | APM | TA2 | TD2 | TS0 | TS10 | HRD0 | CL)YesWeather map layer. Available values: PAC0 (Convective precipitation), PR0 (Precipitation intensity), PA0 (Accumulated precipitation), PAR0 (Accumulated precipitation - rain), PAS0 (Accumulated precipitation - snow), SD0 (Depth of snow), WS10 (Wind speed at 10m), WND (Wind speed and direction), APM (Atmospheric pressure), TA2 (Air temperature at 2m), TD2 (Dew point temperature), TS0 (Soil temperature 0-10cm), TS10 (Soil temperature >10cm), HRD0 (Relative humidity), CL (Cloudiness)—
dateintegerNoDate and time as Unix timestamp (UTC). If not specified, returns current weather map. For forecast: any date within next 10 days. For historical: any date since March 18, 2019. Will be rounded to previous 3-hour interval (12-hour for TS0 and TS10 layers).—
opacitynumberNoDegree of layer opacity from 0 to 1.0.8
palettestringNoCustom color palette in format {value}:{HEX color};..;{value}:{HEX color}. Minimum 2 values required.—
use_normbooleanNoIf true, arrow length is normalized. Only for wind layers (WND).false
arrow_stepintegerNoStep of values for drawing wind arrows in pixels. Only for wind layers (WND).32
fill_boundbooleanNoIf true, weather values outside specified set are filled with color of nearest specified value.false

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_openweathermap_get_weather_map_tile' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "arrow_step": 32,
    "fill_bound": false,
    "op": "PAC0",
    "opacity": 0.8,
    "use_norm": false,
    "x": 1,
    "y": 1,
    "z": 1
  }
}'
Response exampleresponse.json
JSON
"<html>\r\n<head><title>404 Not Found</title></head>\r\n<body>\r\n<center><h1>404 Not Found</h1></center>\r\n<hr><center>openresty</center>\r\n</body>\r\n</html>"