Looking for help!
NAME
SemanticWeb::Schema::SpecialAnnouncement - A SpecialAnnouncement combines a simple date-stamped textual information update with contextualized Web links and other structured data
VERSION
version v7.0.0
DESCRIPTION
A SpecialAnnouncement combines a simple date-stamped textual information
update with contextualized Web links and other structured data. It
represents an information update made by a locally-oriented organization,
for example schools, pharmacies, healthcare providers, community groups,
police, local government.
The motivating scenario for
SpecialAnnouncement is the C
oronavirus pandemic, and the initial vocabulary is oriented to this
urgent situation. Schema.org expect to improve the markup iteratively as it
is deployed and as feedback emerges from use. In addition to our usual Github entry,
feedback comments can also be provided in this document.
While this schema is
designed to communicate urgent crisis-related information, it is not the
same as an emergency warning technology like CAP,
although there may be overlaps. The intent is to cover the kinds of
everyday practical information being posted to existing websites during an
emergency situation.
Several kinds of information can be
provided:
We encourage the provision of "name", "text",
"datePosted", "expires" (if appropriate) and "url" as a simple baseline. It
is important to provide a value for "category" where possible, most ideally
as a well known URL from Wikipedia or Wikidata. In the case of the
2019-2020 Coronavirus pandemic, this should be
"https://en.wikipedia.org/w/index.php?title=2019-20_coronavirus_pandemic"
or "https://www.wikidata.org/wiki/Q81068910".
For many of the
possible properties, values can either be simple links or an inline
description, depending on whether a summary is available. For a link,
provide just the URL of the appropriate page as the property's value. For
an inline description, use a WebContent type, and provide the
url as a property of that, alongside at least a simple "text" summary of the
page. It is unlikely that a single SpecialAnnouncement will need all of the
possible properties simultaneously. More options may be added later
if
We expect that in many cases the page referenced might contain
more specialized structured data, e.g. contact info, openingHours, Event, FAQPage etc. By
linking to those pages from a SpecialAnnouncement you
can help make it clearer that the events are related to the situation (e.g.
Coronavirus) indicated by the category property of the SpecialAnnouncement.
<
br/> The basic content of SpecialAnnouncement is
similar to that of an RSS
or Atom
feed. For publishers without such feeds, basic feed-like information can be
shared by posting SpecialAnnouncement
updates in a page, e.g. using JSON-LD. For sites with Atom/RSS
functionality, you can point to a feed with the webFeed property. This can be a simple
URL, or an inline DataFeed object, with encodingFormat providing media
type information e.g. "application/rss+xml" or
"application/atom+xml".
For an announcement that is about a
place, you can use about (or mainEntity) to make that
relationship explicit. For example, the announcement could be "about" a new
CovidTestingFacility, and
provide contact information, location, geo, openingHours etc.
ATTRIBUTES
category
A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.
A category should be one of the following types:
InstanceOf['SemanticWeb::Schema::PhysicalActivityCategory']
InstanceOf['SemanticWeb::Schema::Thing']
Str
_has_category
A predicate for the "category" attribute.
disease_prevention_info
diseasePreventionInfo
Information about disease prevention.
A disease_prevention_info should be one of the following types:
_has_disease_prevention_info
A predicate for the "disease_prevention_info" attribute.
disease_spread_statistics
diseaseSpreadStatistics
Statistical information about the spread of a disease, either as WebContent, or described directly as a Dataset, or the specific Observations in the dataset. When a WebContent URL is provided, the page indicated might also contain more such markup.
A disease_spread_statistics should be one of the following types:
InstanceOf['SemanticWeb::Schema::Dataset']
InstanceOf['SemanticWeb::Schema::Observation']
InstanceOf['SemanticWeb::Schema::WebContent']
Str
_has_disease_spread_statistics
A predicate for the "disease_spread_statistics" attribute.
getting_tested_info
gettingTestedInfo
Information about getting tested (for a MedicalCondition), e.g. in the context of a pandemic.
A getting_tested_info should be one of the following types:
_has_getting_tested_info
A predicate for the "getting_tested_info" attribute.
news_updates_and_guidelines
newsUpdatesAndGuidelines
Indicates a page with news updates and guidelines. This could often be (but is not required to be) the main page containing SpecialAnnouncement markup on a site.
A news_updates_and_guidelines should be one of the following types:
_has_news_updates_and_guidelines
A predicate for the "news_updates_and_guidelines" attribute.
public_transport_closures_info
publicTransportClosuresInfo
Information about public transport closures.
A public_transport_closures_info should be one of the following types:
_has_public_transport_closures_info
A predicate for the "public_transport_closures_info" attribute.
quarantine_guidelines
quarantineGuidelines
Guidelines about quarantine rules, e.g. in the context of a pandemic.
A quarantine_guidelines should be one of the following types:
_has_quarantine_guidelines
A predicate for the "quarantine_guidelines" attribute.
school_closures_info
schoolClosuresInfo
Information about school closures.
A school_closures_info should be one of the following types:
_has_school_closures_info
A predicate for the "school_closures_info" attribute.
travel_bans
travelBans
Information about travel bans, e.g. in the context of a pandemic.
A travel_bans should be one of the following types:
_has_travel_bans
A predicate for the "travel_bans" attribute.
SEE ALSO
SemanticWeb::Schema::CreativeWork
SOURCE
The development version is on github at https://github.com/robrwo/SemanticWeb-Schema and may be cloned from git://github.com/robrwo/SemanticWeb-Schema.git
BUGS
Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/SemanticWeb-Schema/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
AUTHOR
Robert Rothenberg <rrwo@cpan.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2018-2020 by Robert Rothenberg.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)