{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"travel-advisory.schema.json","title":"Official travel advice level for a destination, per issuing government","type":"object","required":["id","destination","destination_name","issuer_destination_name","issuer","issuer_authority","language","level","level_wording","max_level","has_regional_differences","regions","summary","updated","level_changed","level_changed_basis","advice_url","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"$defs":{"level":{"type":"integer","minimum":1,"maximum":4,"description":"Normalised level: 1 normal precautions, 2 increased caution, 3 avoid non-essential travel or reconsider travel, 4 avoid all travel or do not travel"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"properties":{"id":{"type":"string","pattern":"^(US|GB|CA|NL|JP|FR|NZ)-[A-Z]{2}$","description":"Issuer and destination, for example GB-FR"},"destination":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 code of the destination (XK for Kosovo)"},"destination_name":{"type":"string","description":"English short name of the destination (ISO 3166)"},"issuer_destination_name":{"type":"string","description":"Destination name as the issuer publishes it; several names separated by '; ' when the issuer has separate pages for parts of one country"},"issuer":{"enum":["US","GB","CA","NL","JP","FR","NZ"],"description":"Issuing government, ISO 3166-1 alpha-2"},"issuer_authority":{"type":"string","description":"Ministry or department that publishes the advice"},"language":{"enum":["en","nl","ja","fr"],"description":"Language of level_wording, summary and region names as published"},"level":{"$ref":"#/$defs/level","description":"Normalised level for the country as a whole, or for the rest of the country outside the listed regions. US: the advisory level. CA: advisory state 0 to 3 plus 1. NL: kleurcode groen 1, geel 2, oranje 3, rood 4. GB: 4 or 3 when the FCDO advises against all or all but essential travel to the whole country, 2 when it advises against travel to parts only (the FCDO has no tier 2), 1 when there is no FCDO advice against travel. JP: MOFA 危険レベル 1 to 4 plus 1, capped at 4 (Japan has no level for normal precautions), 1 when Japan states no risk level for the country or for the areas not named. FR: zones de vigilance, vigilance normale 1, vigilance renforcée 2, déconseillé sauf raison impérative 3, formellement déconseillé 4. NZ: SafeTravel level 1 to 4 as published (exercise normal safety and security precautions 1, exercise increased caution 2, avoid non-essential travel 3, do not travel 4)"},"level_wording":{"type":"string","description":"The issuer's own level wording, for example 'Level 2: Exercise Increased Caution', 'Avoid non-essential travel' or 'Kleurcode oranje'"},"max_level":{"$ref":"#/$defs/level","description":"Highest level stated anywhere in this record, including regions"},"has_regional_differences":{"type":"boolean","description":"True when the issuer states a different level for parts of the destination (CA states this without naming the regions)"},"regions":{"type":"array","maxItems":20,"description":"Regions with a level different from the country level, where the source names them","items":{"type":"object","required":["name","level","wording"],"additionalProperties":false,"properties":{"name":{"type":"string","maxLength":200},"level":{"$ref":"#/$defs/level"},"wording":{"type":"string"}}}},"summary":{"type":["string","null"],"maxLength":400,"description":"Short factual statement of the level from the source (US first sentence, GB FCDO advice sentences, NL kleurcode sentences in Dutch, JP lead of the 危険情報 in Japanese, FR zones de vigilance statement in French)"},"latest_change":{"type":["string","null"],"maxLength":300,"description":"Issuer's note on the latest update (GB change description, CA recent updates)"},"updated":{"$ref":"#/$defs/date","description":"Last updated date stated by the source"},"level_changed":{"$ref":"#/$defs/date","description":"Date the level was last seen to change. With basis issuer-updated-date this is the source's last update (the level has been the same since at least that date or earlier); with snapshot-comparison it is the first daily snapshot that showed the new level"},"level_changed_basis":{"enum":["issuer-updated-date","snapshot-comparison"]},"previous_level":{"anyOf":[{"$ref":"#/$defs/level"},{"type":"null"}],"description":"Level before the last change seen in our snapshots; null when no change has been seen"},"advice_url":{"type":"string","format":"uri","description":"Official travel advice page"},"verification":{"enum":["official-publication"]},"paid_placement":{"const":false},"source_id":{"type":"string"},"source_url":{"type":"string","format":"uri","description":"Machine-readable source document"},"retrieved_at":{"type":"string","format":"date-time"}}}