bilgi

<info> varlığı, uyarının ayrıntılarını belirtir. Uyarı için en az bir <info> bloğu gereklidir. Birden fazla dili destekliyorsanız aynı <alert> varlığında her dil için bir <info> bloku kullanmanızı öneririz.

info varlık öğesi

Aşağıdaki tabloda <info> varlığına ilişkin alt öğe değerleri açıklanmaktadır:

Öğe adı İsteğe bağlı Type CAP ve Google notları ve gereksinimleri
<language> İSTEĞE BAĞLI language

<language> kod değeri için geçerli bir RFC 3066 kullanmanızı öneririz.

<language> öğesi yoksa varsayılan değer en-US olur.
<category> ZORUNLU InfoCategory <category> kodu, uyarı mesajının konu etkinliği kategorisini belirtir. Etkinlikleriniz için doğru kategorileri tanımlamak isterseniz OASIS Etkinlik Şartları Listesi'ne bakın. Doğru sınıflandırma, Google'ın uyarıyı kullanıcılara daha doğru şekilde göstermesine yardımcı olabilir.
<event> ZORUNLU string

<event> öğesi, uyarı mesajının konu etkinliğinin türünü gösterir.

<event> öğesi için Google gereksinimleri aşağıdaki gibidir:

  • Uzunluğu 35 karakterden az yapın.
  • Bir CSV veya Google e-tablosunda önceden tanımlanmış bir <event> türü listeleyin (bu Google E-Tablolar örneğine bakın).
<responseType> İSTEĞE BAĞLI responseType

Doğru kitle için önerilen işlem türünü belirtmek üzere, uygun durumlarda karşılık gelen <instruction> öğesi değerinin yanı sıra bir <responseType> öğesi kullanmanızı önemle tavsiye ederiz.
<urgency> ZORUNLU urgency

Uyarıların ve göreceli sıralamaların dizine eklenmesi zor olduğundan, <urgency> öğesi için "Bilinmiyor" değerini kullanmayın.

Google'ın <urgency> alanının nasıl ve kim tarafından ayarlandığını bilmesi önemlidir. Ancak bu bilgiler, resmi profilin kapsamı dışındadır.

Yayıncı, tercihen <urgency> değerini her durumu ayrı ayrı ayarlar ve net tetikleyici kurallarına uyar. Bununla birlikte, <event> öğesi <urgency> değerini düzelterek uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, acil durum özelliğini etkinlik türüne göre statik olarak ayarlar.
<severity> ZORUNLU severity

Uyarıların ve göreceli sıralamaların dizine eklenmesi zor olduğundan, <severity> öğesi için "Bilinmiyor" değerini kullanmayın.

Google'ın <severity> alanının nasıl ve kim tarafından ayarlandığını bilmesi önemlidir. Ancak bu bilgiler, resmi profilin kapsamı dışındadır.

Yayıncı, tercihen <severity> değerini her durumu ayrı ayrı ayarlar ve net tetikleyici kurallarına uyar. Bununla birlikte, <event> öğesi <severity> değerini düzelterek uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, acil durum özelliğini etkinlik türüne göre statik olarak ayarlar.
<certainty> ZORUNLU certainty

Uyarıların ve göreceli sıralamaların dizine eklenmesi zor olduğundan, <certainty> öğesi için "Bilinmiyor" değerini kullanmayın.

Google'ın <certainty> alanının nasıl ve kim tarafından ayarlandığını bilmesi önemlidir. Ancak bu bilgiler resmi profilin kapsamı dışındadır.

Yayıncı, tercihen <certainty> değerini her durumu ayrı ayrı ayarlar ve net tetikleyici kurallarına uyar. Bununla birlikte, <event> öğesi <certainty> değerini düzelterek uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, acil durum özelliğini etkinlik türüne göre statik olarak ayarlar.
<audience> İSTEĞE BAĞLI string <audience> öğesinin değeri, uyarı mesajının hedef kitlesini açıklayan metindir.
<eventCode> İSTEĞE BAĞLI string

<eventCode> öğesi, aşağıdaki biçimdeki uyarı mesajının etkinlik türünü tanımlayan sisteme özgü kod içerir.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

Bu örnekte:

  • valueName = Kodun alanını belirten, kullanıcının atadığı bir dize. Bu dizeler kısaltmaysa tamamen nokta olmadan büyük harfle yazın. Örneğin SAME, FIPS ve ZIP.
  • value = <eventCode> öğesinin değerini belirten bir dize.

<info> bloğu içinde birden fazla <eventCode> öğesi örneği oluşabilir.

OASIS Etkinlik Şartları Listesi'nden <eventCode> öğe değerlerini almanızı önemle tavsiye ederiz. OASIS etkinlik terim listesini kullanıyorsanız değer adı olarak bu örnekte OET:v1.0 kullanın:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> İSTEĞE BAĞLI dateTime

<effective> öğesinin değeri, uyarı mesajındaki bilgilerin geçerli olduğu zamandır.

Saat dilimi alanlarını tüm dateTime değerlerine eklemeniz gerekir. <area> blokunda belirtilen konum tek bir saat dilimindeyse <effective> öğesinin bu bölgedeki zamanı belirtmesini öneririz. Uygun durumlarda Yaz saati uygulamasına izin verin.

Bir iletinin içeriği birden fazla saat dilimine uygulandığında ileti üreticisinin yerel saatler yerine UTC saat dilimini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, PDT saatiyle 16:49'u temsil eder.
<onset> İSTEĞE BAĞLI dateTime

<onset> öğesinin değeri, uyarı mesajının konu etkinliğinin başladığında beklenen süredir. Saat dilimi alanlarını tüm dateTime değerlerine eklemeniz gerekir.

