API Alertas

API Alertas

Introdução

Esta página documenta a API que providencia informação sobre os alertas emitidos pela Proteção Civil.
Para aceder à informação fornecida pela API, terá que utilizar o url "https://prociv.azores.gov.pt/alertas/api".
A informação fornecida pela API está em formato JSON.

Parâmetros

Podem ser enviados os seguintes parâmetros:

  • "lang": selecionar o idioma no qual pretende receber a informação. (Exemplo: "pt" ou "en").
  • "limit_last_alerts": limitar o número de alertas recentes a receber.

Parâmetros recebidos de cada alerta:

  • "idalerta": número identificativo, este número é exclusivo para cada alerta.
  • "codigo_tipo": número que identifica o tipo de alerta.
  • "tipo": tipo de alerta.
  • "titulo_aviso": título do alerta.
  • "aviso": texto do alerta.
  • "introdução": introdução ao aviso.
  • "g_oriental", "g_central" ou "g_ocidental: objetos com as características do alerta separados para os grupos Oriental, Central ou Oriental.
  • "precipitacao", "vento", "trovoada" ou "agitacao": arrays com objetos referentes à precipitação, vento, trovoada ou agitação marítima.
    • "codigo_cor": número que identifica a cor da previsão.
    • "cor": cor da previsão.
    • "dia_inicio": data de início da previsão.
    • "hora_inicio": hora de início da previsão.
    • "dia_fim": data de fim da previsão.
    • "hora_fim": hora de fim da previsão.
    • "texto": descrição da previsão.
    • "categoria": categoria da previsão.
  • "n_alerta": número do alerta (contador anual).
  • "data": data de lançamento do alerta.
  • "hora": array com hora, minuto e segundo de lançamento do alerta.
  • "parametros": tabela em html com os parâmetros meteorológicos ou sismológicos oficiais.
  • "medidasap": tabela em html com medidas de auto-proteção conforme as características do alerta.
  • "correcao": valor que identifica se o alerta é uma correção ou atualização de um alerta anterior.
  • "cap": link que fornece a informação do alerta em formato CAP.

Exemplo

Exemplo de dados fornecidos pela API de alertas:

URL: https://prociv.azores.gov.pt/alertas/api?lang=pt&limit_last_alerts=1

