area

Consigliamo vivamente all'entità <area> di definire l'area geografica da notificare, non l'area dell'incidente.

In caso di tempesta tropicale, consigliamo che l'entità <area> contenga elementi <polygon> o <geocode> che indicano i luoghi in cui si prevede l'impatto di forti venti, forti piogge o altre minacce dovute alla tempesta. Se un temporale è ancora al largo, non impostare l'entità <area> dell'avviso CAP sulla posizione attuale del temporale.

Allo stesso modo, in caso di incendio boschivo, consigliamo che i dati dell'entità <area> includano anche le città o i luoghi in cui prevedi che l'incendio abbia impatto su fumo o altre minacce.

area elemento secondario entità

Nome elemento Facoltativo Tipo Note e requisiti di CAP e Google
<areaDesc> OBBLIGATORIA string

Per generare la stringa di testo della posizione utilizzata nel titolo o nel titolo dell'avviso, Google potrebbe utilizzare un elemento <areaDesc>. Utilizza un valore <areaDesc> breve (meno di 50 caratteri).

<polygon> FACOLTATIVO string

I punti di valore accoppiati in un elemento <polygon> definiscono un poligono che delinea l'area da avvisare in un messaggio di avviso. Ti consigliamo di rappresentare l'elemento <polygon> da un elenco delimitato da spazi vuoti di coppie di coordinate WGS84.

I poligoni devono soddisfare i seguenti requisiti:

  • Devono essere chiusi.
  • Non possono sovrapporsi.
  • I fori (come i poligoni a ciambella) e gli incroci non sono supportati.
  • Sono richieste almeno quattro coppie di coordinate. La prima e l'ultima coppia di coordinate devono essere uguali.
<circle> FACOLTATIVO string

L'elemento <circle> è costituito da valori di punti e raggi accoppiati che definiscono l'area da avvisare sotto forma di messaggio di avviso. Ti consigliamo di rappresentare l'elemento <circle> da un punto centrale: una coppia di coordinate WGS84 seguita da un carattere di spazio e un valore del raggio in chilometri.

Nota: se specifichi un cerchio con zero o un raggio molto piccolo, Google non può mostrare l'avviso agli utenti.

<geocode> FACOLTATIVO string

Definisci l'elemento <geocode> con i valori di un set di dati di poligoni accessibili e aperti. Negli Stati Uniti, ad esempio, questi valori provengono dalle seguenti origini dati:

  • FIPS
  • Codice dei contenuti generati dagli utenti
  • STESSO
  • Codice postale statunitense

Se utilizzi i codici geografici, fornisci a Google un elenco fisso di mappe con geocodifica a poligono e file di forma. Per pubblicare notifiche di aggiornamenti per questo elenco, utilizza un canale separato, preferibilmente come avvisi RSS o email. Ad esempio, la NOAA degli Stati Uniti pubblica pubblicamente i propri aggiornamenti geografici.

<altitude> FACOLTATIVO float

Il valore dell'elemento <altitude> è l'altitudine specifica o minima dell'area interessata del messaggio di avviso. Fornisci questa misura in piedi sopra il livello medio del mare in base al dato WGS84.

<ceiling> CONDIZIONATO float

Utilizza l'elemento <ceiling> solo se l'entità <alert> contiene un elemento <altitude>. Il valore dell'elemento <ceiling> indica l'altitudine massima dell'area interessata del messaggio di avviso. Fornisci questa misura in piedi sopra il livello medio del mare in base al dato WGS84.

Esempio

<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>