IPMA API

Interface de Programação de Aplicações do IPMA


tools

sobre api

Este sistema de informações, API, suporta o serviço de assinatura de dados meteorológicos e oceanográficos produzidos no IPMA.

Com este Interface de Programação de Aplicações (API) o IPMA disponibiliza aos utilizadores uma forma de acederem a um conjunto de dados, passíveis de serem integrados aplicacionalmente.

O IPMA solicita aos utilizadores do serviço disponibilizado pela API que leiam as "condições de utilização". O IPMA solicita ainda que seja enviado um email para o endereço electrónico webmaster@ipma.pt a informar da sua utilização deste serviço e do seu propósito para efeitos de estatística e melhoria do serviço.

Para estar sempre informado de novos desenvolvimentos sobre a API subscreva à lista de distribuição respetiva (API - Desenvolvimentos) do serviço de Subscrições IPMA.


ipma logo

IPMA, I.P.

O Instituto Português do Mar e da Atmosfera, I. P. (IPMA, I. P.), é um instituto público, integrado na administração indireta do Estado, dotado de autonomia administrativa e financeira e património próprio.

O IPMA, I. P., prossegue atribuições do Ministério do Mar, sob superintendência e tutela do respetivo ministro.

A definição das orientações estratégicas e a fixação de objetivos para o IPMA, I.P., bem como o acompanhamento da sua execução, são articulados entre os membros do Governo responsáveis pelas áreas do mar e da ciência.


serviço online

A API disponibiliza, entre outros dados, dados de previsão associadas a locais (cidades) e localização dos eventos sísmicos, no JSON.

Os dados de previsão são obtidos automaticamente através de processamento estatístico das previsões de dois modelos numéricos (ECMWF e AROME), sendo atualizados duas vezes por dia, nomeadamente a corrida das 00UTC (disponibilizada em regra a partir das 10:00) e das 12UTC (disponibilizada em regra a partir das 20:00).

As previsões são apresentadas em horas UTC. No continente e na Região Autónoma da Madeira a hora legal é igual à UTC, no horário de inverno. No horário de verão, a hora legal é igual a UTC+1. Assim, nestas regiões, 10h UTC correspondem à hora legal de 10h no inverno e 11h no verão. Na Região Autónoma dos Açores a hora legal é igual a UTC-1 ou a UTC, respetivamente, nos horários de inverno e de verão.

Serviços disponíveis:

Invocação:
https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json

Notas:

  • Para mais informações sobre os Avisos Meteorológicos consulte o nosso Guia.

Resultado (JSON):
[{"text": "", "awarenessTypeName": "Agitação Marítima", "idAreaAviso": "BGC", "startTime": "2021-03-25T07:25:00", "awarenessLevelID": "green", "endTime": "2021-03-28T07:00:00"}, {"text": "", "awarenessTypeName": "Nevoeiro", "idAreaAviso": "BGC", "startTime": "2021-03-25T07:25:00", "awarenessLevelID": "green", "endTime": "2021-03-28T07:00:00"},...

  • text: texto descritivo do aviso (preenchido apenas quando o aviso é amarelo, laranja ou vermelho)
  • awarenessTypeName: parâmetro do aviso (e.g. "Trovoada", "Agitação Marítima", "Precipitação", "Vento", "Nevoeiro", "Neve", "Tempo Frio", "Tempo Quente")
  • awarenessLevelID: cor / nível do aviso (e.g. "green", "yellow", "orange", "red", só existem avisos para níveis diferentes de "green", ou seja, "yellow", "orange", "red")
  • startTime: data/hora de início da duração do aviso
  • endTime: data/hora de fim da duração do aviso
  • idAreaAviso: identificador da área dos avisos (consultar serviço auxiliar "Lista de identificadores para as capitais distrito e ilhas")

Invocação:
https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/{globalIdLocal}.json

Notas:

  • Apenas estão disponíveis dados diários.

Exemplo:
https://api.ipma.pt/file-example/1110600.json

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "data": [ { "precipitaProb": "0.0", "tMin": "7.6", "tMax": "13.3", "predWindDir": "N", "idWeatherType": 2, "classWindSpeed": 2, "longitude": "-9.1", "forecastDate": "2018-01-26", "latitude": "38.8" }, { "precipitaProb": "0.0", "tMin": "7.1", "tMax": "13.6", "predWindDir": "N", "idWeatherType": 2, "classWindSpeed": 2, "longitude": "-9.1", "forecastDate": "2018-01-27", "latitude": "38.8" }, ... ], "globalIdLocal": 1110600, "dataUpdate": "2018-01-26T09:02:03" }

  • forecastDate: data da previsão
  • dataUpdate: data de atualização do ficheiro (taxa de atualização horária)
  • globalIdLocal: identificador do local (consultar serviço auxiliar "Lista de identificadores para as capitais distrito e ilhas")
  • idWeatherType: código relativo ao tipo de tempo
  • tMin: temperatura mínima diária
  • tMax: temperatura máxima diária
  • classWindSpeed: classe da intensidade do vento
  • predWindDir: rumo predominante do vento (N, NE, E, SE, S, SW, W, NW)
  • probPrecipita: probabilidade da precipitação
  • classPrecInt: classe da intensidade da precipitação
  • latitude: latitude
  • longitude: longitude

