glam/schemas/20251121/linkml/modules/classes/Subregion.yaml

53 lines
2.9 KiB
YAML

id: https://nde.nl/ontology/hc/class/subregion
name: subregion
title: Subregion Class
imports:
- linkml:types
- ./Country
- ../slots/country
- ../slots/iso_3166_2_code
- ../slots/specificity_annotation
- ../slots/has_or_had_label
- ../slots/has_or_had_score
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Subregion:
class_uri: lcc_cr:GeographicRegion
exact_mappings:
- schema:AdministrativeArea
- gn:A.ADM1
close_mappings:
- wikidata:Q10864048
- crm:E53_Place
description: "Geographic subdivision within a country, identified by ISO 3166-2 code.\n\nISO 3166-2 defines codes for principal subdivisions of countries (states,\nprovinces, regions, departments, etc.). Each subdivision has a unique code\ncombining the country's alpha-2 code with a subdivision identifier.\n\nPurpose:\n- Link custodian places to their specific regional location (e.g., museums in Bavaria)\n- Link legal entities to their registration jurisdiction (e.g., stichting in Limburg)\n- Enable region-specific feature types (e.g., \"sacred shrine\" specific to Bali)\n\nFormat: {country_alpha2}-{subdivision_code}\n\nExamples:\n- US-PA: Pennsylvania, United States\n- ID-BA: Bali, Indonesia\n- DE-BY: Bavaria (Bayern), Germany\n- NL-LI: Limburg, Netherlands\n- AU-NSW: New South Wales, Australia\n- CA-ON: Ontario, Canada\n\nDesign rationale:\n- ISO 3166-2 codes are internationally standardized\n- Stable identifiers not dependent on language or spelling variations\n- Widely used in official\
\ datasets (government registries, GeoNames, etc.)\n- Aligns with existing Country class (ISO 3166-1)\n\nExternal resolution:\n- ISO 3166-2 Maintenance Agency: https://www.iso.org/iso-3166-country-codes.html\n- GeoNames API: https://www.geonames.org/ (subdivision names and metadata)\n- UN M49 Standard: https://unstats.un.org/unsd/methodology/m49/\n\nHistorical entities:\n- For historical subdivisions (e.g., \"Czechoslovakia\", \"Soviet Union\"), use\n the ISO code that was valid during the entity's existence\n- Document temporal validity in CustodianPlace.temporal_coverage\n"
slots:
- country
- iso_3166_2_code
- specificity_annotation
- has_or_had_label
- has_or_had_score
slot_usage:
iso_3166_2_code:
required: true
identifier: true
country:
required: true
has_or_had_label:
required: false
description: 'Human-readable name of the subdivision.
Prefer resolving names via GeoNames API to avoid maintaining multilingual data.
Examples: "Pennsylvania" (for US-PA), "Bali" (for ID-BA), "Bayern" (for DE-BY)
'
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept