glam/schemas/20251121/linkml/modules/classes/CoordinateProvenance.yaml
2026-01-19 00:09:28 +01:00

114 lines
3.9 KiB
YAML

# CoordinateProvenance - Provenance of coordinates
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08
id: https://nde.nl/ontology/hc/classes/CoordinateProvenance
name: CoordinateProvenance
title: CoordinateProvenance
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
default_range: string
classes:
CoordinateProvenance:
description: >-
Provenance of coordinates tracking the source, method, and metadata
for how geographic coordinates were obtained or resolved.
Ontology mapping rationale:
- class_uri is prov:Entity because this represents provenance metadata
about a coordinate value (the coordinate source as an entity)
- close_mappings includes geo:Point for the coordinate data aspect
- related_mappings includes prov:Activity for the resolution activity
class_uri: prov:Entity
close_mappings:
- geo:Point
related_mappings:
- prov:Activity
attributes:
source_type:
range: string
description: GOOGLE_MAPS, WIKIDATA, MANUAL, GHCID_RESOLUTION_DIRECT, ORIGINAL_ENTRY,
etc.
source_path:
range: string
description: Path in source data
original_timestamp:
range: datetime
entity_id:
range: Any
any_of:
- range: string
- range: integer
description: Source entity ID (place_id, Q-number, geonames_id - can be string
or integer)
has_or_had_api_endpoint:
range: uri
resolution_method:
range: string
description: Method used for resolution (SWISS_ISIL_ENRICHMENT, etc.)
matched_candidate:
range: string
description: The candidate that was matched during geocoding
original_query:
range: string
description: Original query string used for geocoding lookup
city_code:
range: string
description: City code used in GHCID generation
override_reason:
range: string
description: Reason for manual coordinate override
source_url:
range: uri
description: URL source of coordinates (e.g., Google Maps link)
note:
range: string
description: Additional note about coordinate provenance
api_endpoint:
range: uri
description: API endpoint used to resolve coordinates (legacy field name)
display_name:
range: string
description: Display name returned from geocoding service
geocode_query:
range: string
description: Query string sent to geocoding service
osm_id:
range: Any
any_of:
- range: string
- range: integer
description: OpenStreetMap ID of matched location
osm_type:
range: string
description: OpenStreetMap type (node, way, relation)
retrieval_agent:
range: string
description: Agent/service that performed the geocoding lookup
source_archived_at:
range: string
description: When the source data was archived (ISO datetime)
statement_created_at:
range: string
description: When this provenance statement was created (ISO datetime)
city_match:
range: boolean
description: Whether the geocoded city matched the expected city
geocode_confidence:
range: float
description: Confidence score from the geocoding service (0.0-1.0)
result_city:
range: string
description: City name returned by the geocoding service