Invocação:
https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/hp-daily-forecast-day{idDay}.json

Notas:

  • Apenas estão disponíveis dados diários. {idDay} varia entre 0 e 2, sendo que:
    • 0 - é dia equivalente ao hoje
    • 1 - amanhã
    • 2 - depois de amanhã

Resultado (JSON): { "owner": "IPMA", "country": "PT", "forecastDate": "2018-02-26", "data": [ { "precipitaProb": "6.0", "tMin": "7.6", "tMax": "21.6", "predWindDir": "E", "idWeatherType": 3, "classWindSpeed": 1, "longitude": "-8.7", "globalIdLocal": 1010500, "latitude": "40.6" }, { "precipitaProb": "97.0", "tMin": "8.3", "tMax": "19.1", "predWindDir": "SE", "idWeatherType": 6, "classWindSpeed": 2, "classPrecInt": 0, "longitude": "-7.9", "classPrecInt": 2, "globalIdLocal": 1020500, "latitude": "38.0" } ], "dataUpdate": "2018-02-26T17:02:03"}

  • forecastDate: data para qual a informação é válida
  • dataUpdate: data de atualização do ficheiro (taxa de atualização horária)
  • globalIdLocal: identificador do local (consultar serviço auxiliar "Lista de identificadores para as capitais distrito e ilhas")
  • idWeatherType: código relativo ao tipo de tempo
  • tMin: temperatura mínima diária
  • tMax: temperatura máxima diária
  • classWindSpeed: classe da intensidade do vento
  • predWindDir: rumo predominante do vento (N, NE, E, SE, S, SW, W, NW)
  • probPrecipita: probabilidade da precipitação
  • classPrecInt: classe da intensidade da precipitação
  • latitude: latitude
  • longitude: longitude

Invocação:
https://api.ipma.pt/open-data/observation/seismic/{idArea}.json

Notas:

  • Integra 30 dias de informação
  • Atualização é horária. {idArea} pode assumir os seguintes valores:
    • 3 - Arq. Açores
    • 7 - Continente e Arq. Madeira

Resultado (JSON):
{"owner": "IPMA", "country": "PT", "idArea": 3, "data": [{"degree": null, "dataUpdate": "2018-02-10T21:00:00", "magType": "L", "obsRegion": "Fossa de Hirondelle", "lon": "-26.3490", "source": "IPMA", "depth": 5, "shakemapid": "0", "time": "2018-01-28T01:46:28", "lat": "38.0340", "local": null, "magnitud": "2.4"}, {"degree": null, "dataUpdate": "2018-02-10T21:00:00", "magType": "L", "obsRegion": "Caldeira Guilherme Moniz", "lon": "-27.2150", "source": "IPMA", "depth": 2, "shakemapid": "0", "time": "2018-01-28T06:32:22", "lat": "38.7200", "local": null, "magnitud": "2.1"}, {"degree": null, "dataUpdate": "2018-02-10T21:00:00", "magType": "L", "obsRegion": "N Fossa de Hirondelle", "lon": "-26.0340", "source": "IPMA", "depth": 5, "shakemapid": "0", "time": "2018-01-29T05:46:56", "lat": "38.3030", "local": null, "magnitud": "2.1"}, {"degree": null, "dataUpdate": "2018-02-13T09:00:00", "magType": "L", "obsRegion": "Fossa da Povoação", "lon": "-24.7080", "source": "IPMA", "shakemapid": "0", "time": "2018-02-03T18:33:07", "lat": "37.4980", "local": null, "magnitud": "2.9"}]}

  • time: data hora (TU) do evento sismico
  • local: nome do local/região da localização do epicento
  • lat: latitude do epicento
  • long: longitude do epicento
  • magnitud: magnitude
  • magType: tipo de magnitude
  • degree: grau
  • dataUpdate: data de atualização
  • obsRegion: código relativo à região
  • depth: profundidade

