uyarı

Mevcut bir etkinlikle ilgili temel bilgileri tanımlamak için <alert> varlığını kullanın.

Bir etkinlik aynı anda birden fazla devam eden konumda oluyorsa etkinliği birden fazla alert nesnesine bölmek daha iyidir. Örneğin, orman yangını birden fazla eyalete yayılıyorsa uyarıları, her durum için bir tane olacak şekilde birden fazla uyarıya bölebilirsiniz. Bu şekilde, her eyalete belirli acil durum bilgilerini verirsiniz ve yangın durumunu daha doğru şekilde güncellersiniz.

Bir olay, doğudan batıya uzanan bir kasırga gibi hızla değişirse, uyarıda düzenli olarak güncelleme yapmanızı öneririz. Mevcut uyarıyı feed'inizden kaldırmayın. Bunun yerine, önceki uyarıya referans veren yeni bir uyarı yayınlayın.

Özellikler

Tablo 1'de, <alert> varlığının özellik değeri açıklanmaktadır:

Tablo 1. <alert> varlık özelliği

Öğe adı İsteğe bağlı Type Açıklama
xmlns:cap ZORUNLU string

xmlns özelliği, ad alanı olarak CAP URN'a referans vermelidir.

Örnek:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

Öğeler

Tablo 2'de <alert> varlığına ilişkin alt öğe değerleri açıklanmaktadır:

Tablo 2. <alert> varlık öğesi

Öğe adı İsteğe bağlı Type CAP ve Google notları ve gereksinimleri
<identifier> ZORUNLU string Etkinliği temsil eden uyarının kimliğini belirtin. <identifier> öğesinin değeri tüm etkinliklerde benzersiz olmalıdır.
<sender> ZORUNLU string <sender> öğesi, uyarının kaynağını tanımlar. Boşluk, virgül veya kısıtlanmış karakter içeremez.
<sent> ZORUNLU dateTime

<area> blokunda belirtilen konum tek bir saat dilimindeyse bu bölgedeki zamanı belirtmek için <sent> öğesini kullanın. Uygun durumlarda yaz saati uygulamasına zaman ayırın.

Bir mesajın içeriği birden fazla saat dilimine uygulandığında yerel saatlere tercih olarak UTC saatlerini kullanın.
<status> ZORUNLU AlertStatus

Google yalnızca değeri <status> olan Actual herkese açık uyarıları yayınlar.
<msgType> ZORUNLU AlertMsgType

UPDATE veya CANCEL <msgType> en az bir <references> öğesi içermelidir. CAP standardı aşağıdakileri belirtir:

  • Önceki bir uyarıyı güncelleyen uyarı mesajları, GÜNCELLE'yi kullanır ve <expires> öğelerine ulaşmamış tüm eski mesajlara <references> öğe değeri ayarlar.
  • UPDATE veya CANCEL <msgType> öğesi, süresi dolmamış bir uyarıya uygulanmalıdır. Bu nedenle, UPDATE veya CANCEL <msgType> yayınlandığında ilgili tüm mesajlara ve süresi dolmamış uyarılara referans verilmelidir.

Daha fazla bilgi için Etkinlik değişiklikleri veya süre sonu bölümüne bakın.
<source> İSTEĞE BAĞLI string <source> öğesi, uyarının belirli bir kaynağını belirtir. Buna örnek olarak bir operatör veya belirli bir cihaz verilebilir.
<scope> ZORUNLU AlertScope

<scope> öğesi, uyarı mesajının amaçlanan dağılımını gösterir.
<restriction> KOŞUL string <scope> öğesi değeri Restricted ise <restriction> öğesi gerekir. Bu öğede, kısıtlanmış uyarı mesajının dağıtımını sınırlandırma kuralı açıklanmaktadır.
<addresses> KOŞUL string <scope> öğesi değeri Private ise <addresses> öğesi gerekir. Bu öğe, uyarı mesajının hedeflenen alıcısını listeler. Birden fazla boşlukla ayrılmış adres ekleyebilirsiniz, ancak boşluk içeren adresleri çift tırnak içine almanız gerekir.
<code> İSTEĞE BAĞLI string

<code> öğesi, uyarı mesajının özel olarak işlenmesini belirtir.
<note> KOŞUL string

Uyarı aşağıdaki öğe değerlerinden birini içeriyorsa <note> öğesi gerekir:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> KOŞUL string

<msgType> öğesi değeri UPDATE veya CANCEL ise <references> öğesi zorunludur.

Sisteminiz başka bir yayıncının CAP içeriğini yeniden yayınladığında CAP uyarısının tamamını ekleyin. Düzenlenen içeriği orijinal kaynağa bağlamak için <references> etiketini kullanın.

Birden fazla mesaja referans veriyorsanız sınırlayıcı olarak boşluk kullanın.
<incidents> İSTEĞE BAĞLI string <incidents> öğesi, aynı olayın farklı yönlerine işaret eden birden fazla mesaj birleştirir.
<info>

ZORUNLU*

 info En az bir <info> öğesi bulunmalıdır. Birden fazla <info> blokunun tümü aynı <category> ve <event> öğe değerlerine sahip olmalıdır.

* Google, kalın ve kırmızı ZORUNLU seçeneğine sahip öğelerin kullanılmasını gerektirir. Ancak bu öğeler CAP standardında isteğe bağlıdır.

Örnek

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>