IPMA API

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 (formato 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 (formato 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, "classPrecInt": 0, "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 (formato 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: Atualização é horária. {idArea} pode assumir os seguintes valores:

• 3 - Arq. Açores
• 7 - Continente e Arq. Madeira

Resultado (formato 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\u00e7\u00e3o", "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
• magType: tipo de magnitude
• 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 (formato 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 1, sendo que:

• 0 - é dia equivalente ao hoje
• 1 - amanhã

• 1 - Risco reduzido
• 2 - Risco moderado
• 3 - Risco Elevado
• 4 - Risco muito elevado
• 5 - Risco máximo

Resultado (formato 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 (formato 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 (formato 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 (formato 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/{distrito}/et0-{DICO}-{concelho}.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 2 meses.
• Taxa de atualização diária.
• DICO: Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (formato csv):
date,minimum,maximum,range,mean,std 2019-11-05,2.41702,2.507849,0.090821,2.45881,0.021354 2019-11-06,1.233739,1.567819,0.33408,1.3868,0.092168

• date: data dos valores de referência
• minimum: valor diário mínimo de Evapotranspiração em mm
• maximum: valor diário máximo de Evapotranspiração em mm
• range: valor diário da amplitude de Evapotranspiração em mm
• mean: valor diário da mediana de Evapotranspiração em mm
• std: valor diário do desvio padrão de Evapotranspiração em mm

Invocação:
https://api.ipma.pt/open-data/observation/climate/precipitation-total/{distrito}/mrrto-{DICO}-{concelho}.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 2 meses.
• Taxa de atualização diária.
• DICO: Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (formato csv):
date,minimum,maximum,range,mean,std 2019-11-05,5.40000724792,5.75016117096,0.350153923035,5.49443501615,0.0778455785892 2019-11-06,6.50002336502,7.90272665024,1.40270328522,6.86927786787,0.332015116623

• date: data dos valores de referência
• minimum: valor diário mínimo de Precipitação total em mm
• maximum: valor diário máximo de Precipitação total em mm
• range: valor diário da amplitude de Precipitação total em mm
• mean: valor diário da mediana de Precipitação total em mm
• std: valor diário do desvio padrão de Precipitação total em mm

Invocação:
https://api.ipma.pt/open-data/observation/climate/temperature-min/{distrito}/mtnmn-{DICO}-{concelho}.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 2 meses.
• Taxa de atualização diária.
• DICO: Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (formato csv):
date,minimum,maximum,range,mean,std 2019-11-05,5.2000002861,8.27805137634,3.07805109024,5.69063032102,0.500534717151 2019-11-06,4.7000002861,6.99775123596,2.29775094986,5.0777118652,0.376617969391

• date: data dos valores de referência
• minimum: valor diário mínimo de Temperatura Mínima em ºC
• maximum: valor diário máximo de Temperatura Mínima em ºC
• range: valor diário da amplitude de Temperatura Mínima em ºC
• mean: valor diário da mediana de Temperatura Mínima em ºC
• std: valor diário do desvio padrão de Temperatura Mínima em ºC

Invocação:
https://api.ipma.pt/open-data/observation/climate/temperature-max/{distrito}/mtxmx-{DICO}-{concelho}.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 2 meses.
• Taxa de atualização diária.
• DICO: Identificador único de concelho (de acordo com a CAOP - DGT).

Resultado (formato csv):
date,minimum,maximum,range,mean,std 2019-11-05,19.3000221252,20.2863025665,0.986280441284,19.5742557244,0.254967600783 2019-11-06,18.4155673981,19.5003604889,1.08479309082,18.7312252525,0.266200544044

• date: data dos valores de referência
• minimum: valor diário mínimo de Temperatura Máxima em ºC
• maximum: valor diário máximo de Temperatura Máxima em ºC
• range: valor diário da amplitude de Temperatura Máxima em ºC
• mean: valor diário da mediana de Temperatura Máxima em ºC
• std: valor diário do desvio padrão de Temperatura Máxima em ºC

Invocação:
https://api.ipma.pt/open-data/observation/climate/mpdsi/{distrito}/mpdsi-{DICO}-{concelho}.csv
Notas: Taxa de atualização mensal. DICO: Identificador único de concelho (de acordo com a CAOP - DGT).

• maior ou igual a 4,0 - Chuva extrema
• 3,00 a 4,0 - Chuva severa
• 2,00 a 3,99 - Chuva moderada
• 1,00 a 1,99 - Chuva fraca
• -0,99 a 0,99 - Normal
• -1,99 a -1,0 - Seca fraca
• -2,99 a -2,0 - Seca moderada
• -3,99 a -3,0 - Seca severa
• menor ou igual a -4,00 - Seca extrema

Resultado (formato csv):
date,minimum,maximum,range,mean,std 2019-06-01,-4.14065742493,-3.82811713219,0.31254029274,-4.00105850644,0.0688523113333 2019-07-01,-4.13271760941,-3.88426327705,0.248454332352,-4.02632138021,0.0540765353765

• date: data dos valores de referência
• minimum: valor diário mínimo de PDSI
• maximum: valor diário máximo de PDSI
• range: valor diário da amplitude de PDSI
• mean: valor diário da mediana de PDSI
• std: valor diário do desvio padrão de PDSI

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 (formato 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", "code": "L2", "zone_type": "LITORAL", "region_name": "Norte", "representative_point": "POINT (-8.862641815298508 41.100897)", "status": "PARTIAL_OPEN", "interdictions": {"open": [{"specie_c": "Am\u00eaijoa-rel\u00f3gio", "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\u00e7o-do-mar", "specie_s": "Paracentrotus lividus", "classification": "NA"}, {"specie_c": "Lapa", "specie_s": "Patella spp.", "classification": "NA"}, {"specie_c": "Am\u00eaijoa-branca", "specie_s": "Spisula solida", "classification": "B"}], "close": [{"specie_c": "Mexilh\u00e3o", "specie_s": "Mytilus spp.", "classification": "B"}]}} }, }, ...}

• name: nome da zona
• code: 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, "PARTIAL_OPEN", "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"))