Invocação:
https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-forecast-day{idDay}.json

Notas:

  • Apenas estão disponíveis dados diários. {idDay} varia entre 0 e 2, sendo que:
    • 0 - é dia equivalente ao hoje
    • 1 - amanhã
    • 2 - depois de amanhã

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "forecastDate": "2020-02-04", "data": [ { "wavePeriodMin": "5.8", "globalIdLocal": 2320126, "totalSeaMax": 1.5, "waveHighMax": "1.1", "waveHighMin": "0.5", "longitude": "-16.3400", "wavePeriodMax": "6.5", "latitude": "33.2500", "totalSeaMin": 0.5, "sstMax": "19.1", "predWaveDir": "S", "sstMin": "19.0" },... ], "dataUpdate": "2020-02-04T14:31:03" }

  • forecastDate: data para qual a informação é válida
  • dataUpdate: data de atualização do ficheiro (taxa de atualização horária)
  • globalIdLocal: identificador do local (consultar serviço auxiliar "Lista de identificadores para regiões costeiras")
  • wavePeriodMin: mínimo diário do período de pico, associado à ondulação (swell), em segundos
  • wavePeriodMax: máximo diário do período de pico, associado à ondulação (swell), em segundos
  • waveHighMin: mínimo diário da altura da ondulação (swell) em metros
  • waveHighMax: máximo diário da altura da ondulação (swell) em metros
  • predWaveDir: rumo predominante da onda (N, NE, E, SE, S, SW, W, NW)
  • totalSeaMin: mínimo diário da altura significativa das ondas, em metros
  • totalSeaMax: máximo diário da altura significativa das ondas, em metros
  • sstMin: mínimo diário da temperatura da superfície do mar em °C
  • sstMax: máximo diário da temperatura da superfície do mar em °C
  • latitude: latitude
  • longitude: longitude

Invocação:
https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d{idDay}.json

Notas:

  • Apenas estão disponíveis dados diários. {idDay} varia entre 0 e 2, sendo que:
    • 0 - é dia equivalente ao hoje
    • 1 - amanhã
    • 2 - depois de amanhã
  • Códigos de rcm:
    • 1 - Risco reduzido
    • 2 - Risco moderado
    • 3 - Risco Elevado
    • 4 - Risco muito elevado
    • 5 - Risco máximo

Resultado (JSON):
{ "dataPrev": "2020-02-03", "dataRun": "2020-02-02", "fileDate": "2020-02-03 09:05:01", "local": { "{DICO}": { "data": { "rcm": 1 }, "DICO": "1001", "latitude": 39.55, "longitude": -8.97 }, ... } }

  • dataPrev: data da previsão
  • dataRun: data da corrida do modelo
  • fileDate: data de atualização do ficheiro (taxa de atualização horária)
  • DICO: Identificador único de concelho (de acordo com a CAOP - DGT)
  • rcm: código relativo ao tipo de risco de incêndio
  • latitude: latitude
  • longitude: longitude

Invocação:
https://api.ipma.pt/open-data/forecast/meteorology/uv/uv.json

Notas:

  • Para mais informações consulte a seguinte página.

Resultado (JSON):
[ { "idPeriodo": 0, "intervaloHora": "14h-14h", "data": "2021-03-25", "globalIdLocal": 3480200, "iUv": "5.0" }, ... ]

  • data: data referente aos dados
  • globalIdLocal: identificador do local (consultar serviço auxiliar "Lista de identificadores para as capitais distrito e ilhas")
  • iUv: valor do índice ultravioleta
    • >= 11: Extremo
    • >= 8: Muito elevado
    • >= 6: Elevado
    • >=3: Moderado
    • >=1: Baixo
  • intervaloHora: intervalo de horas relativo ao valor máximo de UV
  • idPeriodo: código interno do período

Invocação:
https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json

