API Marés, Clima & Oceano global

Q: Posso obter previsões de maré em coordenadas exatas (não apenas portos predefinidos)?

Sim. Passe ?lat=&lon= a /api/v1/tides e o TidesAtlas escolhe automaticamente a melhor fonte: se uma estação calibrada estiver a até 50 km, retorna a sua previsão; caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas. Para uma resposta exclusivamente do modelo (sem fallback para uma estação), use /api/v1/tides/point. Ambos funcionam em qualquer ponto dos oceanos do mundo, sem estação necessária.

Q: Existem SDKs ou bibliotecas para Python, Node.js ou outras linguagens?

Sim. Instale pip install tidesatlas (Python) ou npm install tidesatlas (Node.js). Também publicamos um servidor MCP em tidesatlas.com/mcp para agentes de IA, e a API é REST padrão — utilizável a partir de qualquer linguagem com HTTP. Código-fonte disponível no GitHub sob @TidesAtlas.

Q: A API fornece a temperatura do mar (água)?

Sim. O endpoint /api/v1/marine devolve a temperatura da superfície do mar (água) em °C, hora a hora (sea_surface_temperature_c), juntamente com a altura das ondas, ondulação, ondas de vento e estado do mar. Dados do modelo marinho Copernicus/ECMWF via Open-Meteo.

Q: Posso obter as alturas de maré para traçar uma curva, não apenas os horários de preia-mar/baixa-mar?

Sim. Chame /api/v1/tides/point com ?heights=1&interval=30 para obter uma série de alturas amostrada ({ datetime, height_m } a cada 5–60 minutos), tudo o que precisa para desenhar uma curva de maré suave. Sem esse parâmetro, obtém apenas os extremos (preia-mar/baixa-mar).

Q: Fornecem previsões de ondas e ondulação?

Sim. O endpoint /api/v1/marine devolve, hora a hora e por dia, a altura das ondas, período e direção, ondulação, ondas de vento, estado do mar (escala de Douglas) e temperatura da superfície do mar — dos modelos oceânicos Copernicus/ECMWF.

Marés, meteorologia, ondas, ondulação, temperatura da água, sol e lua para 18,230+ estações em 188 países. 12 endpoints REST. Uma única chave API. Baseado em TICON-4, NOAA e modelos FES2022.

Obter chave API50 créditos grátis ao registrar Ver documentaçãoVer doc Preços

Experimente agora

// Fetch today's tides in San Francisco
const res = await fetch(
  'https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3',
  { headers: { 'X-API-Key': 'YOUR_KEY' } }
);
const { extremes } = await res.json();
// [{ datetime: "2026-03-27T05:12:00-07:00", height_m: 1.82, type: "high" }, ...]

18,230+

Estações de maré

188

Países

99.9%

Disponibilidade

<200ms

Tempo de resposta

Roteamento inteligente

Estações calibradas quando próximas, modelo global FES2022 caso contrário. Automático e transparente.

Marés em qualquer ponto do mar

NEW

Previsões em coordenadas exatas, sem estação necessária. Feito para navegação oceânica e pesquisa.

Observações em tempo real

Sensores REFMAR/SHOM ao vivo fundidos com as previsões para portos franceses.

Pronto para produção

Cache agressivo, webhooks, rate limiting, 99,9% de uptime.

Concebido para todos os usos de marés

De aplicações meteorológicas pessoais a plataformas marinhas empresariais.

Navegação marítima

Planeamento de entrada/saída de porto, cálculos de calado e timing de passagem.

Apps de pesca

Janelas de pesca ideais baseadas na fase de maré, altura e corrente.

Surf e desportos aquáticos

Relatórios de surf com dados de maré, planificadores de kayak e guias de atividades de praia.

Imobiliário costeiro

Análise de risco de inundação, dados de propriedades costeiras e avaliações de seguros.

Investigação e ciência

