uyarı

Geçerli bir etkinlikle ilgili temel bilgileri tanımlamak için <alert> öğesini kullanın.

Bir etkinlik aynı anda birden fazla devam eden konumu kaplıyorsa etkinliği birden fazla alert nesnesine bölmek daha iyidir. Örneğin, birden fazla eyaleti etkileyen bir orman yangını varsa uyarıları her eyalet için ayrı ayrı uyarılar olacak şekilde bölebilirsiniz. Böylece her eyalete özel acil durum bilgileri sağlayabilir ve yangın durumunu daha doğru bir şekilde güncelleyebilirsiniz.

Doğudan batıya doğru hareket eden bir kasırga gibi hızla değişen bir olay söz konusuysa uyarıyı düzenli olarak güncellemenizi öneririz. Mevcut uyarıyı feed'inizden kaldırmayın. Bunun yerine, önceki uyarıya atıfta bulunan yeni bir uyarı yayınlayın.

Özellikler

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

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

Öğe adı İsteğe bağlılık Tür Açıklama
xmlns:cap Zorunlu string

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

Örnek:

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

Öğeler

Tablo 2'de <alert> öğesinin alt öğe değerleri açıklanmaktadır:

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

Öğe adı İsteğe bağlılık Tür CAP ve Google ile ilgili notlar ve şartlar
<identifier> Zorunlu string Etkinliği temsil eden uyarının kimliğini sağlayın. <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ış karakterler içeremez.
<sent> Zorunlu dateTime

<area> bloğunda belirtilen konum tek bir saat dilimi içindeyse bu bölgedeki saati belirtmek için <sent> öğesini kullanın. Geçerli olduğu durumlarda yaz saati uygulamasına göre bir fark ekleyin.

Bir mesajın içeriği birden fazla saat diliminde geçerli olduğunda yerel saat yerine UTC saatlerini kullanın.
<status> Zorunlu AlertStatus

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

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

  • Önceki bir uyarıyı güncelleyen tüm uyarı mesajları UPDATE'i kullanır ve <references> öğesi değerlerini, <expires> tarihine ulaşmayan önceki tüm mesajlara ayarlar.
  • UPDATE veya CANCEL <msgType> öğesi, süresi dolmamış bir uyarı için geçerli olmalıdır. Bu nedenle, UPDATE veya CANCEL gönderildiğinde, ilgili tüm mesajlara ve süresi dolmamış uyarılara referans verilmelidir. <msgType>

Daha fazla bilgi için Etkinlik değişiklikleri veya süre sonu başlıklı makaleyi inceleyin.
<source> İsteğe bağlı string <source> öğesi, uyarının kaynağını belirtir. Operatör veya belirli bir cihaz buna örnek gösterilebilir.
<scope> Zorunlu AlertScope

<scope> öğesi, uyarı mesajının amaçlanan dağıtımını gösterir.
<restriction> KOŞULLU string <scope> öğesi değeri Restricted ise <restriction> öğesi gereklidir. Bu öğe, kısıtlanmış uyarı mesajının dağıtımını sınırlayan kuralı açıklar.
<addresses> KOŞULLU string <scope> öğesi değeri Private ise <addresses> öğesi gereklidir. Bu öğe, uyarı mesajının hedeflenen alıcısını listeler. Boşlukla ayrılmış birden fazla adres ekleyebilirsiniz ancak boşluk içeren adresleri çift tırnak içine almanız gerekir.
<code> İsteğe bağlı string

<code> öğesi, uyarı mesajının özel olarak işlendiğini gösterir.
<note> KOŞULLU string

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

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

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

Sisteminiz başka bir yayıncıdan CAP içeriğini yeniden yayınladığında tam CAP uyarısı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ğlı string <incidents> öğesi, aynı olayın farklı yönlerine atıfta bulunan birden fazla mesajı bir araya getirir.
<info>

ZORUNLU*

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

* Google, kalın ve kırmızı renkli ZORUNLU isteğe bağlılığı olan öğeleri zorunlu kılar 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>