247 lines
11 KiB
JSON
247 lines
11 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "schema:SpecialAnnouncement",
|
|
"title": "SpecialAnnouncement",
|
|
"description": "A SpecialAnnouncement combines a simple date-stamped textual information update\n with contextualized Web links and other structured data. It represents an information update made by a\n locally-oriented organization, for example schools, pharmacies, healthcare providers, community groups, police,\n local government.\n\nFor work in progress guidelines on Coronavirus-related markup see [this doc](https://docs.google.com/document/d/14ikaGCKxo50rRM7nvKSlbUpjyIk2WMQd3IkB1lItlrM/edit#).\n\nThe motivating scenario for SpecialAnnouncement is the [Coronavirus pandemic](https://en.wikipedia.org/wiki/2019%E2%80%9320_coronavirus_pandemic), and the initial vocabulary is oriented to this urgent situation. Schema.org\nexpect to improve the markup iteratively as it is deployed and as feedback emerges from use. In addition to our\nusual [Github entry](https://github.com/schemaorg/schemaorg/issues/2490), feedback comments can also be provided in [this document](https://docs.google.com/document/d/1fpdFFxk8s87CWwACs53SGkYv3aafSxz_DTtOQxMrBJQ/edit#).\n\n\nWhile this schema is designed to communicate urgent crisis-related information, it is not the same as an emergency warning technology like [CAP](https://en.wikipedia.org/wiki/Common_Alerting_Protocol), although there may be overlaps. The intent is to cover\nthe kinds of everyday practical information being posted to existing websites during an emergency situation.\n\nSeveral kinds of information can be provided:\n\nWe encourage the provision of \"name\", \"text\", \"datePosted\", \"expires\" (if appropriate), \"category\" and\n\"url\" as a simple baseline. It is important to provide a value for \"category\" where possible, most ideally as a well known\nURL 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\".\n\nFor 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\nunlikely that a single SpecialAnnouncement will need all of the possible properties simultaneously.\n\nWe 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]].\n\nMany [[SpecialAnnouncement]]s will relate to particular regions and to identifiable local organizations. Use [[spatialCoverage]] for the region, and [[announcementLocation]] to indicate specific [[LocalBusiness]]es and [[CivicStructure]]s. If the announcement affects both a particular region and a specific location (for example, a library closure that serves an entire region), use both [[spatialCoverage]] and [[announcementLocation]].\n\nThe [[about]] property can be used to indicate entities that are the focus of the announcement. We now recommend using [[about]] only\nfor representing non-location entities (e.g. a [[Course]] or a [[RadioStation]]). For places, use [[announcementLocation]] and [[spatialCoverage]]. Consumers of this markup should be aware that the initial design encouraged the use of [[about]] for locations too.\n\nThe basic content of [[SpecialAnnouncement]] is similar to that of an [RSS](https://en.wikipedia.org/wiki/RSS) or [Atom](https://en.wikipedia.org/wiki/Atom_(Web_standard)) feed. For publishers without such feeds, basic feed-like information can be shared by posting\n[[SpecialAnnouncement]] updates in a page, e.g. using JSON-LD. For sites with Atom/RSS functionality, you can point to a feed\nwith the [[webFeed]] property. This can be a simple URL, or an inline [[DataFeed]] object, with [[encodingFormat]] providing\nmedia type information, e.g. \"application/rss+xml\" or \"application/atom+xml\".\n",
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"description": "The most generic kind of creative work, including books, movies, photographs, software programs, etc.",
|
|
"$ref": "schema:CreativeWork"
|
|
}
|
|
],
|
|
"properties": {
|
|
"announcementLocation": {
|
|
"description": "Indicates a specific [[CivicStructure]] or [[LocalBusiness]] associated with the SpecialAnnouncement. For example, a specific testing facility or business with special opening hours. For a larger geographic region like a quarantine of an entire region, use [[spatialCoverage]].",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "$ref": "schema:CivicStructure" },
|
|
{ "$ref": "schema:LocalBusiness" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "$ref": "schema:CivicStructure" },
|
|
{ "$ref": "schema:LocalBusiness" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"category": {
|
|
"description": "A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:CategoryCode" },
|
|
{ "$ref": "schema:PhysicalActivityCategory" },
|
|
{ "$ref": "schema:Thing" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:CategoryCode" },
|
|
{ "$ref": "schema:PhysicalActivityCategory" },
|
|
{ "$ref": "schema:Thing" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"datePosted": {
|
|
"description": "Publication date of an online listing.",
|
|
"anyOf": [
|
|
{ "type": "string", "format": "date" },
|
|
{ "type": "string", "format": "date-time" }
|
|
]
|
|
},
|
|
"diseasePreventionInfo": {
|
|
"description": "Information about disease prevention.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"diseaseSpreadStatistics": {
|
|
"description": "Statistical information about the spread of a disease, either as [[WebContent]], or\n described directly as a [[Dataset]], or the specific [[Observation]]s in the dataset. When a [[WebContent]] URL is\n provided, the page indicated might also contain more such markup.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:Dataset" },
|
|
{ "$ref": "schema:Observation" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:Dataset" },
|
|
{ "$ref": "schema:Observation" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"gettingTestedInfo": {
|
|
"description": "Information about getting tested (for a [[MedicalCondition]]), e.g. in the context of a pandemic.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"governmentBenefitsInfo": {
|
|
"description": "governmentBenefitsInfo provides information about government benefits associated with a SpecialAnnouncement.",
|
|
"oneOf": [
|
|
{ "$ref": "schema:GovernmentService" },
|
|
{ "type": "array", "items": { "$ref": "schema:GovernmentService" } }
|
|
]
|
|
},
|
|
"newsUpdatesAndGuidelines": {
|
|
"description": "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.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"publicTransportClosuresInfo": {
|
|
"description": "Information about public transport closures.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"quarantineGuidelines": {
|
|
"description": "Guidelines about quarantine rules, e.g. in the context of a pandemic.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"schoolClosuresInfo": {
|
|
"description": "Information about school closures.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"travelBans": {
|
|
"description": "Information about travel bans, e.g. in the context of a pandemic.",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"webFeed": {
|
|
"description": "The URL for a feed, e.g. associated with a podcast series, blog, or series of date-stamped updates. This is usually RSS or Atom.",
|
|
"anyOf": [
|
|
{ "type": "string", "format": "uri" },
|
|
{ "$ref": "schema:DataFeed" }
|
|
]
|
|
}
|
|
}
|
|
}
|