Notas:

  • Taxa de atualização horária. (valor "-99.0" = nodata)

Resultado (JSON):
{ "{YYYY-mm-ddThh:mi}": { "{idEstacao}": { "intensidadeVentoKM": 0.0, "temperatura": 7.7, "idDireccVento": 3, "precAcumulada": 0.0, "intensidadeVento": 0.0, "humidade": 89.0, "pressao": -99.0, "radiacao": -99.0 }, ... } }

  • YYYY-mm-ddThh:mi: data/hora da observação
  • idEstacao: identificador da estação (consultar serviço auxiliar "Lista de identificadores das estações meteorológicas")
  • intensidadeVentoKM: intensidade do vento registada a 10 metros de altura (km/h)
  • temperatura: temperatura do ar registada a 1.5 metros de altura, média da hora (°C)
  • idDireccVento: classe do rumo do vento ao rumo predominante do vento registado a 10 metros de altura (0: sem rumo, 1 ou 9: "N", 2: "NE", 3: "E", 4: "SE", 5: "S", 6: "SW", 7: "W", 8: "NW")
  • precAcumulada: precipitação registada a 1.5 metros de altura, valor acumulado da hora (mm)
  • intensidadeVento: intensidade do vento registada a 10 metros de altura (m/s)
  • humidade: humidade relativa do ar registada a 1.5 metros de altura, média da hora (%)
  • pressao: pressão atmosférica, reduzida ao nível médio do mar (NMM), média da hora (hPa)
  • radiacao: radiação solar (kJ/m2)

Invocação:
https://api.ipma.pt/open-data/observation/meteorology/stations/obs-surface.geojson

Notas:

  • Taxa de atualização horária. (valor "-99.0" = nodata)

Resultado (GeoJSON):
{ "type": "FeatureCollection", "features": [ { "geometry": { "type": "Point", "coordinates": [ -31.1301, 39.4582 ] }, "type": "Feature", "properties": { "intensidadeVentoKM": 11.9, "temperatura": 18.2, "idEstacao": 1200501, "pressao": 1009.5, "humidade": -99.0, "localEstacao": "Flores (Aeroporto)", "precAcumulada": 0.0, "idDireccVento": 4, "radiacao": -99.0, "time": "2020-01-29T14:00:00", "intensidadeVento": 3.3, "descDirVento": "SE" } }, ... ]}

  • time: data/hora da observação
  • idEstacao: identificador da estação
  • localEstacao: nome da estação
  • intensidadeVentoKM: intensidade do vento registada a 10 metros de altura (km/h)
  • temperatura: temperatura do ar registada a 1.5 metros de altura, média da hora (°C)
  • idDireccVento: classe do rumo do vento ao rumo predominante do vento registado a 10 metros de altura (0: sem rumo, 1 ou 9: "N", 2: "NE", 3: "E", 4: "SE", 5: "S", 6: "SW", 7: "W", 8: "NW")
  • descDirVento: rumo do vento ao rumo predominante do vento registado a 10 metros de altura
  • precAcumulada: precipitação registada a 1.5 metros de altura, valor acumulado da hora (mm)
  • intensidadeVento: intensidade do vento registada a 10 metros de altura (m/s)
  • humidade: humidade relativa do ar registada a 1.5 metros de altura, média da hora (%)
  • pressao: pressão atmosférica, reduzida ao nível médio do mar (NMM), média da hora (hPa)
  • radiacao: radiação solar (kJ/m2)

Invocação:
https://api.ipma.pt/open-data/observation/climate/evapotranspiration/et0-p1d-continental-obssup-idw-20d-concelhos.csv

Notas:

  • Valores diários obtidos através do processo de interpolação com recurso aos dados das estações meteorológicas automáticas da rede do IPMA.
  • Valores dos últimos 20 dias.
  • Taxa de atualização diária.
  • DICO (zid): Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (CSV):
time,zname,zid,mean_et0,std_et0,min_et0,max_et0,percentile_25_et0,median_et0,percentile_75_et0
2026-03-18 00:00:00+00:00,Águeda,0101,2.51,0.05,2.40,2.63,2.48,2.51,2.54

  • date: data dos valores de referência
  • zname: nome do concelho
  • zid: identificador único do concelho
  • mean_et0: valor diário da média de Evapotranspiração em mm
  • std_et0: valor diário do desvio padrão de Evapotranspiração em mm
  • min_et0: valor diário mínimo de Evapotranspiração em mm
  • max_et0: valor diário máximo de Evapotranspiração em mm
  • percentile_25_et0: valor diário do percentil 25 de Evapotranspiração em mm
  • median_et0: valor diário da mediana de Evapotranspiração em mm
  • percentile_75_et0: valor diário do percentil 75 de Evapotranspiração em mm

