bilgi

<info> öğesi, 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> öğesi için her dil için bir <info> bloğu kullanmanızı öneririz.

info varlık öğeleri

Aşağıdaki tabloda <info> öğesinin alt öğe değerleri açıklanmaktadır:

Öğe adı İsteğe bağlılık Tür CAP ve Google ile ilgili notlar ve şartlar
<language> İsteğe bağlı language

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

<language> öğesi mevcut değilse varsayılan değer en-US olur.
<category> Zorunlu InfoCategory <category> kodu, uyarı mesajının konu etkinliğinin kategorisini belirtir. Etkinlikleriniz için doğru kategorileri belirlemek amacıyla OASIS Etkinlik Terimleri Listesi'ne bakın. Doğru kategorizasyon, Google'ın uyarıyı kullanıcılara daha doğru bir şekilde göstermesine yardımcı olabilir.
<event> Zorunlu string

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

<event> öğesi için Google koşulları aşağıda belirtilmiştir:

  • Uzunluğu 35 karakterden kısa tutun.
  • Bir CSV veya Google e-tablosunda önceden tanımlanmış <event> türlerinin listesini oluşturun (bu Google E-Tablolar örneğine bakın).
<responseType> İsteğe bağlı responseType

Uygun olduğunda doğru kitle için önerilen işlem türünü belirtmek üzere, <responseType> öğesini ve bu öğeye karşılık gelen <instruction> öğe değerini kullanmanız önemle tavsiye edilir.
<urgency> Zorunlu urgency

Uyarıların ve göreceli sıralamaların dizine eklenmesini zorlaştırdığı için <urgency> öğesi için Bilinmiyor değerini kullanmayın.

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

Yayıncının <urgency> değerini her duruma göre ayarlaması ve net tetikleyici yönergelerine uyması tercih edilir. Ancak <event> öğesi, <urgency> değerini sabitleyebilir ve böylece uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, aciliyeti etkinlik türüne göre statik olarak belirler.
<severity> Zorunlu severity

Uyarıların ve göreceli sıralamaların dizine eklenmesini zorlaştırdığı için <severity> öğesi için Bilinmiyor değerini kullanmayın.

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

Yayıncının <severity> değerini her duruma göre ayarlaması ve net tetikleyici yönergelerine uyması tercih edilir. Ancak <event> öğesi, <severity> değerini sabitleyebilir ve böylece uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, aciliyeti etkinlik türüne göre statik olarak belirler.
<certainty> Zorunlu certainty

Uyarıların ve göreceli sıralamaların dizine eklenmesini zorlaştırdığı için <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ının <certainty> değerini her duruma göre ayarlaması ve net tetikleyici yönergelerine uyması tercih edilir. Ancak <event> öğesi, <certainty> değerini sabitleyebilir ve böylece uyarı yazarlarının esnekliğini azaltabilir. Örneğin, ABD'deki NOAA, aciliyeti etkinlik türüne göre statik olarak belirler.
<audience> İsteğe bağlı string <audience> öğesinin değeri, uyarı mesajının hedeflenen kitlesini açıklayan metindir.
<eventCode> İsteğe bağlı string

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

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

Bu örnekte:

  • valueName = Kodun alanını belirten, kullanıcı tarafından atanan bir dize. Bu dizeler kısaltma ise nokta olmadan tüm harfleri büyük olacak şekilde gösterin. Örnekler: SAME, FIPS ve ZIP.
  • value = <eventCode> öğesinin değerini belirten bir dize.

Bir <info> bloğunda birden fazla <eventCode> öğesi bulunabilir.

<eventCode> öğe değerlerini OASIS Etkinlik Terimleri Listesinden almanızı önemle tavsiye ederiz. OASIS etkinlik terimi listesini kullanıyorsanız değer adı olarak bu örnekte gösterildiği gibi OET:v1.2 değerini kullanın:

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> İsteğe bağlı dateTime

<effective> öğesinin değeri, uyarı mesajındaki bilgilerin geçerlilik süresidir.

Tüm dateTime değerlerine saat dilimi alanları eklemeniz gerekir. <area> bloğunda belirtilen konum tek bir saat dilimi içindeyse <effective> öğesinin bu bölgedeki saati belirtmesini öneririz. Geçerli olduğu durumlarda yaz saati uygulamasına göre bir fark ekleyin.

Bir mesajın içeriği birden fazla saat dilimine uygulandığında, mesajın üreticisinin yerel saat yerine UTC saatlerini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, 16:49 (PDT) anlamına gelir.
<onset> İsteğe bağlı dateTime

