glam/schemas/20251121/linkml/modules/classes/Country.yaml
2026-02-04 00:24:46 +01:00

66 lines
No EOL
2.7 KiB
YAML

id: https://nde.nl/ontology/hc/class/country
name: country
title: Country Class
prefixes:
gn: http://www.geonames.org/ontology#
hc: https://nde.nl/ontology/hc/
lcc_cr: https://www.omg.org/spec/LCC/Countries/CountryRepresentation/
linkml: https://w3id.org/linkml/
schema: http://schema.org/
wikidata: http://www.wikidata.org/entity/
imports:
- linkml:types
- ../slots/20260202_matang/has_code
- ../slots/20260202_matang/has_score
classes:
Country:
class_uri: schema:Country
exact_mappings:
- lcc_cr:Country
- gn:A.PCLI
close_mappings:
- wikidata:Q6256
description: "Country identified by ISO 3166-1 alpha-2 and alpha-3 codes.\n\nThis is a **minimal design** class containing ONLY ISO standardized country codes.\nNo other metadata (names, languages, capitals, regions) is included.\n\nPurpose:\n- Link legal forms to their jurisdiction (legal forms are country-specific)\n- Link custodian places to their country location\n- Enable conditional enum values in FeatureTypeEnum (e.g., \"cultural heritage of Peru\")\n\nDesign rationale:\n- ISO 3166 codes are authoritative, stable, and language-neutral\n- Country names, languages, and other metadata should be resolved via external services\n- Keeps the ontology focused on heritage custodian relationships, not geopolitical data\n\nExternal resolution services:\n- GeoNames API: https://www.geonames.org/\n- UN M49 Standard: https://unstats.un.org/unsd/methodology/m49/\n- ISO 3166 Maintenance Agency: https://www.iso.org/iso-3166-country-codes.html\n\nMIGRATION (2026-01-16): Now uses has_code\
\ with Alpha2Code and Alpha3Code \nclass instances per Rule 56 (semantic consistency over simplicity).\n"
slots:
- has_code
- has_score
slot_usage:
has_code:
multivalued: true
description: 'ISO country codes for this country. Includes:
- One Alpha2Code instance (2-letter code, e.g., "NL")
- One Alpha3Code instance (3-letter code, e.g., "NLD")
'
annotations:
specificity_score: '0.20'
specificity_rationale: Low specificity - countries are universal geographic entities.
custodian_types: "['*']"
examples:
- value:
has_code:
- _type: Alpha2Code
has_code: NL
- _type: Alpha3Code
has_code: NLD
- value:
has_code:
- _type: Alpha2Code
has_code: PE
- _type: Alpha3Code
has_code: PER
- value:
has_code:
- _type: Alpha2Code
has_code: US
- _type: Alpha3Code
has_code: USA
- value:
has_code:
- _type: Alpha2Code
has_code: JP
- _type: Alpha3Code
has_code: JPN