Conjuntos de dados oceanográficos, trabalho de campo em biologia marinha e modelação climática.

Meteorologia e viagens

Integre marés em painéis meteorológicos, planificadores de viagem e dispositivos IoT.

12 endpoints, possibilidades infinitas

Respostas JSON limpas. Sem XML, sem SOAP, sem complicações.

Pack Marés

GET /api/v1/tides Horários e alturas de maré

Retorna os horários de preia-mar e baixa-mar com alturas. Use um slug de estação para uma previsão calibrada de porto, ou passe coordenadas e o TidesAtlas escolhe automaticamente a melhor fonte.

Parâmetro	Tipo	Descrição
`port`	string	Slug da estação, ex. `aberdeen`. Use /ports para pesquisar.
`lat` / `lon`	float	Roteamento inteligente: se uma estação calibrada estiver a até 50 km, retorna sua previsão (`data_source: "ticon"`). Caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas (`data_source: "fes2022"`). Sem redirecionamento silencioso para estações distantes.
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-14 days (default: 1).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

Estações francesas — coeficientes de maré incluídos. As respostas para estações em França incluem um objeto coefficients (manhã/tarde/máx por dia, de 2026-01-01 a 2035-12-29) e um campo coefficient em cada preia-mar (escala francesa, 20 = marés mortas → 120 = marés vivas excecionais). Não aplicável fora de França.

Experimentar

Estado: —

Exemplo de resposta

{
  "port": { "name": "Aberdeen", "slug": "aberdeen", "lat": 57.14, "lon": -2.08, "timezone": "Europe/London" },
  "data_source": "ticon",
  "date": "2026-03-27",
  "days": 3,
  "count": 12,
  "extremes": [
    { "datetime": "2026-03-27T04:23:00+00:00", "height_m": 3.82, "type": "high" },
    { "datetime": "2026-03-27T10:41:00+00:00", "height_m": 0.94, "type": "low" },
    ...
  ]
}

França: coeficientes de maré (escala francesa)

Para estações em França, a resposta inclui o coeficiente de maré francês — um número adimensional de 20 (marés mortas) a 120 (marés vivas excecionais), comummente utilizado no contexto marítimo francês. O campo aparece em dois locais:

Um campo coefficient em cada preia-mar em extremes (ausente nas baixa-mares).
Um objeto de topo coefficients com valores diários manhã/tarde/máx para o intervalo de datas solicitado.

Cobertura: 2026-01-01 → 2035-12-29. Fonte: computed in-house from Brest harmonic constituents. Geografia: French stations only — the fields are omitted for stations outside France.

Legenda: < 45 = marés mortas, 45-70 = médias, 70-95 = acima da média, 95-110 = marés vivas, > 110 = marés vivas excecionais.

# Get tides + coefficients for Dunkerque, France
GET /api/v1/tides?port=dunkerque&days=3&date=2026-05-14

Exemplo de resposta (campos específicos da França):

{
  "port": { "name": "Dunkerque", "country": "France", ... },
  "data_source": "ticon",
  "extremes": [
    { "datetime": "2026-05-14T05:49:00+02:00", "height_m": 0.81, "type": "low" },
    { "datetime": "2026-05-14T11:49:00+02:00", "height_m": 5.56, "type": "high", "coefficient": 71 },
    { "datetime": "2026-05-14T18:25:00+02:00", "height_m": 0.89, "type": "low" },
    { "datetime": "2026-05-15T00:09:00+02:00", "height_m": 5.61, "type": "high", "coefficient": 77 },
    ...
  ],
  "coefficients": {
    "available": true,
    "source": "Computed from Brest harmonic constituents (French tidal coefficient scale)",
    "scale": "20 (neap) to 120 (extreme spring)",
    "coverage": "2026-01-01 to 2035-12-29",
    "daily": [
      { "date": "2026-05-14", "morning": 71, "afternoon": 77, "max": 77 },
      { "date": "2026-05-15", "morning": 83, "afternoon": 88, "max": 88 },
      ...
    ]
  }
}