Invocação:
https://api.ipma.pt/open-data/observation/climate/precipitation/prec-p1d-continental-obssup-idw-concelhos-20d.csv

Notas:

  • Valores diários obtidos através do processo de interpolação com recurso aos dados das estações meteorológicas automáticas da rede do IPMA.
  • Valores dos últimos 20 dias.
  • Taxa de atualização diária.
  • DICO (zid): Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (CSV):
time,zname,zid,mean_maxprate,std_maxprate,min_maxprate,max_maxprate,percentile_25_maxprate,median_maxprate,percentile_75_maxprate,mean_tp,std_tp,min_tp,max_tp,percentile_25_tp,median_tp,percentile_75_tp
2026-03-18 00:00:00+00:00,Águeda,0101,8.59,0.73,6.47,10.60,8.21,8.44,8.94,0.73,0.08,0.42,0.91,0.71,0.75,0.77

  • time: data e hora dos valores de referência
  • zname: nome do concelho
  • zid: identificador único do concelho
  • mean_maxprate: valor diário da média da taxa máxima de precipitação em mm/h
  • std_maxprate: valor diário do desvio padrão da taxa máxima de precipitação em mm/h
  • min_maxprate: valor diário mínimo da taxa máxima de precipitação em mm/h
  • max_maxprate: valor diário máximo da taxa máxima de precipitação em mm/h
  • percentile_25_maxprate: valor diário do percentil 25 da taxa máxima de precipitação em mm/h
  • median_maxprate: valor diário da mediana da taxa máxima de precipitação em mm/h
  • percentile_75_maxprate: valor diário do percentil 75 da taxa máxima de precipitação em mm/h
  • mean_tp: valor diário da média da precipitação total em mm
  • std_tp: valor diário do desvio padrão da precipitação total em mm
  • min_tp: valor diário mínimo da precipitação total em mm
  • max_tp: valor diário máximo da precipitação total em mm
  • percentile_25_tp: valor diário do percentil 25 da precipitação total em mm
  • median_tp: valor diário da mediana da precipitação total em mm
  • percentile_75_tp: valor diário do percentil 75 da precipitação total em mm

Invocação:
https://api.ipma.pt/open-data/observation/climate/temperature/t2m-p1d-continental-obssup-idw-concelhos-20d.csv

Notas:

  • Valores diários obtidos através do processo de interpolação com recurso aos dados das estações meteorológicas automáticas da rede do IPMA.
  • Valores dos últimos 20 dias.
  • Taxa de atualização diária.
  • DICO (zid): Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (CSV):
time,zname,zid,mean_maxt2m,std_maxt2m,min_maxt2m,max_maxt2m,percentile_25_maxt2m,median_maxt2m,percentile_75_maxt2m,mean_meant2m,std_meant2m,min_meant2m,max_meant2m,percentile_25_meant2m,median_meant2m,percentile_75_meant2m,mean_mint2m,std_mint2m,min_mint2m,max_mint2m,percentile_25_mint2m,median_mint2m,percentile_75_mint2m
2026-03-18 00:00:00+00:00,Águeda,0101,19.63,0.72,17.24,20.49,19.25,19.93,20.17,15.54,0.70,13.49,16.49,15.10,15.69,16.12,12.56,0.64,10.77,13.62,12.14,12.68,13.09

  • date: data dos valores de referência
  • zname: nome do concelho
  • zid: identificador único do concelho
  • mean_maxt2m: valor diário da média de Temperatura Máxima do Ar em °C
  • std_maxt2m: valor diário do desvio padrão de Temperatura Máxima do Ar em °C
  • min_maxt2m: valor diário mínimo de Temperatura Máxima do Ar em °C
  • max_maxt2m: valor diário máximo de Temperatura Máxima do Ar em °C
  • percentile_25_maxt2m: valor diário do percentil 25 de Temperatura Máxima do Ar em °C
  • median_maxt2m: valor diário da mediana de Temperatura Máxima do Ar em °C
  • percentile_75_maxt2m: valor diário do percentil 75 de Temperatura Máxima do Ar em °C
  • mean_meant2m: valor diário da média de Temperatura Média do Ar em °C
  • std_meant2m: valor diário do desvio padrão de Temperatura Média do Ar em °C
  • min_meant2m: valor diário mínimo de Temperatura Média do Ar em °C
  • max_meant2m: valor diário máximo de Temperatura Média do Ar em °C
  • percentile_25_meant2m: valor diário do percentil 25 de Temperatura Média do Ar em °C
  • median_meant2m: valor diário da mediana de Temperatura Média do Ar em °C
  • percentile_75_meant2m: valor diário do percentil 75 de Temperatura Média do Ar em °C

