Symbol
Symbol endpoint serves compact multi‑location forecast "symbol tiles" for three modes: current, hourly, and daily. Parameters x, y and z have the same meaning as in the Tile endpoint. Symbol endpoint returns a JSON tile with per‑location current or forecast timesteps including temperature and weather symbol codes, designed for use as map overlays with minimal payload.
Request
- Base URL: https://weatherapi.foreca.net
- URL: https://weatherapi.foreca.net/api/v1/symbol/{mode}
- Auth: HTTP bearer
Path parameters
One of: "current" for the nearest full hour, or "hourly" or "daily" for forecasts. The forecasts cover five days, that is, 120 hourly or 5 daily timesteps
Query parameters
X index of the requested JSON tile
Y index of the requested JSON tile
Zoom level of the requested JSON tile. Valid range: 3..12
Use units=C for Celsius or units=F for Fahrenheit. Default: units=C
Use wrap=1 for automatic horizontal wrapping of tiles. It makes x = x % (max(x) + 1), where max(x) is the maximum x on the selected zoom level (z). Default: wrap=0
Response
Success
Example response
{
"locations": [
{
"city": "Tampere",
"id": 100634963,
"lat": "61.499114990",
"lon": "23.787117004",
"timesteps": [
{
"symbol": "n400",
"temperature": 4.72,
"time": "2025-12-03T14:00"
}
]
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.