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# geo: http://www.w3.org/2003/01/geo/wgs84_pos# imports: - linkml:types - ../slots/has_or_had_city_code - ../slots/has_or_had_citation - ../enums/LocationResolutionMethodEnum - ./ResearchSource - ./SourceCoordinates default_range: string classes: LocationResolution: description: "Method and result of settlement resolution for GHCID generation. Records how a location was resolved from source data (coordinates, place names, addresses) to a standardized settlement using GeoNames or other authoritative geographic databases.\nOntology mapping rationale: - class_uri is prov:Location because this class represents the result\n of resolving/identifying a geographic location, which PROV-O defines\n as \"an identifiable geographic place\" with various expression methods\n- close_mappings includes geo:SpatialThing because the resolution \n produces spatial extent information (coordinates, feature codes)\n- related_mappings includes schema:Place (general place concept) and\n prov:Entity (the resolution result is a traceable entity)" class_uri: prov:Location close_mappings: - geo:SpatialThing related_mappings: - schema:Place - prov:Entity 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: range: Any 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) has_or_had_city_code: range: string description: 'City code used in GHCID generation. MIGRATED from city_code (Rule 53).' 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 notes about the resolution 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: range: Any multivalued: true inlined_as_list: true description: List of research sources consulted (can be strings or structured ResearchSource 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 notes: range: string description: Additional notes about the location (e.g., context, affiliation) annotations: specificity_score: 0.1 specificity_rationale: Generic utility class/slot created during migration custodian_types: - '*' custodian_types_rationale: Universal utility concept