URL base
https://mareator2.mareator.es/codigo/api/
Localizaciones predefinidas (loc=1…6)
loc=1 — Coruña
lat 43.38141, lon -8.4193 · puerto 20
loc=2 — Miño
lat 43.3521, lon -8.222 · puerto 19
loc=3 — Doniños
lat 43.4969, lon -8.324 · puerto 18
loc=4 — O Grove
lat 42.4563, lon -8.9219 · puerto 27
loc=5 — Area Maior
lat 42.7512, lon -9.0978 · puerto 24
loc=6 — Deltebre
lat 40.7181, lon 0.7217 · puerto 50
GET
/api/mareas
Motor armónico TICON-3 · sin APIs externas · pasado y futuro ilimitados
cargando…
| Parámetro | Tipo | Defecto | Descripción |
|---|---|---|---|
loc * | int 1–6 | — | Localización predefinida (aporta puerto automáticamente) |
puerto * | int | — | ID de puerto IHM directo (18, 19, 20, 24, 27, 50). Alternativa a loc |
fecha opt | YYYY-MM-DD | hoy | Fecha de inicio. Admite cualquier fecha pasada o futura |
dias opt | int 1–30 | 7 | Número de días a calcular |
fuente opt | armonico | ihm | armonico | Fuente de datos. Ver sección IHM más abajo |
* Se requiere loc o puerto, no ambos.
Ejemplos (fuente armónica)
Mareas semana que viene en Miño
https://mareator2.mareator.es/codigo/api/mareas?loc=2&fecha=2026-05-13&dias=7
Abrir →
Mareas históricas (hace 30 días)
https://mareator2.mareator.es/codigo/api/mareas?loc=1&fecha=2026-04-06&dias=3
Abrir →
Puerto directo (Deltebre, 2 días)
https://mareator2.mareator.es/codigo/api/mareas?puerto=50&dias=2
Abrir →
GET
/api/mareas?fuente=ihm
API oficial IHM · datos reales · rango de fechas limitado
cargando…
Variante del endpoint /api/mareas que usa la API pública del
Instituto Hidrográfico de la Marina (ideihm.covam.es) como fuente
de datos, en lugar del motor armónico autónomo. Acepta los mismos parámetros
(loc, puerto, fecha, dias) más
fuente=ihm.
| Fuente | Pasado | Futuro | Disponibilidad |
|---|---|---|---|
armonico (defecto) |
Ilimitado | Ilimitado | Siempre (cálculo local) |
ihm |
~30 días | ~1 año | Requiere acceso a ideihm.covam.es |
Limitación de fechas IHM: la API del IHM solo publica predicciones
para un rango cercano al presente. Las fechas demasiado pasadas (> ~30 días) o
demasiado futuras (> ~1 año) devolverán el error
ERROR_API_IHM.
Para esos casos usa la fuente armónica (sin fuente=).
Ejemplos (fuente IHM)
Mareas IHM hoy en Coruña
https://mareator2.mareator.es/codigo/api/mareas?loc=1&fuente=ihm&dias=1
Abrir →
Mareas IHM 3 días en O Grove
https://mareator2.mareator.es/codigo/api/mareas?loc=4&fuente=ihm&dias=3
Abrir →
Mareas IHM mañana en Miño
https://mareator2.mareator.es/codigo/api/mareas?loc=2&fuente=ihm&fecha=2026-05-07&dias=1
Abrir →
Mareas IHM hace 7 días en Coruña
https://mareator2.mareator.es/codigo/api/mareas?loc=1&fuente=ihm&fecha=2026-04-29&dias=2
Abrir →
GET
/api/temperatura-agua
MeteoGalicia ROMS · solo previsión · ~5 días
cargando…
| Parámetro | Tipo | Defecto | Descripción |
|---|---|---|---|
loc * | int 1–6 | — | Localización predefinida |
lat+lon * | float | — | Coordenadas personalizadas (alternativa a loc). Internamente se desplaza 2 km al NO para asegurar cobertura ROMS |
fecha opt | YYYY-MM-DD | hoy | Fecha de inicio (solo presente y futuro próximo) |
dias opt | int 1–5 | 1 | Días a consultar |
Solo disponible para fechas presentes y futuras (horizonte ~5 días). Las fechas pasadas devuelven error
DATOS_HISTORICOS_NO_DISPONIBLES.Ejemplos
Temperatura del agua hoy en Coruña
https://mareator2.mareator.es/codigo/api/temperatura-agua?loc=1
Abrir →
Temperatura 3 días en Doniños
https://mareator2.mareator.es/codigo/api/temperatura-agua?loc=3&dias=3
Abrir →
Temperatura con coordenadas personalizadas
https://mareator2.mareator.es/codigo/api/temperatura-agua?lat=43.5&lon=-8.1&dias=2
Abrir →
Temperatura máxima del período (5 días)
https://mareator2.mareator.es/codigo/api/temperatura-agua?loc=4&dias=5
Abrir →
GET
/api/mar
Open-Meteo Marine · altura de ola, dirección, período · histórico ilimitado
cargando…
| Parámetro | Tipo | Defecto | Descripción |
|---|---|---|---|
loc * | int 1–6 | — | Localización predefinida |
lat+lon * | float | — | Coordenadas personalizadas. Deben ser zona marítima |
fecha opt | YYYY-MM-DD | hoy | Fecha de inicio. Cualquier fecha pasada o futura |
dias opt | int 1–7 · ahora · 0 | 1 con loc · ahora con lat/lon | Días a consultar. Con ahora o 0 (o usando lat/lon sin especificar dias) devuelve únicamente el registro de la hora actual en formato plano (datos.ahora = true) |
Cada registro horario incluye
energia_ola_kj_m: energía de ola
en kJ por metro de frente (E ≈ 4 · H² · T²).
Valor orientativo ajustado empíricamente a datos reales de previsión.
Escala orientativa: <500 pequeña · 500–2000 media · 2000–5000 grande · 5000–10000 muy grande · >10000 extrema.Ejemplos
Estado del mar ahora en Coruña
https://mareator2.mareator.es/codigo/api/mar?loc=1&dias=ahora
Abrir →
Oleaje histórico (Navidad 2024)
https://mareator2.mareator.es/codigo/api/mar?loc=1&fecha=2024-12-25&dias=2
Abrir →
Oleaje con coordenadas personalizadas
https://mareator2.mareator.es/codigo/api/mar?lat=43.38&lon=-8.39&dias=3
Abrir →
GET
/api/tiempo
Open-Meteo Forecast / ERA5 · temperatura, viento, lluvia · histórico ilimitado
cargando…
| Parámetro | Tipo | Defecto | Descripción |
|---|---|---|---|
loc * | int 1–6 | — | Localización predefinida |
lat+lon * | float | — | Coordenadas personalizadas |
fecha opt | YYYY-MM-DD | hoy | Fecha de inicio. Cualquier fecha |
dias opt | int 1–16 · ahora · 0 | 1 con loc · ahora con lat/lon | Días a consultar (máx 16 en previsión). Con ahora o 0 (o usando lat/lon sin especificar dias) devuelve únicamente el registro de la hora actual en formato plano (datos.ahora = true) |
Para fechas > 90 días atrás se usa ERA5 (reanalysis). En ese caso los campos
prob_lluvia_pct y es_dia no están disponibles.Ejemplos
Tiempo el fin de semana que viene
https://mareator2.mareator.es/codigo/api/tiempo?loc=1&fecha=2026-05-09&dias=2
Abrir →
Datos históricos ERA5 (hace 6 meses)
https://mareator2.mareator.es/codigo/api/tiempo?loc=1&fecha=2025-11-06&dias=1
Abrir →
Tiempo con coordenadas personalizadas
https://mareator2.mareator.es/codigo/api/tiempo?lat=42.46&lon=-8.92&dias=3
Abrir →
Estructura de respuesta
Todos los endpoints devuelven el mismo esqueleto. datos varía según el endpoint.
// Respuesta OK
{
"ok": true,
"endpoint": "/api/mareas",
"_log": "[API /mareas armonico]", // etiqueta lista para console.log(d._log, d)
"url_solicitada": "http://servidor/api/mareas?loc=1&dias=3",
"timestamp_solicitud": "2026-03-24T10:30:00+01:00",
"parametros": { "loc": 1, "fecha": "2026-03-24", "dias": 3 },
"localizacion": { "id": 1, "nombre": "Coruña", "lat": 43.38141, "lon": -8.4193, "puerto_id": "20" },
"fechas": { "inicio": "2026-03-24", "fin": "2026-03-26", "dias": 3, "rango": [...] },
"datos": { /* específico del endpoint */ },
"error": null
}
// Respuesta de error
{
"ok": false,
/* mismos campos de contexto */
"datos": null,
"error": {
"codigo": "LOC_INVALIDA",
"mensaje": "Localización '99' no existe. Valores válidos: 1–6.",
"detalle": "Consulta /api para ver la lista de localizaciones."
}
}