area

Consigliamo vivamente che l'entità <area> definisse l'area geografica per la quale deve essere inviata la notifica, non l'area dell'incidente.

In caso di tempesta tropicale, ti consigliamo che l'entità <area> contenga elementi <polygon> o <geocode> che indichino i luoghi in cui prevedi impatti dovuti a forti venti, piogge intense o altre minacce della tempesta. Se una tempesta è ancora al largo, non impostare l'entità <area> dell'avviso CAP sulla posizione attuale della tempesta.

Analogamente, in caso di incendio boschivo, consigliamo di includere nei dati dell'entità <area> anche le città o i luoghi in cui si prevedono impatti dovuti al fumo o ad altre minacce dell'incendio.

Elementi secondari dell'entità area

Nome elemento Facoltatività Tipo Note e requisiti di CAP e Google
<areaDesc> OBBLIGATORIO string

Per generare la stringa di testo della località utilizzata nel titolo o nell'intestazione dell'avviso, Google potrebbe utilizzare un elemento <areaDesc>. Mantieni il valore <areaDesc> breve (meno di 50 caratteri).
<polygon> FACOLTATIVO string

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

I poligoni devono soddisfare i seguenti requisiti:

  • Devono essere chiusi.
  • Non possono sovrapporsi.
  • I buchi (ad esempio nei poligoni a forma di ciambella) e le intersezioni non sono supportati.
  • Sono necessarie almeno quattro coppie di coordinate. Le prime e le ultime coppie di coordinate devono essere uguali.
<circle> FACOLTATIVO string

L'elemento <circle> è costituito da valori di punto e raggio accoppiati che delimitano l'area da segnalare sotto forma di messaggio di avviso. Ti consigliamo di rappresentare l'elemento <circle> con un punto centrale: una coppia di coordinate WGS84 followed da uno spazio e un valore del raggio in chilometri.

Nota: se specifichi un cerchio con raggio pari a zero o molto piccolo, Google non può mostrare l'avviso ai suoi utenti.
<geocode> FACOLTATIVO string

Definisci l'elemento <geocode> con i valori di un insieme di dati di poligoni accessibile e aperto. Ad esempio, negli Stati Uniti, questi valori provengono dalle seguenti origini dati:

  • FIPS6
  • Codice CGU
  • SAME
  • Codice postale degli Stati Uniti

Se utilizzi i codici geografici, fornisci a Google un elenco fisso di mappe da codice geografico a poligono e shapefile. Per pubblicare avvisi relativi agli aggiornamenti di questo elenco, utilizza un canale separato, preferibilmente tramite RSS o avvisi via email. Ad esempio, la NOAA degli Stati Uniti pubblica pubblicamente i propri aggiornamenti dei codici geografici.
<altitude> FACOLTATIVO float

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

Utilizza l'elemento <ceiling> solo se l'entità <alert> contiene un elemento <altitude>. Il valore dell'elemento <ceiling> è l'altitudine massima dell'area interessata del messaggio di avviso. Fornisci questa misurazione in piedi sopra il livello medio del mare in base al datum 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>