área

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

No caso de uma tempestade tropical, recomendamos que a entidade <area> contenha elementos <polygon> ou <geocode> que indiquem os lugares onde você espera impactos de ventos fortes, chuva forte ou outras ameaças da tempestade. Se uma tempestade ainda estiver no mar, não defina a entidade <area> do alerta de CAP para 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 da fumaça ou outras ameaças do incêndio.

Subelementos de entidade area

Nome do elemento Opcionalidade Tipo CAP e notas e requisitos do Google
<areaDesc> OBRIGATÓRIO string

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

Os pontos de valor pareados em um elemento <polygon> definem um polígono que delimita a área a ser alertada em uma mensagem de alerta. Recomendamos que você represente o elemento <polygon> por uma lista delimitada por espaço de pares de coordenadas WGS84.

Os polígonos precisam atender aos seguintes requisitos:

  • Eles precisam estar fechados.
  • Eles não podem se sobrepor.
  • Não há suporte para furos (como em polígonos em forma de rosquinha) e interseções.
  • É necessário ter pelo menos quatro pares de coordenadas. O primeiro e o último pares de coordenadas precisam ser iguais.
<circle> OPCIONAL string

O elemento <circle> consiste em valores de ponto e raio pareados que delimitam a área a ser alertada na forma de uma mensagem de alerta. Recomendamos que você represente 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 raio zero ou muito pequeno, o Google não poderá mostrar o alerta aos 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 do UGC
  • SAME
  • CEP dos EUA

Se você usar geocódigos, forneça ao Google uma lista fixa de mapas de geocódigo para polígono e shapefile. Para postar avisos de atualizações nessa lista, use um canal separado, de preferência como alertas por RSS ou e-mail. Por exemplo, a NOAA dos 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 em pés acima do nível médio do mar de acordo com o datum 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 pela mensagem de alerta. Forneça essa medida em pés acima do nível médio do mar de acordo com o datum 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>