GET /api/v1/tides/point Modelo FES2022 explícito em coordenadas exatas NEW

Sempre usa o modelo FES2022 (34 constituintes harmônicos) nas coordenadas exatas que você fornece — nunca recorre a uma estação. Use quando precisar especificamente da saída do modelo (pesquisa, comparações, navegação oceânica). Para a maioria das apps, /api/v1/tides?lat=&lon= é melhor pois escolhe a melhor fonte automaticamente.

Parâmetro	Tipo	Descrição
`lat`	float	Latitude, decimal degrees, -90 to 90. Required.
`lon`	float	Longitude, decimal degrees, -180 to 180. Required.
`date`	YYYY-MM-DD	Start date UTC (default: today).
`days`	int	1-14 days (default: 1).
`datum`	string	Vertical reference: `LAT` (default, like the /tides endpoint) or `MSL`.
`interval`	int	Minutes between samples, 5-60 (default: 10). Sets the spacing of the optional `heights` series and the resolution of extremes detection.
`heights`	bool	Set to `1` to also return an interval-sampled height series — ideal for plotting the tide curve (default: off). Each point is `{ datetime, height_m }`.

How it differs from /api/v1/tides: the /tides endpoint snaps your coordinates to the nearest of 18,000+ predefined stations. /tides/point computes the prediction directly at the exact coordinates you provide, using the FES2022 grid (~7 km resolution). Returns a 404 if the point is on land or outside the ocean mask.

Exemplo de resposta

{
  "query": { "lat": 48.383, "lon": -4.495, "date": "2026-05-13", "days": 1, "datum": "LAT" },
  "model": "FES2022 (34 constituents) via pyfes",
  "datum": "LAT",
  "datum_offset_msl": -3.5268,
  "count": 4,
  "extremes": [
    { "datetime": "2026-05-13T00:20:00+00:00", "height_m": 5.42, "type": "high" },
    { "datetime": "2026-05-13T07:00:00+00:00", "height_m": 1.31, "type": "low" },
    ...
  ],
  "attribution": { "source": "FES2022 by LEGOS/NOVELTIS/CLS, distributed by AVISO+ ..." }
}

# Tides anywhere at sea — example: middle of Atlantic
GET /api/v1/tides/point?lat=35&lon=-30&days=3

# Tide curve for plotting — sampled height every 30 min
GET /api/v1/tides/point?lat=48.38&lon=-4.49&days=1&interval=30&heights=1
# → adds:  "heights_count": 48,
#          "heights": [ { "datetime": "...", "height_m": 3.75 }, ... ]

GET /api/v1/ports Pesquisar estações

Pesquise e liste as estações de maré disponíveis no mundo.

Parâmetro	Tipo	Descrição
`search`	string	Search by name, e.g. `aberdeen`.
`country`	string	Filter by country slug, e.g. `united-kingdom`.
`limit`	int	Max results, 1-500 (default: 50).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

# Find all stations in Japan
GET /api/v1/ports?country=japan&limit=100

# Search by name
GET /api/v1/ports?search=tokyo

GET /api/v1/countries Listar todos os países

Retorna os 188 países com o seu número de estações.

{
  "count": 188,
  "countries": [
    { "name": "United Kingdom", "slug": "united-kingdom", "code_iso": "GB", "station_count": 238 },
    { "name": "United States", "slug": "united-states", "code_iso": "US", "station_count": 156 },
    ...
  ]
}

Pack Clima

GET /api/v1/weather Previsão do tempo

Retorna a previsão meteorológica horária e diária: temperatura, vento, precipitação, índice UV e condições.

