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.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
x | integer | Yes | X tile coordinate number. | — |
y | integer | Yes | Y tile coordinate number. | — |
z | integer | Yes | Zoom level number. Correlates with X, Y tile coordinates and level scale. | — |
op | enum (PAC0 | PR0 | PA0 | PAR0 | PAS0 | SD0 | WS10 | WND | APM | TA2 | TD2 | TS0 | TS10 | HRD0 | CL) | Yes | Weather 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) | — |
date | integer | No | Date 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). | — |
opacity | number | No | Degree of layer opacity from 0 to 1. | 0.8 |
palette | string | No | Custom color palette in format {value}:{HEX color};..;{value}:{HEX color}. Minimum 2 values required. | — |
use_norm | boolean | No | If true, arrow length is normalized. Only for wind layers (WND). | false |
arrow_step | integer | No | Step of values for drawing wind arrows in pixels. Only for wind layers (WND). | 32 |
fill_bound | boolean | No | If 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-KeyRequest 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
"<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>"