<onset> öğesinin değeri, uyarı mesajının konu etkinliğinin başlayacağı beklenen zamandır. Tüm dateTime değerlerine saat dilimi alanlarını dahil etmeniz gerekir.

<area> bloğunda belirtilen konum tek bir saat dilimine aitse <effective> öğesinin bu bölgedeki saati belirtmesini öneririz. Geçerli olduğu durumlarda yaz saati uygulaması için bir izin ekleyin.

Bir mesajın içeriği birden fazla saat dilimine uygulandığında, mesajın üreticisinin yerel saat yerine UTC saatlerini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, 16:49 (PDT) anlamına gelir.
<expires>

ZORUNLU*

 dateTime

<expires> öğesinin değeri, uyarı mesajının konu etkinliğinin son kullanma zamanıdır. <expires> öğesi, zaman sırasına göre <effective> öğesinden sonra gelmelidir.

Tüm uyarılarınız için son kullanma zamanı belirleyemiyorsanız <expires> öğesi olmayan tüm uyarılar için Google'a varsayılan bir son kullanma zamanı sağlayın. Örneğin, <expires> öğesi yoksa varsayılan olarak tüm uyarılarınızın 48 saat sonra geçerliliğini yitireceğini belirtebilirsiniz.

Tüm dateTime değerlerine saat dilimi alanları eklemeniz gerekir. <area> bloğunda belirtilen konum tek bir saat dilimi içindeyse <effective> öğesinin bu bölgedeki saati belirtmesini öneririz. Geçerli olduğu durumlarda yaz saati uygulamasına göre bir fark ekleyin.

Bir mesajın içeriği birden fazla saat dilimine uygulandığında, mesajın üreticisinin yerel saat yerine UTC saatlerini kullanmasını öneririz.

Örnek:

2002-05-24T16:49:00-07:00, 24 Mayıs 2002, 16:49 (PDT) anlamına gelir.
<senderName> İsteğe bağlı string

<senderName> öğesi isteğe bağlıdır ancak kesinlikle önerilir.

Gönderenin okunabilir bir adı varsa <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ğlı string

<headline> öğesi dizelerinin uzunluğunu 140 karakterden kısa yapı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 önerir.) Bu dizeye, uyarının temelini açıklayan birkaç açıklayıcı kelimeyle başlayın. Örneğin, "Pontoon köprü kapatıldı...."

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

ZORUNLU*

 string

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

Aşağıdaki soruları yanıtlayan, kullanıcıların okuyabileceği ve bilgilendirici içerikler eklemenizi öneririz:

  • Neler oluyor veya ne olacak?
  • Where is it happening?
  • Durum 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ğlı string

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

Uyarı önem düzeyine uygun ve genel olmayan işlemleri listeleyin. Kısa ve büyük/küçük harf duyarlı cümleler kullanın. Okuyucuların uygulayabileceği güvenlik ipuçları ekleyin. En önemli ipuçlarını önce 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. Farklı amaçlara hizmet ettikleri için <instruction> ve <description> alan değerlerini farklı yapın.
<web>

İsteğe bağlı

 string

<web> öğesini, uyarınız hakkında daha fazla bilgi sağlayan çalışan bir URL'ye bağlayın.
<contact> İsteğe bağlı string

<contact> alanı isteğe bağlıdır ancak kullanıcıların geri bildirim vermesi ve uyarıya yanıt vermesi için bir yol sağladığı için bu alanın eklenmesini önemle tavsiye ederiz. Örneğin, "Acil durumlarda 911'i arayın."
<parameter> İsteğe bağlı string

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

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

Bu örnekte:

valueName = Kodun alanını belirten, kullanıcı tarafından atanan bir dize.

value = Dize değeri.

Bir <info> bloğunda birden fazla <parameter> öğesi bulunabilir.
<resource> İsteğe bağlı resource

<resource> öğesi, üst <info> öğeyle ilgili ek bilgileri sağlar. Bir <info> bloğunda birden fazla <resource> öğesi bulunabilir.
<area>

ZORUNLU*

 area

<area> öğesi, olay alanı değil, etkinliğin uyarı alanı hakkında bilgi içerir. <area> blokları en az bir <circle>, <polygon> veya <geocode> öğesi içermelidir.

<geocode> öğesi yerine <polygon> veya <circle> öğesinin kullanılmasını önemle tavsiye ederiz.

* 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

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