Data freshness: Weather data is sourced from NOAA GFS (updated every 6 hours) and cached server-side. Responses may be up to 6 hours old for coastal stations and up to 24 hours for inland locations. If the upstream provider is temporarily unavailable, stale cached data (up to 48h) is served automatically — check the cached and stale fields in the response. A 502 response means no data is available at all for that location.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "timezone": "Europe/Paris",
  "source": "NOAA GFS via Open-Meteo (CC BY 4.0)",
  "daily": [{
    "date": "2026-03-27",
    "temperature_max_c": 12.3, "temperature_min_c": 7.3,
    "precipitation_mm": 1.5, "wind_max_kmh": 19.2,
    "uv_index_max": 3.35, "condition": "light_drizzle",
    "sunrise": "06:06", "sunset": "18:40"
  }],
  "hourly": [
    { "datetime": "2026-03-27T00:00", "temperature_c": 7.3, "feels_like_c": 4.6, "humidity_pct": 78, "wind_speed_kmh": 4.5, "condition": "overcast", ... },
    ...
  ]
}

Valores possíveis de `condition`

O campo condition retorna sempre um destes valores (associe um ícone a cada um, incluindo unknown):

clearmostly_clearpartly_cloudyovercastfogfreezing_foglight_drizzledrizzleheavy_drizzlefreezing_drizzleheavy_freezing_drizzlelight_rainrainheavy_rainfreezing_rainheavy_freezing_rainlight_snowsnowheavy_snowsnow_grainslight_showersshowersheavy_showerssnow_showersheavy_snow_showersthunderstormthunderstorm_hailheavy_thunderstorm_hailunknown

GET /api/v1/marine Previsão oceânica, ondas e temperatura da água

Retorna altura das ondas, ondulação, ondas de vento e estado do mar (modelos Copernicus/ECMWF).

Data freshness: Marine data is sourced from Copernicus/ECMWF (updated every 6 hours) and cached server-side. Responses may be up to 6 hours old for coastal stations. If the upstream provider is temporarily unavailable, stale cached data (up to 48h) is served automatically — check the cached and stale fields. A 502 means no data is available for that location.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "source": "Copernicus Marine / ECMWF via Open-Meteo (CC BY 4.0)",
  "daily": [{
    "date": "2026-03-27",
    "wave_height_max_m": 1.04, "wave_period_max_s": 10.05,
    "wave_direction_dominant": 268,
    "swell_height_max_m": 0.98, "swell_period_max_s": 9.2,
    "sea_state": "smooth"
  }],
  "hourly": [
    { "datetime": "2026-03-27T00:00", "wave_height_m": 1.02, "wave_direction_deg": 275, "swell_height_m": 0.98, "sea_surface_temperature_c": 14.2, ... },
    ...
  ]
}

Each hourly entry also includes sea_surface_temperature_c — the sea-surface (water) temperature in °C, from satellite SST (MUR / GHRSST, ~1 km), accurate near coasts.

Valores possíveis de `sea_state`

O campo sea_state baseia-se na escala de Douglas (a partir da altura das ondas) e retorna sempre um destes valores:

calm_glassycalm_rippledsmoothslightmoderateroughvery_roughhighvery_highunknown

GET /api/v1/astronomy Dados sol e lua

Retorna nascer/pôr do sol, amanhecer, crepúsculo, fase lunar, iluminação, nascer/pôr da lua.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-7 days (default: 1).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "data": [{
    "date": "2026-03-27",
    "sun": {
      "sunrise": "06:06", "sunset": "18:41",
      "dawn": "05:35", "dusk": "19:12",
      "day_length": "12:35"
    },
    "moon": {
      "phase": "first_quarter", "illumination_pct": 66.8,
      "age_days": 9,
      "moonrise": "13:45", "moonset": "03:12"
    }
  }]
}

GET /api/v1/conditions Todas as condições (unificado)

Retorna dados meteorológicos, marinhos e astronômicos numa única chamada. Use o parâmetro include para selecionar os dados.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).
`days`	int	1-7 days (default: 3).
`include`	string	Comma-separated: `weather,marine,astronomy` (default: all).

