pole powierzchni

Zdecydowanie zalecamy, aby encja <area> określa obszar geograficzny, który ma zostać powiadomiony, a nie obszar incydentu.

W przypadku burzy tropikalnej zalecamy używanie w elemencie <area> elementów <polygon> lub <geocode>, które wskazują miejsca, w których można spodziewać się silnego wiatru, intensywnego deszczu lub innych zagrożeń. Jeśli burza jest nadal przybrzeżna, nie ustawiaj elementu <area> alertu CAP dla bieżącej lokalizacji burzy.

Podobnie w przypadku pożaru lasu zalecamy, aby dane dotyczące encji <area> obejmowały również miasta lub miejsca, w których spodziewasz się pożaru, oraz inne zagrożenia spowodowane ogniem.

area elementów podrzędnych

Nazwa elementu Opcjonalny Typ CAP oraz uwagi i wymagania Google
<areaDesc> WYMAGANE string

Aby wygenerować ciąg tekstowy lokalizacji użyty w tytule lub nagłówku alertu, Google może użyć elementu <areaDesc>. Wartość <areaDesc> powinna być krótka (mniej niż 50 znaków).
<polygon> OPCJONALNE string

Punkty wartości w elemencie <polygon> określają wielokąt oznaczający obszar alertu w alercie. Zalecamy reprezentowanie elementu <polygon> za pomocą listy rozdzielonych odstępami par współrzędnych WGS84.

Wielokąty muszą spełniać następujące wymagania:

  • Muszą być zamknięte.
  • Nie mogą się nakładać.
  • Otwory (np. wielokąty w kształcie pierścienia) i skrzyżowania nie są obsługiwane.
  • Wymagane są co najmniej 4 pary współrzędnych. Pierwsza i ostatnia para współrzędnych muszą być takie same.
<circle> OPCJONALNE string

Element <circle> składa się z połączonych wartości punktowych i promień, które wyznaczają obszar alertu w formie alertu. Zalecamy umieszczenie elementu <circle> w centralnym punkcie: pary WGS84 ze spacją, znakiem spacji i wartością promienia w kilometrach.

Uwaga: jeśli określisz okrąg o zerowej lub bardzo małym promieniu, Google nie będzie wyświetlać alertów użytkownikom.
<geocode> OPCJONALNE string

Zdefiniuj element <geocode> za pomocą wartości z dostępnego i otwartego zbioru wielokątów. W Stanach Zjednoczonych wartości te pochodzą z następujących źródeł danych:

  • FIPS6
  • Kod UGC
  • TAK
  • Kod pocztowy w USA

Jeśli korzystasz z transkodowania geograficznego, prześlij Google stałą listę map geograficznych do wielokątów i plików plików kształtu. Aby publikować powiadomienia o aktualizacjach na tej liście, użyj osobnego kanału, najlepiej w postaci alertów RSS lub e-maili z alertami. Na przykład amerykańska organizacja NOAA publikuje publicznie aktualizacje geograficzne.
<altitude> OPCJONALNE float

Wartość elementu <altitude> określa konkretną lub minimalną wysokość obszaru alertu. Podaj wynik pomiaru w stopach powyżej średniego poziomu morza, zgodnie z punktem odniesienia WGS84.
<ceiling> WARUNKOWA float

Używaj elementu <ceiling> tylko wtedy, gdy element <alert> zawiera element <altitude>. Wartość elementu <ceiling> to maksymalna wysokość obszaru alertu. Podaj wynik pomiaru w stopach powyżej średniego poziomu morza, zgodnie z punktem odniesienia WGS84.

Przykład

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