<area> blokunda belirtilen konum tek bir saat dilimindeyse <effective> öğesinin bu bölgedeki zamanı belirtmesini öneririz. Uygun durumlarda yaz saati uygulamasına zaman ayırın.

Bir iletinin içeriği birden fazla saat dilimine uygulandığında ileti üreticisinin yerel saatler yerine UTC saat dilimini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, PDT saatiyle 16:49'u temsil eder.
<expires>

ZORUNLU*

 dateTime

<expires> öğesinin değeri, uyarı mesajının konu etkinliğinin geçerlilik süresidir. <expires> öğesi, <effective> öğesinden sonra sırayla gelmelidir.

Tüm uyarılarınız için süre sonu belirleyemiyorsanız, <expires> öğesi olmayan uyarılar için varsayılan bir son kullanma tarihi belirtin. Örneğin, <expires> öğesi yoksa varsayılan olarak tüm uyarılarınızın süresinin 48 saat sonra dolacak şekilde ayarlandığını belirtebilirsiniz.

Saat dilimi alanlarını tüm dateTime değerlerine eklemeniz gerekir. <area> blokunda belirtilen konum tek bir saat dilimindeyse <effective> öğesinin bu bölgedeki zamanı belirtmesini öneririz. Uygun durumlarda Yaz saati uygulamasına izin verin.

Bir iletinin içeriği birden fazla saat dilimine uygulandığında ileti üreticisinin yerel saatler yerine UTC saat dilimini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, PDT saatiyle 16:49'u temsil eder.
<senderName> İSTEĞE BAĞLI string

<senderName> öğesi isteğe bağlıdır ancak önemle tavsiye edilir.

Gönderen, kullanıcılar tarafından okunabilen bir ada sahipse <web> bağlantısı, yayıncının veya gönderenin tercihlerine göre kullanıcı dostu bir şekilde gösterilebilir. Ayrıca, <senderName> öğesi, uyarı toplayıcıların birden fazla yetkiliden yayın yapmasına olanak tanır.
<headline> İSTEĞE BAĞLI string

<headline> öğe dizelerinin uzunluğunu 140 karakterden az olacak şekilde ayarlayın.

<headline> dizesi açık metin olabilir ancak 140 karakterden kısa olmasını öneririz. (CAP. 1.2, kısa mesajlar için 160'tan az öneride bulunur.) Bu dizeye, uyarının temelini açıklayan birkaç açıklayıcı kelimeyle başlayın. Buna örnek olarak "Pononon Köprüsü'nün kapatılması..." verilebilir.

<headline> ve <description> öğeleri için aynı değerleri kullanmayın. <description> öğesinde, <headline> öğesine kıyasla daha fazla ayrıntı sağlayın.
<description>

ZORUNLU*

 string

<description> öğesinin değeri, uyarı mesajının konusunu açıklayan metindir.

Aşağıdaki soruların yanıtını bulabileceğiniz, okunabilir ve bilgilendirici içerikler öneririz:

  • Ne oluyor veya ne olacak?
  • Bu neden oluyor?
  • Ne kadar kötü?

Google, sayfamızın Mesaj bölümünü doldurmak için <description> öğesini, Önerilen işlemler bölümünü doldurmak için ise <instruction> öğesini kullanır. Her iki alan da kullanıcılar tarafından görülebilir.

Desteklenen Markdown etiketlerini kullanabilirsiniz: <newline>, <b> ve <a href>.
<instruction> İSTEĞE BAĞLI string

<instruction> öğesinin değeri, uyarı mesajının alıcıları için önerilen işlemleri açıklayan metindir. Okunabilir ve bilgilendirici içerik kullanmanızı öneririz.

Uyarı önem derecesine uyan ve genel olmayan işlemleri listeleyin. Kısa, büyük/küçük harfe duyarlı cümleler kullanın ve okuyucuların işlem yapabileceği, en önemli ipucunu içeren güvenlik ipuçlarını ekleyin.

<instruction> öğesi isteğe bağlıdır ancak önemle tavsiye edilir. Google Acil Durum Uyarıları, uyarı ayrıntıları sayfalarındaki Önerilen işlemler bölümünü doldurmak için <instruction> alanını kullanır. <instruction> ve <description> alan değerlerini farklı amaçlara hizmet ettikleri için farklı yapın.
<web>

ZORUNLU*

 string

<web> öğesini, web sunucunuzdan erişebileceğiniz orijinal uyarının bir kopyasına bağlayın.
<contact> İSTEĞE BAĞLI string

<contact> alanı isteğe bağlıdır. Ancak, kullanıcıların geri bildirim sağlamasına ve uyarıya yanıt vermesine olanak tanıyan bir yol olması nedeniyle bu alanın mevcut olması önemle tavsiye edilir. Örneğin, "Acil durumlarda 112'yi ara."
<parameter> İSTEĞE BAĞLI string

<parameter> öğesi, sisteme özgü verileri aşağıdaki biçimde içerir:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

Bu örnekte:

valueName = Kodun alanını belirten, kullanıcının atadığı bir dize.

value = Dize değeri.

<info> bloğu içinde bir <parameter> öğesinin birden fazla örneği oluşabilir.
<resource> İSTEĞE BAĞLI resource

<resource> öğesi, üst <info> öğesiyle ilgili ek ek bilgileri sağlar. <info> bloğu içinde bir <resource> öğesinin birden fazla örneği oluşabilir.
<area>

ZORUNLU*

 area

<area> öğesi, olay alanı yerine etkinliğin uyarı alanıyla ilgili bilgileri içerir. <area> blokları en az bir <circle>, <polygon> veya <geocode> öğesi içermelidir.

<geocode> öğesi yerine <polygon> veya <circle> öğesi kullanmanızı önemle tavsiye ederiz.

* 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

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>