Exemplo de resposta

# All data in one call
GET /api/v1/conditions?port=brest-3-fra-refmar&days=3

# Only weather + astronomy
GET /api/v1/conditions?lat=48.39&lon=-4.49&include=weather,astronomy

# Response contains: weather{}, marine{}, astronomy[]

GET /api/v1/radar Radar de chuva

Retorna URLs de tiles de radar de chuva para mapas animados de precipitação. Dados do RainViewer, atualizados a cada ~10 minutos.

Parâmetro	Tipo	Descrição
`port`	string	Station slug, e.g. `brest-3-fra-refmar`
`lat` / `lon`	float	Coordinates (alternative to port).

Exemplo de resposta

{
  "lat": 48.39, "lon": -4.49,
  "generated": 1774697424,
  "source": "RainViewer (rainviewer.com)",
  "tile_size": 256, "max_zoom": 7, "color_scheme": 1,
  "frames": {
    "past": [
      { "time": "2026-03-28T14:30:00Z", "timestamp": 1774690200,
        "tile_url": "https://tilecache.rainviewer.com/v2/radar/.../256/{z}/{x}/{y}/1/1_1.png" }
    ],
    "nowcast": [
      { "time": "2026-03-28T15:00:00Z", "timestamp": 1774692000,
        "tile_url": "https://tilecache.rainviewer.com/v2/radar/.../256/{z}/{x}/{y}/1/1_1.png" }
    ]
  }
}

Real-time data with ~10 minute delay. Tile URLs are standard slippy map format compatible with Leaflet, Mapbox GL, etc.

GET /api/v1/observations Observações do nível do mar LIVE

Retorna alturas de água observadas em tempo real dos marégrafos REFMAR/SHOM. Disponível para ~100 estações francesas.

Parâmetro	Tipo	Descrição
`port`	string	Station slug (French REFMAR stations only), e.g. `brest`
`date`	YYYY-MM-DD	Start date (default: today).
`days`	int	1-7 days (default: 1).

Exemplo de resposta

{
  "port": { "name": "Brest", "slug": "brest", "country": "France" },
  "station_id": 3,
  "source": "REFMAR/SHOM (Licence Etalab 2.0)",
  "interval_minutes": 10,
  "data": [
    { "date": "2026-03-28", "observations": [
        { "datetime": "2026-03-28T00:00", "height_m": 9.15, "timestamp": 1774684800 },
        ...
    ]}
  ]
}

Only available for French REFMAR stations (~100 tide gauges). Observations are sub-sampled to 10-minute intervals. Heights are aligned with our prediction datum. The /api/v1/tides endpoint also includes an observations field for REFMAR stations.

Apenas pack Complete

GET /api/v1/history Dados históricos

Retorna previsões de marés e dados meteorológicos históricos. Marés via motor TICON, meteorologia via Open-Meteo Archive.

Parâmetro	Tipo	Descrição
`port`	string	Station slug (required).
`date`	YYYY-MM-DD	Start date in the past (required).
`days`	int	1-365 for tides, 1-90 for weather (default: 7).
`include`	string	Comma-separated: `tides,weather` (default: tides).
`format`	string	Formato de resposta: json, csv ou geojson (padrão: json).

Experimentar

Estado: —

Exemplo de resposta

# Get historical tides and weather for Brest
GET /api/v1/history?port=brest&date=2025-06-01&days=7&include=tides,weather

POST /api/v1/webhooks Webhooks

Crie, gerencie e teste webhooks para alertas em tempo real sobre marés vivas e alertas de tempestade.

Parâmetro	Tipo	Descrição
`action`	string	list, create, update, delete, test
`id`	int	Webhook ID (for update/delete/test).

Eventos suportados

spring_tide — Alerta de maré viva (altura > 4m)
storm_warning — Alerta de tempestade (vento > 60km/h ou ondas > 4m)

