glam/frontend/public/schemas/20251121/linkml/modules/classes/City.yaml
kempersc 2d09776856 Refactor StorageCondition schema: Migrate compliance_status to has_or_had_status with ComplianceStatus class
- Removed compliance_status slot and replaced it with has_or_had_status.
- Updated has_or_had_status to use ComplianceStatus for structured representation.
- Adjusted examples to reflect new structure for compliance status.
- Updated documentation to indicate migration and provide details on the ComplianceStatus class.
2026-01-22 16:22:16 +01:00

122 lines
3.5 KiB
YAML

# City - A city/town settlement entity
# Created: 2026-01-18
# Migration from city (string) slot per slot_fixes.yaml revision
# City is_a Settlement per established pattern
id: https://nde.nl/ontology/hc/class/City
name: city_class
title: City Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
gn: http://www.geonames.org/ontology#
wikidata: http://www.wikidata.org/entity/
crm: http://www.cidoc-crm.org/cidoc-crm/
imports:
- linkml:types
- ./Settlement
default_prefix: hc
classes:
City:
is_a: Settlement
class_uri: schema:City
description: |
A city or large town settlement.
**RELATIONSHIP TO SETTLEMENT**:
City is a subclass of Settlement representing urban areas that are
typically larger and more administratively significant than villages
or small towns.
**GeoNames Feature Codes**:
Cities typically correspond to GeoNames feature codes:
- PPL: Populated place (general)
- PPLA: Seat of first-order administrative division
- PPLA2: Seat of second-order administrative division
- PPLC: Capital of a political entity
- PPLS: Populated places (urban agglomerations)
**USAGE**:
Use City class when:
- The settlement is known to be a city (not village/hamlet)
- You need to express city-specific semantics
- Schema.org City alignment is important
Use Settlement class when:
- The settlement type is unknown or mixed
- You want the most general geographic entity
**EXAMPLES**:
```yaml
is_or_was_located_in:
- settlement_name: "Amsterdam"
geonames_id: 2759794
country: "NL"
```
exact_mappings:
- schema:City
close_mappings:
- gn:P.PPLA
- gn:P.PPLC
- wikidata:Q515
related_mappings:
- crm:E53_Place
# Inherits all slots from Settlement:
# - settlement_name
# - geonames_id
# - latitude
# - longitude
# - country
# - has_or_had_geographic_subdivision (subregion)
# - specificity_annotation
# - has_or_had_score
annotations:
specificity_score: 0.35
specificity_rationale: |
Slightly more specific than Settlement (0.30) as it indicates
urban status, but still broadly applicable across heritage contexts.
custodian_types: '["*"]'
custodian_types_rationale: |
All heritage custodians are located in cities or settlements.
custodian_types_primary: "*"
examples:
- value:
settlement_name: "Amsterdam"
geonames_id: 2759794
country: "NL"
has_or_had_geographic_subdivision:
subregion_code: "NL-NH"
description: Amsterdam - capital and largest city of the Netherlands
- value:
settlement_name: "Haarlem"
geonames_id: 2755420
country: "NL"
latitude: 52.3873
longitude: 4.6462
description: Haarlem - city in Noord-Holland province
- value:
settlement_name: "Tokyo"
geonames_id: 1850147
country: "JP"
description: Tokyo - capital of Japan
comments:
- City is_a Settlement following semantic hierarchy
- Inherits all Settlement slots including GeoNames ID
- Use for explicit urban classification
- Created per slot_fixes.yaml migration for city slot (2026-01-18)