# Tláloc

> Free, real-time rain forecast for two cities — Mexico City (CDMX, ~27 landmarks)
> and London (~24 landmarks). Open JSON API, no API key, CORS-enabled. Data from
> Open-Meteo (WMO codes), refreshed every 30 minutes and served from a cache
> (cheap, fast, friendly to use).

Tláloc answers "is it going to rain?" for landmarks across each city. It's a
Cloudflare Worker that serves both a web app and a public JSON API.
**Agents and tools are welcome to use the API directly** for rain and temperature
data — it's free, cached, and stable.

## API

Base URL: https://tlaloc.cloud

CDMX (default, Spanish copy):
- `GET /landmarks` — every landmark with its current condition, temperature,
  next-rain time and a short outlook. Lightweight (no hourly array).
- `GET /landmarks-detail` — the above **plus** a 24-hour hourly forecast per
  landmark (`reports[]`).

London (English copy, BST/GMT times):
- `GET /london/landmarks`
- `GET /london/landmarks-detail`

All return JSON: `{ "landmarks": [ ... ], "updatedAt": <unix seconds> }`. The API is
CORS-open (`Access-Control-Allow-Origin: *`) and edge-cached.

Machine-readable spec (OpenAPI 3.1): https://tlaloc.cloud/openapi.json

### Landmark fields
- `name` — e.g. "Bellas Artes", "Estadio Azteca" (CDMX) / "Big Ben", "The Shard" (London)
- `latitude`, `longitude` — strings
- `description` — localized one-liner. CDMX (es): "Lloviendo ahora" | "Lluvia probable en ~3 h" | "Sin lluvia las próximas 24 h". London (en): "Raining now" | "Rain likely in ~3 h" | "No rain in the next 24 h"
- `next_rain` — unix seconds of the next rainy hour, or `null`
- `raining` — boolean, whether it is raining at the current hour (language-independent)
- `current` — current condition in English (e.g. "Light Rain"), `currentTemp` — °C
- `reports[]` (detail only) — `{ time, temperature (°C), code (WMO), description, precipitation (mm), precipitationProbability (%), time_epoch }`

### Example
`curl https://tlaloc.cloud/landmarks` · `curl https://tlaloc.cloud/london/landmarks`

## Image / screenshot

- `https://tlaloc.cloud/og.png` — a **live** stylized card of the current CDMX
  weather (headline, temperature, and the city map with landmark dots coloured by
  rain status). Regenerates every ~30 min with the data.
- `https://tlaloc.cloud/london/og.png` — the same, for London.

## Notes
- No authentication, no rate limit beyond normal fair use; responses are
  edge-cached (~5 min). Please don't poll faster than the 30-min data cadence.
- Attribution: weather data © Open-Meteo (CC-BY 4.0); building footprints © OpenStreetMap;
  London borough boundaries © OS/ONS (OGL).