Todas as entregas são assinadas com HMAC-SHA256. Verifique o header X-TidesAtlas-Signature.

Os webhooks são desativados após 3 falhas consecutivas.

# Create a webhook
POST /api/v1/webhooks?action=create
{
  "url": "https://example.com/webhook",
  "events": ["spring_tide", "storm_warning"],
  "port_slug": "brest"
}

# Test delivery
POST /api/v1/webhooks?action=test&id=1

Fontes de dados e atribuições

O TidesAtlas constrói a camada de roteamento, cache e integração sobre estes conjuntos de dados científicos abertos. Cada fonte é listada com sua licença.

FES2022

Global finite-element ocean tide model. Used for the /api/v1/tides/point endpoint and for 13,360+ FES2022-derived stations.

Produced by LEGOS, NOVELTIS and CLS. Distributed by AVISO+ with support from CNES. Use requires citation per AVISO+ license. Product page →

TICON

Harmonic constants for 3,000+ tide gauges worldwide. Used for the /api/v1/tides endpoint.

Sourced from the GESLA/PANGAEA database. License: CC BY 4.0 — commercial use permitted. Dataset →

NOAA CO-OPS

Harmonic constants for 1,000+ US tide stations.

Public domain (US government work). NOAA CO-OPS →

REFMAR / SHOM

Live observations from ~100 French tide gauges. Used to enrich /tides responses for French ports.

License: Etalab 2.0. REFMAR →

Weather & marine

NOAA GFS (weather) and Copernicus Marine / ECMWF (waves, marine state) via Open-Meteo.

License: CC BY 4.0. Open-Meteo →

Rain radar

Live rain radar tiles via RainViewer.

Attribution required, commercial use permitted. RainViewer →

Cita o TidesAtlas no seu trabalho? Inclua um link para tidesatlas.com e credite a fonte upstream (ex.: «FES2022 via TidesAtlas») quando o modelo de maré for o dado principal.

Início rápido na sua linguagem favorita

Copie, cole e comece a construir em menos de 60 segundos.

cURL

JavaScript

Python

PHP

# Get 3-day tides for San Francisco
curl -H "X-API-Key: YOUR_KEY" \
  "https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3"

const response = await fetch(
  'https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3',
  { headers: { 'X-API-Key': 'YOUR_KEY' } }
);
const { extremes } = await response.json();

extremes.forEach(e =>
  console.log(`${e.type}: ${e.datetime} — ${e.height_m}m`)
);

import requests

response = requests.get(
    'https://tidesatlas.com/api/v1/tides',
    params={'port': 'san-francisco', 'days': 3},
    headers={'X-API-Key': 'YOUR_KEY'}
)

for e in response.json()['extremes']:
    print(f"{e['type']}: {e['datetime']} — {e['height_m']}m")

$ch = curl_init('https://tidesatlas.com/api/v1/tides?port=san-francisco&days=3');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_KEY']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['extremes'] as $e) {
    echo "{$e['type']}: {$e['datetime']} — {$e['height_m']}m\n";
}

SDKs oficiais

Comece mais rápido com as nossas bibliotecas cliente oficiais.

JavaScript / Node.js

npm install tidesatlas

const TidesAtlas = require('tidesatlas');
const api = new TidesAtlas('YOUR_KEY');

const data = await api.tides({ port: 'san-francisco', days: 3 });
console.log(data.extremes);

Python

pip install tidesatlas

from tidesatlas import TidesAtlas

api = TidesAtlas("YOUR_KEY")

data = api.tides(port="san-francisco", days=3)
print(data["extremes"])

Servidor MCP para agentes IA

Conecte o TidesAtlas diretamente ao Claude, Cursor ou qualquer assistente IA compatível com MCP.

Endpoint MCP

https://tidesatlas.com/mcp

