IPMA API

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


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 info@ipma.pt a informar da sua utilização deste serviço.


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, de momento, dados de previsão associadas a locais (cidades)e localização dos eventos sísmicos, no formato JSON.

Serviços disponíveis:

Invocação:
http://api.ipma.pt/open-data/forecast/meteorology/cities/daily/{globalIdLocal}.json
Nota: Apenas estão disponíveis dados diários.

Exemplo:
http://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, "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
  • globalIdLocal: identificador do local
  • 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
  • latitude: latitude
  • longitude: longitude

Invocação:
http://api.ipma.pt/open-data/forecast/meteorology/cities/daily/hp-daily-forecast-day{idDay}.json
Nota: 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, "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
  • globalIdLocal: identificador do local
  • 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
  • latitude: latitude
  • longitude: longitude

Invocação:
http://api.ipma.pt/open-data/observation/seismic/{idArea}.json
Nota. Atualização é horária e{idArea}:

  • 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


Serviços auxiliares:

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

Resultado (formato json): { "owner": "IPMA", "country": "PT", "data": [ {"idRegion": 1, "idWarningRegion": "AVR", "idCounty": 5, "globalIdLocal": 1010500, "latitude": "40.6413", "idDistrict": 1, "local": "Aveiro", "longitude": "-8.6535"}]}

  • globalIdLocal: identificador do local
  • local: nome do local
  • idRegion: identificador região [1 "Continente", 2 "Arq. Madeira", 3 "Arq. Açores"]
  • idCounty: Identificador do concelho (identificador definido no âmbito DICO)
  • idDistrict: Identificador do distrito (identificador definido no âmbito DICO)
  • idWarningRegion: Identificador da área dos avisos
  • latitude: latitude
  • longitude: longitude

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

Resultado (formato 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:
http://api.ipma.pt/open-data/wind-speed-daily-classe.json

Resultado (formato 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

termos econdiçõ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.


Contactos

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