194 lines
6.9 KiB
YAML
194 lines
6.9 KiB
YAML
# LocationResolution - Method and result of settlement resolution
|
|
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
|
|
# Extraction date: 2026-01-08
|
|
|
|
id: https://nde.nl/ontology/hc/classes/LocationResolution
|
|
name: LocationResolution
|
|
title: LocationResolution
|
|
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
schema: http://schema.org/
|
|
prov: http://www.w3.org/ns/prov#
|
|
xsd: http://www.w3.org/2001/XMLSchema#
|
|
geo: http://www.w3.org/2003/01/geo/wgs84_pos#
|
|
|
|
imports:
|
|
- linkml:types
|
|
|
|
- ../enums/LocationResolutionMethodEnum
|
|
|
|
- ./ResearchSource
|
|
- ./SourceCoordinates
|
|
default_range: string
|
|
|
|
classes:
|
|
LocationResolution:
|
|
description: >-
|
|
Method and result of settlement resolution for GHCID generation.
|
|
Records how a location was resolved from source data (coordinates,
|
|
place names, addresses) to a standardized settlement using GeoNames
|
|
or other authoritative geographic databases.
|
|
|
|
Ontology mapping rationale:
|
|
- class_uri is prov:Location because this class represents the result
|
|
of resolving/identifying a geographic location, which PROV-O defines
|
|
as "an identifiable geographic place" with various expression methods
|
|
- close_mappings includes geo:SpatialThing because the resolution
|
|
produces spatial extent information (coordinates, feature codes)
|
|
- related_mappings includes schema:Place (general place concept) and
|
|
prov:Entity (the resolution result is a traceable entity)
|
|
class_uri: prov:Location
|
|
close_mappings:
|
|
- geo:SpatialThing
|
|
related_mappings:
|
|
- schema:Place
|
|
- prov:Entity
|
|
attributes:
|
|
method:
|
|
range: LocationResolutionMethodEnum
|
|
required: true
|
|
description: Resolution method used
|
|
google_maps_locality:
|
|
range: string
|
|
description: Locality from Google Maps
|
|
geonames_id:
|
|
range: integer
|
|
description: GeoNames ID
|
|
geonames_name:
|
|
range: string
|
|
description: Settlement name from GeoNames
|
|
feature_code:
|
|
range: string
|
|
description: GeoNames feature code (PPL, PPLC, etc.)
|
|
population:
|
|
range: integer
|
|
description: Population from GeoNames
|
|
admin1_code:
|
|
range: string
|
|
description: First-level admin code
|
|
region_code:
|
|
any_of:
|
|
- range: string
|
|
- range: integer
|
|
- range: boolean
|
|
description: ISO 3166-2 region code (string, number, or False for unknown)
|
|
region_name:
|
|
range: string
|
|
description: Region name (human-readable)
|
|
country_code:
|
|
range: string
|
|
description: ISO 3166-1 alpha-2 country code
|
|
source_coordinates:
|
|
range: SourceCoordinates
|
|
description: Coordinates used for resolution
|
|
needs_geonames_entry:
|
|
range: boolean
|
|
description: Flag indicating if GeoNames entry needs to be created
|
|
city_name:
|
|
range: string
|
|
description: City name resolved
|
|
city_label:
|
|
range: string
|
|
description: City label (human-readable, from Wikidata)
|
|
city_code:
|
|
range: string
|
|
description: City code (3-letter GHCID component)
|
|
enrichment_date:
|
|
range: datetime
|
|
description: When enrichment was performed
|
|
source_url:
|
|
range: uri
|
|
description: URL of source data
|
|
latitude:
|
|
range: float
|
|
description: Latitude of resolved location
|
|
longitude:
|
|
range: float
|
|
description: Longitude of resolved location
|
|
extracted_toponym:
|
|
range: string
|
|
description: Original toponym extracted from source data
|
|
resolution_timestamp:
|
|
range: datetime
|
|
description: When location resolution was performed
|
|
iso_code_source:
|
|
range: string
|
|
description: Source of ISO region code
|
|
country_label:
|
|
range: string
|
|
description: Human-readable country name (from Wikidata)
|
|
region_label:
|
|
range: string
|
|
description: Human-readable region name (from Wikidata)
|
|
region_source:
|
|
range: string
|
|
description: Source of region resolution (e.g., wikidata_p131)
|
|
region_resolved_at:
|
|
range: datetime
|
|
description: When region was resolved
|
|
region_wikidata_source:
|
|
range: string
|
|
description: Wikidata entity ID used for region resolution
|
|
admin1_code_source:
|
|
range: string
|
|
description: Source of admin1 code mapping
|
|
resolution_date:
|
|
range: datetime
|
|
description: When location resolution was performed (alternative to resolution_timestamp)
|
|
distance_km:
|
|
range: float
|
|
description: Distance in kilometers to resolved location
|
|
google_place_id:
|
|
range: string
|
|
description: Google Place ID used in resolution
|
|
micro_hamlet_skipped:
|
|
range: boolean
|
|
description: Whether micro-hamlet was skipped in favor of larger settlement
|
|
note:
|
|
range: string
|
|
description: Additional notes about the resolution
|
|
text_source:
|
|
range: string
|
|
description: Text source for fallback resolution (e.g., 'various')
|
|
needs_review:
|
|
range: boolean
|
|
description: Flag indicating this resolution needs manual review
|
|
wikidata_id:
|
|
range: string
|
|
description: Wikidata entity ID used for location resolution (e.g., Q5644016)
|
|
research_sources:
|
|
any_of:
|
|
- range: string
|
|
multivalued: true
|
|
- range: ResearchSource
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
description: List of research sources consulted (can be strings or structured
|
|
objects)
|
|
reason:
|
|
range: string
|
|
description: Reason for the resolution or override
|
|
research_date:
|
|
range: datetime
|
|
description: When research was conducted
|
|
research_method:
|
|
range: string
|
|
description: Method used for location research
|
|
city_name_cyrillic:
|
|
range: string
|
|
description: City name in Cyrillic script
|
|
resolution_notes:
|
|
range: string
|
|
description: Additional notes from location resolution process
|
|
specific_location:
|
|
range: string
|
|
description: More specific location info within the city (e.g., neighborhood,
|
|
district)
|
|
specific_geonames_id:
|
|
range: integer
|
|
description: GeoNames ID for the specific location (if different from main city)
|
|
correction_note:
|
|
range: string
|
|
description: Note explaining any correction made to the location resolution
|