# 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


  - ./Coordinates
  - ./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:
          range: Any
          any_of:
            - range: string
            - range: integer
          description: ISO 3166-2 subdivision code (string or number)
        country:
          range: Any
          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: Any
          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: Any
          description: Data removed during cleanup v2 process
          inlined: true
        person_observations:
          range: Any
          description: Person observations associated with this location
          inlined: true
        web_contact_data:
          range: Any
          description: Contact data extracted from web sources
          inlined: true