# NormalizedLocation - Normalized geographic location
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08

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
  - ./WikidataEntity
default_range: string

classes:
  NormalizedLocation:
      description: >-
        Normalized geographic location with standardized address components,
        coordinates, and GeoNames integration for consistent place identification.
        
        Ontology mapping rationale:
        - class_uri is locn:Address because this represents a normalized,
          structured geographic address with standardized components
        - 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:
          exactly_one_of:
          - range: string
          - range: integer
          description: ISO 3166-2 subdivision code (string or number)
        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