pole powierzchni

Zdecydowanie zalecamy, aby podmiot <area> zdefiniował obszar geograficzny, na który mają być wysyłane powiadomienia, a nie obszar zdarzenia.

W przypadku burzy tropikalnej zalecamy, aby element <area> zawierał elementy <polygon> lub <geocode>, które wskazują miejsca, w których spodziewasz się wpływu silnego wiatru, intensywnych opadów lub innych zagrożeń związanych z burzami. Jeśli burza znajduje się jeszcze na morzu, nie ustawiaj elementu <area> w alertach CAP na bieżącą lokalizację burzy.

Podobnie w przypadku pożaru lasu zalecamy, aby dane dotyczące elementu <area> obejmowały też miasta lub miejsca, w których spodziewasz się wpływu dymu lub innych zagrożeń związanych z pożarem.

Podelementy elementu area

Nazwa elementu Opcjonalność Typ Wskazówki i wymagania dotyczące Google i CAP
<areaDesc> WYMAGANE string

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

Pary wartości w elemencie <polygon>określają wielokąt, który wyznacza obszar, w którym ma być wyświetlany alert w wiadomości. Element <polygon> zalecamy reprezentować za pomocą listy par współrzędnych WGS84 oddzielonych spacjami.

Wielokąty muszą spełniać te wymagania:

  • Muszą być zamknięte.
  • Nie mogą się pokrywać.
  • Nie są obsługiwane otwory (np. w wielokątach w kształcie pączka) ani przecięcia.
  • Wymagane jest co najmniej 4 par współrzędnych. Pierwsza i ostatnia para współrzędnych musi być taka sama.
<circle> OPCJONALNE string

Element <circle> składa się z par wartości punktu i promienia, które wyznaczają obszar, w którym ma być wyświetlany komunikat ostrzeżenia. Zalecamy reprezentowanie elementu <circle> za pomocą punktu środkowego: pary współrzędnych WGS84, po której następuje spacja i wartość promienia w kilometrach.

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

Zdefiniuj element <geocode> za pomocą wartości z dostępnego i otwartego zbioru danych z poligonów. Na przykład w Stanach Zjednoczonych wartości te pochodzą z tych źródeł danych:

  • FIPS6
  • Kod UGC
  • SAME
  • Kod pocztowy USA

Jeśli używasz geokodów, prześlij do Google stałą listę map geokodów na poligony i map shapefile. Aby publikować powiadomienia o aktualizacjach tej listy, użyj oddzielnego kanału, najlepiej w formie alertów RSS lub e-maili. Na przykład amerykańska NOAA publikuje publicznie aktualizacje geokodów.
<altitude> OPCJONALNE float

Wartość elementu <altitude> to konkretna lub minimalna wysokość obszaru objętego alertem. Podaj ten pomiar w stopach nad poziom morza według układu WGS84.
<ceiling> WARUNKOWY float

Używaj elementu <ceiling> tylko wtedy, gdy element <alert> zawiera element <altitude>. Wartość elementu <ceiling> to maksymalna wysokość obszaru objętego alertem. Podaj ten pomiar w stopach względem średniego poziomu morza według danych 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>