[
{
"idalerta": "1052",
"codigo_tipo": "1",
"tipo": "Aviso Meteorológico",
"titulo_aviso": "Aviso Meteorológico 35/2018",
"aviso": "Na sequência do aviso 35/2018, emitido pelo Instituto Português do Mar e Atmosfera que aqui se reproduz,",
"introducao": "Na sequência do",
"g_oriental": {
"precipitacao": [
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-14",
"hora_fim": "03:00",
"texto": "",
"categoria": "Precipitação"
}
],
"vento": [
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-14",
"hora_fim": "00:00",
"texto": "Direção de oeste.",
"categoria": "Vento"
}
],
"trovoada": [],
"agitacao": [
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-13",
"hora_inicio": "18:00",
"dia_fim": "2018-03-14",
"hora_fim": "09:00",
"texto": "Ondas de noroeste.",
"categoria": "Agitação Marítima"
}
]
},
"g_central": {
"precipitacao": [
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-14",
"hora_fim": "00:00",
"texto": "",
"categoria": "Precipitação"
}
],
"vento": [
{
"codigo_cor": "2",
"cor": "Laranja",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-14",
"hora_fim": "00:00",
"texto": "Rajada máxima - Direção de Oeste.",
"categoria": "Vento"
}
],
"trovoada": [],
"agitacao": [
{
"codigo_cor": "2",
"cor": "Laranja",
"dia_inicio": "2018-03-13",
"hora_inicio": "18:00",
"dia_fim": "2018-03-14",
"hora_fim": "03:00",
"texto": "Ondas de noroeste.",
"categoria": "Agitação Marítima"
},
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-14",
"hora_inicio": "03:00",
"dia_fim": "2018-03-14",
"hora_fim": "09:00",
"texto": "Ondas de noroeste.",
"categoria": "Agitação Marítima"
},
{
"codigo_cor": "1",
"cor": "Amarelo",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-13",
"hora_fim": "18:00",
"texto": "Ondas de noroeste.",
"categoria": "Agitação Marítima"
}
]
},
"g_ocidental": {
"precipitacao": [],
"vento": [
{
"codigo_cor": "2",
"cor": "Laranja",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-13",
"hora_fim": "21:00",
"texto": "Rajada máxima - Direção de Oeste.",
"categoria": "Vento"
}
],
"trovoada": [],
"agitacao": [
{
"codigo_cor": "2",
"cor": "Laranja",
"dia_inicio": "2018-03-13",
"hora_inicio": "15:00",
"dia_fim": "2018-03-13",
"hora_fim": "21:00",
"texto": "Ondas de noroeste.",
"categoria": "Agitação Marítima"
}
]
},
"n_alerta": "35/2018",
"data": "13 de Março de 2018",
"hora": [
"13",
"33",
"00"
],
"parametros": "
Os avisos do IPMA são emitidos de acordo com os seguintes parâmetros:
Vento
Velocidade Média
Amarelo Laranja Vermelho Unidade
65 a 74 75 a 87 >87 km/h
Vento
Rajada Máxima
Amarelo Laranja Vermelho Unidade
10 a 20 21 a 40 >40 mm/h
Precipitação
Chuva/Aguaceiro
Amarelo Laranja Vermelho Unidade
10 a 20 21 a 40 >40 mm/h
Agitação Marítima
Altura Significativa das Ondas
Amarelo Laranja Vermelho Unidade
6 a 7 8 a 9 >9 m
",
"medidasap": "
O Serviço Regional de Proteção Civil e Bombeiros dos Açores recomenda que sejam tomadas as seguintes medidas de autoproteção:
PRECIPITAÇÃO/VENTOS FORTES
• Verifique a validade dos seguros da sua casa e viatura e certifique-se que têm cobertura para fenómenos da natureza;
• Consolide telhados, portas e janelas;
• Corte ou pode as árvores próximas, que apresentem risco de queda. No caso de árvores de grande porte ou que não sejam propriedade sua, informe os serviços da sua autarquia;
• Mantenha limpos os sistemas de drenagem, bem como, os adjacentes à sua residência. Caso tenha conhecimento de uma situação que possa provocar danos, alerte as autoridades competentes;
• Guarde os objetos soltos do jardim e o caixote do lixo ou outros que possam ser projetados pelo vento. Um objeto, mesmo que leve, projetado por vento forte pode causar grandes prejuízos materiais e acidentes pessoais graves;
• Feche bem portas, janelas e persianas;
• Mantenha a sua viatura com o tanque de combustível cheio, pois poderá ter que fazer, nas suas deslocações, percursos maiores por via de estradas interrompidas ou intransitáveis;
• Abrigue os animais, particularmente os domésticos, pois são extremamente sensíveis a temporais;
• Dentro de casa, escolha um local seguro, afastado de portas e janelas, procurando não potenciar o risco;
• Se verificar que existem infiltrações, barulhos estranhos ou fendas nas paredes, contacte as autoridades. Pode ter de abandonar a sua residência;
• Se precisar sair de casa, desligue a eletricidade, o gás e a água. Essa medida contribui para evitar acidentes nos seus bens e nas forças de segurança. Leve o seu Kit de emergência, poderá necessitar dele;
• Se estiver fora de casa, procure abrigo, aguarde que o mau tempo passe;
• Não circule sem necessidade. Pode atrapalhar a circulação das forças de segurança e colocar em risco a sua segurança, nomeadamente, cair em buracos ocultados por lençóis de água;
• Em locais não pavimentados, redobre a sua atenção, pois as águas podem causar erosão dos solos, levando à queda de muros, taludes, postes, entre outros;
• Ligue o rádio, fique atento às recomendações difundidas e não contribua para a divulgação de boatos;
• Siga sempre as recomendações dos agentes das autoridades presentes, eles estão nos locais para o ajudar.
AGITAÇÃO MARÍTIMA
• Verifique a validade dos seguros da sua casa e/ou embarcação e certifique-se que tem cobertura para fenómenos da natureza;
• Reforce as amarrações da sua embarcação ou mude-a para local seguro;
• Tenha especial cuidado na circulação junto da orla costeira e zonas ribeirinhas. Afaste-se de áreas baixas junto à costa;
• Não pratique atividades relacionadas com o mar, nomeadamente, pesca desportiva, desportos náuticos, ou passeios à beira mar;
• Ligue o rádio e fique atento às recomendações difundidas e não contribua para a divulgação de boatos;
• Siga sempre as recomendações dos agentes das autoridades presentes, eles estão nos locais para o ajudar.
",
"correcao": "0",
"cap": "http://www.prociv.azores.gov.pt/cap/index?aviso=1052"
}
]

Para aceder às informações de um alerta no formato CAP, basta usar o URL que é fornecido nas informações do alerta através da API.

Para mais informações sobre o CAP consulte os seguintes links: