glam/schemas/20251121/linkml/modules/classes/BirthPlace.yaml
kempersc 4338d0a081 feat: Add structured representation for BirthDate and BirthPlace classes
- Introduced BirthDate class with support for EDTF notation, provenance tracking, and confidence scoring.
- Added BirthPlace class to preserve historical names, link modern equivalents, and integrate geographic identifiers.
- Created Approximation Level slot to express uncertainty levels for various values.
- Migrated existing slots to structured classes for better data modeling, including has_or_had_date_of_birth and has_or_had_place_of_birth.
- Enhanced service area representation with has_or_had_service_area slot, linking to ServiceArea class.
- Updated is_or_was_approximate slot to model uncertainty levels using ApproximationStatus class.
- Archived previous versions of slots for historical reference.
2026-01-14 16:04:09 +01:00

223 lines
6.8 KiB
YAML

id: https://nde.nl/ontology/hc/class/BirthPlace
name: birth_place_class
title: Birth Place Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
crm: http://www.cidoc-crm.org/cidoc-crm/
gn: http://www.geonames.org/ontology#
wdt: http://www.wikidata.org/prop/direct/
imports:
- linkml:types
- ../metadata
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
default_prefix: hc
classes:
BirthPlace:
class_uri: schema:Place
description: >-
Structured representation of a person's place of birth with support
for historical place names, modern equivalents, and geographic identifiers.
**PURPOSE**:
BirthPlace replaces simple string birth_place slots to provide:
- Historical place name preservation
- Modern place name linkage
- Geographic identifier integration (GeoNames, Wikidata)
- Coordinate storage for mapping applications
**HISTORICAL VS. MODERN NAMES**:
Many birth places used historical names that have since changed:
- "Batavia" → "Jakarta"
- "Bombay" → "Mumbai"
- "Leningrad" → "St. Petersburg"
- "Saigon" → "Ho Chi Minh City"
BirthPlace preserves the source name while linking to modern identifiers.
**GEOGRAPHIC RESOLUTION**:
Per AGENTS.md Rule on GeoNames as authoritative source:
- `geonames_id`: Links to GeoNames for standardization
- `wikidata_id`: Links to Wikidata for additional context
- `coordinates`: Lat/lon for mapping
**ONTOLOGY ALIGNMENT**:
| Ontology | Mapping | Usage |
|----------|---------|-------|
| **Schema.org** | `schema:Place` | Primary class |
| **CIDOC-CRM** | `crm:E53_Place` | Place entity |
| **GeoNames** | `gn:Feature` | Geographic feature |
**EXAMPLE**:
```yaml
has_or_had_place_of_birth:
place_name: "Batavia"
modern_place_name: "Jakarta"
country_code: "ID"
geonames_id: 1642911
wikidata_id: "Q3630"
```
exact_mappings:
- schema:Place
close_mappings:
- crm:E53_Place
- gn:Feature
slots:
- place_name
- modern_place_name
- country_code
- region_code
- geonames_id
- wikidata_id
- coordinates
- place_source_text
- specificity_annotation
- template_specificity
slot_usage:
place_name:
range: string
required: true
description: >-
Name of the birth place as recorded in source.
May be historical name that has since changed.
examples:
- value: "Amsterdam"
description: Current name
- value: "Batavia"
description: Historical name (now Jakarta)
modern_place_name:
range: string
required: false
description: >-
Modern equivalent name if place_name is historical.
Leave null if place_name is current.
examples:
- value: "Jakarta"
description: Modern name for Batavia
country_code:
range: string
required: false
pattern: "^[A-Z]{2}$"
description: >-
ISO 3166-1 alpha-2 country code.
examples:
- value: "NL"
- value: "ID"
region_code:
range: string
required: false
description: >-
ISO 3166-2 region/province code or GeoNames admin1 code.
examples:
- value: "NH"
description: Noord-Holland
geonames_id:
range: integer
required: false
description: >-
GeoNames geographic identifier for the place.
Authoritative source per AGENTS.md.
examples:
- value: 2759794
description: Amsterdam GeoNames ID
wikidata_id:
range: string
required: false
pattern: "^Q[0-9]+$"
description: >-
Wikidata entity identifier for the place.
examples:
- value: "Q727"
description: Amsterdam Wikidata ID
coordinates:
range: string
required: false
description: >-
Geographic coordinates as "lat,lon" string.
examples:
- value: "52.3676,4.9041"
description: Amsterdam coordinates
place_source_text:
range: string
required: false
description: >-
Original place text from source document, preserved verbatim.
Useful when source contains additional context.
examples:
- value: "born at the family estate in rural Gelderland"
comments:
- "Replaces simple birth_place string slot (Rule 53)"
- "Preserves historical place names while linking to modern identifiers"
- "GeoNames ID is authoritative per AGENTS.md"
see_also:
- https://schema.org/birthPlace
- https://www.geonames.org/
examples:
- value:
place_name: "Amsterdam"
country_code: "NL"
region_code: "NH"
geonames_id: 2759794
wikidata_id: "Q727"
coordinates: "52.3676,4.9041"
description: Birth place with full geographic resolution
- value:
place_name: "Batavia"
modern_place_name: "Jakarta"
country_code: "ID"
geonames_id: 1642911
wikidata_id: "Q3630"
description: Historical place name with modern equivalent
- value:
place_name: "rural Gelderland"
country_code: "NL"
region_code: "GE"
place_source_text: "born at the family estate in rural Gelderland"
description: Imprecise location from archival source
annotations:
specificity_score: 0.45
specificity_rationale: >-
Birth places are relevant for person research across heritage sectors.
slots:
place_name:
description: Name of the place as recorded in source.
range: string
slot_uri: schema:name
modern_place_name:
description: Modern equivalent name if different from source name.
range: string
slot_uri: hc:modernPlaceName
country_code:
description: ISO 3166-1 alpha-2 country code.
range: string
slot_uri: schema:addressCountry
region_code:
description: ISO 3166-2 region/province code.
range: string
slot_uri: schema:addressRegion
geonames_id:
description: GeoNames geographic identifier.
range: integer
slot_uri: gn:geonamesId
wikidata_id:
description: Wikidata entity identifier.
range: string
slot_uri: wdt:P625
coordinates:
description: Geographic coordinates as lat,lon string.
range: string
slot_uri: schema:geo
place_source_text:
description: Original place text from source document.
range: string
slot_uri: hc:sourceText