{ "$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" } ] } } }