8 ferramentas disponíveis: tides, ports, countries, weather, marine, astronomy, conditions, history.

Configuração Claude Desktop

{
  "mcpServers": {
    "tidesatlas": {
      "url": "https://tidesatlas.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

Preços simples e transparentes

Comece grátis. Escale quando precisar. Sem custos ocultos.

Todos os 12 endpoints

Grátis

50 créditos únicos

Começar grátis

Hobby

$7.99/mo

500 pedidos / dia

Começar

Mais popular

Starter

$14.99/mo

1,000 pedidos / dia

Começar

Pro

$39/mo

10,000 pedidos / dia

Começar

Business

$99/mo

50,000 pedidos / dia

Contacte-nos

Pagamento seguro via Stripe

Cancele a qualquer momento

Encriptação HTTPS

Conforme com o RGPD

Autenticação e limites de pedidos

Autenticação

Passe a sua chave API via header (recomendado) ou parâmetro de query:

# Header (recommended)
curl -H "X-API-Key: YOUR_KEY" https://tidesatlas.com/api/v1/tides?port=aberdeen

# Query parameter
curl https://tidesatlas.com/api/v1/tides?port=aberdeen&api_key=YOUR_KEY

Headers de limite de pedidos

Cada resposta inclui as suas informações de utilização:

`X-RateLimit-Limit`	O seu limite diário
`X-RateLimit-Remaining`	Pedidos restantes hoje
`X-RateLimit-Reset`	Hora de reset (Unix)

Aplicam-se dois limites — exceder qualquer um retorna 429 Too Many Requests:

Quota do plano	Free 50 no total · Hobby 500/dia · Starter 1.000/dia · Pro 10.000/dia · Business 50.000/dia
Taxa por IP	10 requisições/segundo por IP (picos curtos até 30), máx. 20 conexões simultâneas

Em um 429, aguarde antes de tentar novamente (veja Retry-After / X-RateLimit-Reset). Recomenda-se backoff exponencial.

Perguntas frequentes

Que tecnologia alimenta as previsões do TidesAtlas?

Desenvolvemos um motor de previsão harmónica proprietário que funde três conjuntos de dados complementares: TICON-4 (3.000+ estações de referência, até 60 constituintes de maré), NOAA (1.075 estações americanas, 37 constituintes) e o modelo oceânico global FES2022 do LEGOS/CNES (13.000+ pontos costeiros, 8 constituintes principais). Cada fonte foi individualmente calibrada, validada cruzadamente e integrada numa pipeline unificada — um trabalho de engenharia considerável que exigiu meses de desenvolvimento. Resultado: 17.400+ estações em 188 países, todas servidas através de uma API única e coerente. Para ~100 estações francesas, fornecemos também observações em tempo real da rede de marégrafos REFMAR/SHOM.

Qual é a precisão das previsões?

O nosso algoritmo realiza análise harmónica utilizando até 60 constituintes de maré por estação, com alinhamento automático de datums e correções nodais. Para estações primárias (TICON-4, NOAA), a precisão é tipicamente de 5-10 minutos e 10-15 cm. Para estações derivadas do modelo (FES2022), é de 10-20 minutos e 15-25 cm. Validamos continuamente os nossos resultados contra observações em tempo real quando disponíveis. As condições meteorológicas (vento, pressão) podem causar desvios adicionais — por isso também fornecemos dados meteorológicos marinhos para dar uma visão completa.

Preciso de um cartão de crédito para começar?

Não. O plano gratuito oferece 50 créditos únicos sem cartão de crédito. Só precisa de dados de pagamento ao mudar para um plano pago.

Posso usá-lo para projetos comerciais?

Sim! Todos os planos (incluindo o gratuito) permitem uso comercial. Embora aproveitemos conjuntos de dados abertos, o nosso motor de previsão, infraestrutura API e pipeline de dados são inteiramente desenvolvidos internamente. Basta incluir uma atribuição ao TidesAtlas algures na sua aplicação.

O que acontece se exceder o meu limite diário?

Receberá um código de estado 429. O seu limite reseta à meia-noite UTC. Pode atualizar o seu plano a qualquer momento a partir do painel para obter mais pedidos.

Posso obter previsões de maré em coordenadas exatas (não apenas portos predefinidos)?

Sim. Passe ?lat=&lon= a /api/v1/tides e o TidesAtlas escolhe automaticamente a melhor fonte: se uma estação calibrada estiver a até 50 km, retorna a sua previsão; caso contrário, usa o modelo oceânico global FES2022 nas suas coordenadas exatas. Para uma resposta exclusivamente do modelo (sem fallback para uma estação), use /api/v1/tides/point. Ambos funcionam em qualquer ponto dos oceanos do mundo, sem estação necessária.

Existem SDKs ou bibliotecas para Python, Node.js ou outras linguagens?

Sim. Instale pip install tidesatlas (Python) ou npm install tidesatlas (Node.js). Também publicamos um servidor MCP em tidesatlas.com/mcp para agentes de IA, e a API é REST padrão — utilizável a partir de qualquer linguagem com HTTP. Código-fonte disponível no GitHub sob @TidesAtlas.

A API fornece a temperatura do mar (água)?

Sim. O endpoint /api/v1/marine devolve a temperatura da superfície do mar (água) em °C, hora a hora (sea_surface_temperature_c), juntamente com a altura das ondas, ondulação, ondas de vento e estado do mar. Dados do modelo marinho Copernicus/ECMWF via Open-Meteo.

Posso obter as alturas de maré para traçar uma curva, não apenas os horários de preia-mar/baixa-mar?

Sim. Chame /api/v1/tides/point com ?heights=1&interval=30 para obter uma série de alturas amostrada ({ datetime, height_m } a cada 5–60 minutos), tudo o que precisa para desenhar uma curva de maré suave. Sem esse parâmetro, obtém apenas os extremos (preia-mar/baixa-mar).

Fornecem previsões de ondas e ondulação?

Sim. O endpoint /api/v1/marine devolve, hora a hora e por dia, a altura das ondas, período e direção, ondulação, ondas de vento, estado do mar (escala de Douglas) e temperatura da superfície do mar — dos modelos oceânicos Copernicus/ECMWF.

Comece a construir com dados de marés, clima & oceano hoje

Chave API gratuita em 30 segundos. Sem cartão de crédito necessário.

Obter a sua chave API gratuita

API Marés, Clima & Oceano global

Roteamento inteligente

Marés em qualquer ponto do mar

Observações em tempo real

Pronto para produção

Concebido para todos os usos de marés

Navegação marítima

Apps de pesca

Surf e desportos aquáticos

Imobiliário costeiro

Investigação e ciência

Meteorologia e viagens

12 endpoints, possibilidades infinitas

Experimentar

Exemplo de resposta

França: coeficientes de maré (escala francesa)

Exemplo de resposta (campos específicos da França):

Exemplo de resposta

Exemplo de resposta

Valores possíveis de condition

Exemplo de resposta

Valores possíveis de sea_state

Exemplo de resposta

Exemplo de resposta

Exemplo de resposta

Exemplo de resposta

Experimentar

Exemplo de resposta

Fontes de dados e atribuições

FES2022

TICON

NOAA CO-OPS

REFMAR / SHOM

Weather & marine

Rain radar

Início rápido na sua linguagem favorita

SDKs oficiais

Servidor MCP para agentes IA

Endpoint MCP

Configuração Claude Desktop

Preços simples e transparentes

Autenticação e limites de pedidos

Autenticação

Headers de limite de pedidos

Perguntas frequentes

Comece a construir com dados de marés, clima & oceano hoje

Crie a sua conta API

Valores possíveis de `condition`

Valores possíveis de `sea_state`