Fläche

Die Entität <area> legt das zu benachrichtigende geografische Gebiet unbedingt fest und nicht das Gebiet des Vorfalls.

Bei einem tropischen Sturm empfehlen wir, dass die <area>-Entität <polygon>- oder <geocode>-Elemente enthält, die die Orte angeben, an denen Sie mit starken Winden, Starkregen oder anderen Stürmen rechnen. Sollte ein Sturm immer noch vor der Küste stehen, legen Sie die <area>-Entität der CAP-Benachrichtigung nicht auf den aktuellen Standort des Sturms fest.

Bei Waldbränden empfehlen wir, dass die <area>-Entitätsdaten auch Orte oder Orte einschließen, an denen Sie mit Rauch oder anderen Brandbedrohungen rechnen.

area Element-Unterelemente

Elementname Optionalität Typ CAP und Google-Notizen und -Anforderungen
<areaDesc> ERFORDERLICH string

Zum Generieren des Standorttextstrings, der im Titel oder Titel der Benachrichtigung verwendet wird, verwendet Google möglicherweise ein <areaDesc>-Element. Der <areaDesc>-Wert sollte möglichst kurz sein (weniger als 50 Zeichen).

<polygon> OPTIONAL string

Die gekoppelten Wertpunkte in einem <polygon>-Element definieren ein Polygon, das den Bereich definiert, der in einer Benachrichtigung angezeigt werden soll. Wir empfehlen, das <polygon>-Element durch eine durch Leerzeichen getrennte Liste von WGS84-Koordinatenpaaren darzustellen.

Polygone müssen die folgenden Anforderungen erfüllen:

  • Sie müssen geschlossen werden.
  • Sie dürfen sich nicht überschneiden.
  • Löcher (wie in Donut-förmigen Polygonen) und Kreuzungen werden nicht unterstützt.
  • Es sind mindestens vier Koordinatenpaare erforderlich. Das erste und das letzte Koordinatenpaar müssen identisch sein.
<circle> OPTIONAL string

Das <circle>-Element besteht aus gekoppelten Punkt- und Radiuswerten, die den Bereich festlegen, der in einer Benachrichtigung angegeben werden soll. Wir empfehlen, das <circle>-Element durch einen zentralen Punkt darzustellen: ein WGS84-Koordinatenpaar, gefolgt von einem Leerzeichen und einem Radiuswert in Kilometern.

Hinweis: Wenn Sie einen Kreis mit null oder einem sehr kleinen Radius angeben, kann Google die Benachrichtigung unseren Nutzern nicht anzeigen.

<geocode> OPTIONAL string

Definieren Sie das <geocode>-Element mit Werten aus einem zugänglichen und offenen Dataset von Polygonen. In den USA stammen diese Werte beispielsweise aus den folgenden Datenquellen:

  • FIPS6
  • Code für von Nutzern erstellte Inhalte
  • GLEICH
  • US-Postleitzahl

Wenn Sie Geocodes verwenden, müssen Sie Google eine feste Liste mit Geocoding-to-Polygon- und Shapefile-Karten zur Verfügung stellen. Wenn du Benachrichtigungen über Aktualisierungen dieser Liste posten möchtest, verwende einen separaten Kanal, idealerweise als RSS- oder E-Mail-Benachrichtigungen. Beispielsweise veröffentlicht die US NOAA ihre Geocoding-Updates öffentlich.

<altitude> OPTIONAL float

Der Wert des Elements <altitude> ist die spezifische oder minimale Höhe des betroffenen Bereichs der Benachrichtigung. Geben Sie diese Messung in Fuß über dem mittleren Meeresspiegel nach WGS84-Datum an.

<ceiling> ZUSTAND float

Verwenden Sie das Element <ceiling> nur, wenn die Entität <alert> ein <altitude>-Element enthält. Der Wert des Elements <ceiling> ist die maximale Höhe des betroffenen Bereichs der Benachrichtigung. Geben Sie diese Messung in Fuß über dem mittleren Meeresspiegel nach WGS84-Datum an.

Beispiel

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