área

Recomendamos que a entidade <area> defina a área geográfica a ser notificada, não a área do incidente.

No caso de uma tempestade tropical, recomendamos que a entidade <area> contenha elementos <polygon> ou <geocode>, que indicam os lugares em que você espera impactos de ventos fortes, chuvas fortes ou outras ameaças de tempestade. Se uma tempestade ainda estiver fora da costa, não defina a entidade <area> do alerta CAP como o local atual da tempestade.

Da mesma forma, no caso de um incêndio florestal, recomendamos que os dados da entidade <area> também incluam cidades ou lugares onde você espera impactos de fumaça ou outras ameaças de incêndio.

Subelementos da entidade area

Nome do elemento Opcional Tipo CAP e observações e requisitos do Google
<areaDesc> REQUIRED string

Para gerar a string de texto do local usada no título ou alerta do alerta, o Google pode usar um elemento <areaDesc>. Mantenha o valor <areaDesc> curto (menos de 50 caracteres).

<polygon> OPCIONAL string

Os pontos de valor pareado em um elemento <polygon> definem um polígono que delineia a área para alertar em uma mensagem de alerta. Recomendamos que você represente o elemento <polygon> por uma lista delimitada por espaços em branco de pares de coordenadas WGS84.

Os polígonos devem atender aos seguintes requisitos:

  • Eles precisam ser fechados.
  • Eles não podem se sobrepor.
  • Buracos (como em polígonos em formato de rosca) e interseções não são suportados.
  • São necessários pelo menos quatro pares de coordenadas. O primeiro e o último pares de coordenadas precisam ser os mesmos.
<circle> OPCIONAL string

O elemento <circle> consiste em valores de ponto e raio pareados que delimitam a área para alertar na forma de uma mensagem de alerta. Recomendamos representar o elemento <circle> por um ponto central: um par de coordenadas WGS84 seguido por um caractere de espaço e um valor de raio em quilômetros.

Observação: se você especificar um círculo com um zero ou um raio muito pequeno, o Google não exibirá o alerta para nossos usuários.

<geocode> OPCIONAL string

Defina o elemento <geocode> com valores de um conjunto de dados de polígonos acessível e aberto. Por exemplo, nos EUA, esses valores vêm das seguintes fontes de dados:

  • FIPS6
  • Código UGC
  • MESMO
  • CEP dos EUA

Se você usar geocódigos, forneça ao Google uma lista fixa de mapas de geocódigos e polígonos. Para postar avisos sobre atualizações nesta lista, use um canal separado, de preferência como RSS ou alertas de e-mail. Por exemplo, a NOAA nos EUA publica publicamente as atualizações de geocódigo.

<altitude> OPCIONAL float

O valor do elemento <altitude> é a altitude específica ou mínima da área afetada da mensagem de alerta. Forneça essa medida a pés acima do nível médio do mar, de acordo com o dado WGS84.

<ceiling> CONDICIONAL float

Use o elemento <ceiling> somente se a entidade <alert> contiver um elemento <altitude>. O valor do elemento <ceiling> é a altitude máxima da área afetada da mensagem de alerta. Forneça essa medida em pés acima do nível médio do mar de acordo com o dado da WGS84.

Exemplo

<area>
    <areaDesc>Cavite</areaDesc>
    <polygon>14.473860833486,120.9718174024 14.347454023196,121.01386683476
     14.142014336735,121.03024107602 14.063075455227,120.85558468426
     14.221664765773,120.59001887699 14.473860833486,
     120.9718174024</polygon>
    <geocode>
        <valueName>SAME</valueName>
        <value>042100000</value>
    </geocode>
</area>

<area>
    <areaDesc>107 km SouthWest DENPASAR-BALI</areaDesc>
    <circle>-9.63,115.12 300.0</circle>
</area>