Invocação:
https://api.ipma.pt/open-data/observation/biology/bivalves/CI_SNMB.geojson

Notas:

  • Últimas permissões/interdições publicadas para a apanha e comercialização de moluscos bivalves, equinodermes, tunicados e gastrópodes marinhos vivos, a data da publicação encontra-se no campo "publication_date".
  • Mais informações na página do Sistema Nacional de Monitorização de Moluscos Bivalves.

Resultado (GeoJSON):
{ "type": "FeatureCollection", "publication_date": ..., "snmb_reference": ..., "cd_decision": ..., "bulletin_name": ..., "owner": ..., "project": ..., "crs": { ... }, "features": [ { "geometry": { "type": "Polygon", "coordinates": [ ... ] }, "type": "Feature", "properties": { "name": "Litoral Matosinhos", "samp": "L2", "zone_type": "LITORAL", "region_name": "Norte", "representative_point": "POINT (-8.862641815298508 41.100897)", "status": "PARTIAL_OPEN", "interdictions": {"open": [{"specie_c": "Amêijoa-relógio", "specie_s": "Dosinia exoleta", "classification": "B"}, {"specie_c": "Castanhola", "specie_s": "Glycymeris glycymeris", "classification": "A"}, {"specie_c": "Telina", "specie_s": "Arcopagia crassa", "classification": "B"}, {"specie_c": "Ouriço-do-mar", "specie_s": "Paracentrotus lividus", "classification": "NA"}, {"specie_c": "Lapa", "specie_s": "Patella spp.", "classification": "NA"}, {"specie_c": "Amêijoa-branca", "specie_s": "Spisula solida", "classification": "B"}], "close": [{"specie_c": "Mexilhão", "specie_s": "Mytilus spp.", "classification": "B"}]} } }, ... ] }

  • name: nome da zona
  • samp: código da zona
  • zone_type: tipo da zona ("LITORAL": Zona Litoral, "EST_LAG": Zona Estuarino-lagunar)
  • region_name: nome da região em que se localiza a zona
  • representative_point: coordenada geográfica onde se centra a zona, ponto representativo
  • status: estado da zona ("OPEN": Situação de permissão de apanha e captura, "PARTIAL_OPEN": Situação de permissão parcial de apanha e captura, "CLOSED": Situação de interdição total de apanha e captura, "NOINFO": Sem informação)
  • interdictions: lista de espécies relativamente à interdição ("specie_s": nome científico (scientific name); "specie_c": nome comum (common name); "classification": estatuto sanitário ("A", "B", "C"))

Serviços auxiliares:

Invocação:
https://api.ipma.pt/open-data/distrits-islands.json

Notas: Foram incluídos alguns locais de previsão não capitais de distrito, como por exemplo: Penhas Douradas, Sagres, Sines, ...

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "data": [ {"idRegiao": 1, "idAreaAviso": "AVR", "idConcelho": 5, "globalIdLocal": 1010500, "latitude": "40.6413", "idDistrito": 1, "local": "Aveiro", "longitude": "-8.6535"}]}

  • globalIdLocal: identificador do local
  • local: nome do local
  • idRegiao: identificador região [1 "Continente", 2 "Arq. Madeira", 3 "Arq. Açores"]
  • idConcelho: identificador do concelho (identificador definido no âmbito DICO)
  • idDistrito: identificador do distrito (identificador definido no âmbito DICO)
  • idAreaAviso: identificador da área dos avisos
  • latitude: latitude da coordenada geográfica (graus decimais)
  • longitude: longitude da coordenada geográfica (graus decimais)

Invocação:
https://api.ipma.pt/open-data/sea-locations.json

Resultado (JSON):
[ { "idRegiao": 1, "idAreaAviso": "CBR", "globalIdLocal": 1060526, "idLocal": 302, "latitude": "40.1417", "local": "Figueira da Foz, Costa", "longitude": "-8.8783" },... ]

  • globalIdLocal: identificador do local
  • local: nome do local
  • idLocal: identificador do local
  • idRegiao: identificador região [1 "Continente", 2 "Arq. Madeira", 3 "Arq. Açores"]
  • idAreaAviso: identificador da área dos avisos
  • latitude: latitude da coordenada geográfica (graus decimais)
  • longitude: longitude da coordenada geográfica (graus decimais)

Invocação:
https://api.ipma.pt/open-data/observation/meteorology/stations/stations.json

Resultado (JSON):
[{ "geometry": { "type": "Point", "coordinates": [-7.821, 37.033] }, "type": "Feature", "properties": { "idEstacao": 1210881, "localEstacao": "Olhão, EPPO" } }, ... ]

  • coordinates: coordenada geográfica da estação [longitude, latitude] (graus decimais)
  • idEstacao: identificador da estação
  • localEstacao: nome da estação

Invocação:
https://api.ipma.pt/open-data/weather-type-classe.json

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "data": [ { "descWeatherTypeEN": "Partly cloudy", "descWeatherTypePT": "Céu pouco nublado", "idWeatherType": 2 },.. ]}

  • idWeatherType: código para tempo significativo
  • descWeatherTypeEN: Descrição em Inglês
  • descWeatherTypePT: Descrição em Português

Invocação:
https://api.ipma.pt/open-data/wind-speed-daily-classe.json

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "data": [{ "descClassWindSpeedEN": "Weak", "descClassWindSpeedPT": "Fraco", "classWindSpeed": "1" }, ...] }

  • classWindSpeed: código para classe vento
  • descClassWindSpeedEN: Descrição em Inglês
  • descClassWindSpeedPT: Descrição em Português

Invocação:
https://api.ipma.pt/open-data/precipitation-classe.json

Resultado (JSON):
{ "owner": "IPMA", "country": "PT", "data": [{ "descClassPrecIntEN": "Weak", "descClassPrecIntPT": "Fraco", "classPrecInt": "1" }, ...] }

  • classPrecInt: código para classe precipitação
  • descClassPrecIntEN: Descrição em Inglês
  • descClassPrecIntPT: Descrição em Português

Ficheiros adicionais:

Ficheiro compactado com simbologia em formato SVG:
Descarregue aqui

Notas: cada estado do tempo apresenta 4 ícones em formato SVG:

  • versão estática dia - 'w_ic_d_{idWeatherType}.svg'
  • versão animada dia - 'w_ic_d_{idWeatherType}anim.svg'
  • versão estática noite - 'w_ic_n_{idWeatherType}.svg'
  • versão animada noite - 'w_ic_n_{idWeatherType}anim.svg'

Exemplo: o ficheiro 'w_ic_d_01.svg' corresponde ao ícone estático diurno do estado do tempo com o código 1 - "Céu limpo". O mesmo ficheiro para a versão animada será 'w_ic_d_01anim.svg'. As versões noturnas correspondentes serão os ficheiros 'w_ic_n_01.svg' e 'w_ic_n_01anim.svg'.

ipma logo

termos e condições

Condições de Utilização

Este sítio de internet é propriedade do Instituto Português do Mar e da Atmosfera, I.P., a seguir designado abreviadamente por IPMA, com sede em Lisboa, Rua C ao Aeroporto de Lisboa, 1749-077 Lisboa.

O IPMA gere este sítio de internet com o objetivo de melhorar o acesso do público à informação meteorológica, climatológica, geofísica e pescas.

O IPMA reserva-se no direito de alterar este site, bem como o seu acesso, sem qualquer aviso prévio, não se responsabilizando por eventuais danos ou prejuízos, sejam de que natureza for, em virtude da falta de continuidade ou disponibilidade do serviço.

O IPMA não garante a ausência de vírus neste sítio de internet nem a existência de outros elementos que possam produzir alterações no sistema informático dos Utilizadores ou nos ficheiros ou documentos armazenados no seu sistema informático, não se responsabilizando, assim, por quaisquer danos ou prejuízos neste âmbito.

Ao aceder ao presente site o Utilizador subscreve, expressamente, os termos e condições que o IPMA passa a indicar nestas Condições de Utilização, sendo a sua utilização indevida e abusiva punida por lei.

Quaisquer tentativas de alteração de informação, de carregamento de informação, ou qualquer outra ação que possa causar dano e/ou colocar em risco a integridade do sistema, é expressamente proibida, podendo ser punida de acordo com a legislação em vigor.

Utilizadores poderão ter de responder pelos danos e prejuízos, de qualquer natureza, que o IPMA possa sofrer devido ao incumprimento de qualquer obrigação a que se encontrem obrigados pelos referidos Termos e condições.

IPMA reserva-se no direito de recusar ou retirar o acesso a este serviço, em qualquer momento e sem aviso prévio, aos Utilizadores que não cumpram os Termos e condições.

Declaração de Exoneração de Responsabilidade

O material contido neste sítio de internet é constituído por informações de carácter geral e meramente indicativo, destinando-se, em exclusivo, a permitir ao Utilizador uma adequada utilização do conjunto de produtos e serviços disponibilizados pelo IPMA.

Este site do IPMA poderá estar ligado a sítios externos sobre os quais o mesmo não tem qualquer controlo e pelos quais não assume qualquer responsabilidade. Todos os conteúdos fornecidos por entidades externas, devidamente identificadas, são da exclusiva responsabilidade dessas entidades.

O IPMA procura, contudo, que esses conteúdos detenham elevados níveis de fiabilidade e credibilidade não podendo, no entanto, dar qualquer garantia quanto ao seu rigor à sua atualidade.

É objetivo deste sítio de internet minimizar os inconvenientes causados por erros técnicos, todavia, determinados dados ou informação contidos neste site podem ter sido criados ou estruturados em ficheiros ou formatos não isentos de erros.

O IPMA não pode garantir a não interrupção ou a não perturbação do serviço devido a problemas técnicos.

Em consequência, o IPMA não assume qualquer responsabilidade por problemas, que surjam para os Utilizadores ou entidades terceiras em virtude da consulta deste sítio de internet ou de quaisquer sítios externos a ele ligados.

Declaração sobre proteção dos direitos de autor

O conteúdo deste sítio de internet é protegido por Direitos de Autor e Direitos Conexos e Direitos de Propriedade Industrial ao abrigo das leis portuguesas e da União Europeia e outras convenções internacionais, não podendo ser utilizado fora das condições admitidas neste sitio de internet.

O Utilizador pode copiar, importar ou utilizar gratuitamente informações ou símbolos nacionais existentes neste site para uso pessoal ou público desde que dessa utilização não decorram finalidades lucrativas ou ofensivas.

O Utilizador deve referir, sempre, a fonte de informação.

No que respeita aos sítios para que este site faz ligação deverá ser obtida a autorização dos autores desse material ou feita referência à fonte conforme as respectivas declarações de direitos de autor. Os direitos de autor não se aplicam aos discursos, declarações ou comunicados produzidos por elementos do IPMA, embora os seus autores, data e circunstâncias devam ser referidos para boa informação.

O logo-símbolo do sítio de internet do IPMA deve ser utilizado sempre que um Utilizador pretenda incluir informação disponibilizada pelo sítio de internet em páginas de hiper-documentos, devendo referenciar a hiper-ligação ao site do IPMA.

Declaração de Confidencialidade

Nos termos do art.° 35° da CRP e da Lei n.° 67/98, de 26 de Outubro, a informação recolhida sobre os Utilizadores do site do IPMA não é de carácter pessoal, pelo que se assegura a confidencialidade da identidade do visitante.

Existirá, contudo, lugar a identificação dos Utilizadores sempre que cometem atos ilegais dentro do sítio de internet, violem o respetivo código de conduta, ou quando tal for solicitado mediante decisão judicial.

O IPMA compromete-se a tomar todas as medidas necessárias para evitar perdas, má utilização, ou alteração da informação recebida dos utentes.

No caso do visitante enviar uma mensagem ao site do IPMA, o seu endereço não será registado ou divulgado, exceto se tal for pedido por sentença judicial.


contacts

Contactos

O sistema é operado pelo IPMA. Para contacto utilize o endereço de email webmaster@ipma.pt.