# 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#

imports:
  - linkml:types

  - ../enums/LocationResolutionMethodEnum

  - ./ResearchSource
  - ./SourceCoordinates
default_range: string

classes:
  LocationResolution:
      description: Method and result of settlement resolution
      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 note about the resolution
        note:
          range: string
          description: Additional notes about the resolution (alternative key)
        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