glam/schemas/20251121/linkml/modules/classes/NormalizedLocation.yaml
2026-01-31 00:15:53 +01:00

116 lines
4 KiB
YAML

id: https://nde.nl/ontology/hc/classes/NormalizedLocation
name: NormalizedLocation
title: NormalizedLocation
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#
locn: http://www.w3.org/ns/locn#
geo: http://www.w3.org/2003/01/geo/wgs84_pos#
imports:
- linkml:types
- ./CoordinateProvenance
- ./Coordinates
- ./WikidataEntity
default_range: string
classes:
NormalizedLocation:
description: "Normalized geographic location with standardized address components, coordinates, and GeoNames integration for consistent place identification.\nOntology mapping rationale: - class_uri is locn:Address because this represents a normalized,\n structured geographic address with standardized components\n- exact_mappings includes schema:Place as both represent physical locations - close_mappings includes geo:SpatialThing for coordinate-based aspects"
class_uri: locn:Address
exact_mappings:
- schema:Place
close_mappings:
- geo:SpatialThing
attributes:
latitude:
range: float
longitude:
range: float
coordinate_provenance:
range: CoordinateProvenance
city:
range: string
region:
range: string
region_code:
range: string
any_of:
- range: string
- range: integer
description: ISO 3166-2 subdivision code (string or number)
country:
range: string
any_of:
- range: string
- range: WikidataEntity
description: ISO 3166-1 alpha-2 country code or WikidataEntity object
country_reference:
exactly_one_of:
- range: string
- range: WikidataEntity
description: ISO 3166-1 alpha-2 code (string) or WikidataEntity object reference
postal_code:
any_of:
- range: string
- range: string
multivalued: true
description: Postal code(s) - single string or array for multiple codes
street_address:
range: string
formatted_address:
range: string
geonames_id:
range: integer
geonames_name:
range: string
feature_code:
range: string
normalization_timestamp:
range: datetime
geocoding_timestamp:
range: datetime
description: When geocoding was performed
geocoding_method:
range: string
description: Method used for geocoding (e.g., nominatim, google_maps)
geonames_matched_name:
range: string
description: Name that was matched in GeoNames lookup
street:
range: string
description: Street name or district (used in some location data formats)
coordinates:
range: Coordinates
description: Nested coordinate object with latitude, longitude and source
inlined: true
address:
range: string
description: Full street address as a single string
note:
range: string
description: Notes about the location (e.g., coordinate removal reason, data quality issues)
notes:
range: string
description: Additional notes about the location (e.g., context, affiliation, historical information)
coordinate_provenance_removed:
range: string
description: Information about removed coordinates when a false match is detected. Contains reason, original_latitude, original_longitude from the invalidated source.
inlined: true
cleanup_v2_removed:
range: string
description: Data removed during cleanup v2 process
inlined: true
person_observations:
range: string
description: Person observations associated with this location
inlined: true
web_contact_data:
range: string
description: Contact data extracted from web sources
inlined: true
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"