glam/schemas/20251121/linkml/modules/classes/GeoSpatialPlace.yaml

id: https://nde.nl/ontology/hc/class/GeoSpatialPlace
name: geospatial_place_class
title: GeoSpatialPlace Class
prefixes:
  geo: http://www.opengis.net/ont/geosparql#
  rov: http://www.w3.org/ns/regorg#
  geosparql: http://www.opengis.net/ont/geosparql#
  wgs84: http://www.w3.org/2003/01/geo/wgs84_pos#
  sf: http://www.opengis.net/ont/sf#
  gn: http://www.geonames.org/ontology#
  gn_entity: http://sws.geonames.org/
  tooi: https://identifier.overheid.nl/tooi/def/ont/
imports:
  - linkml:types
  - ../enums/GeometryTypeEnum
  - ../metadata
  - ../slots/20260202_matang/new/coordinate_reference_system
  - ../slots/20260202_matang/has_altitude
  - ../slots/20260202_matang/has_coordinates
  - ../slots/20260202_matang/has_geofeature
  - ../slots/20260202_matang/has_geographic_extent
  - ../slots/20260202_matang/has_geometry
  - ../slots/20260202_matang/identified_by
  - ../slots/20260202_matang/has_score
  - ../slots/20260202_matang/new/osm_id
  - ../slots/20260202_matang/new/spatial_resolution
  - ../slots/20260202_matang/temporal_extent
types:
  WktLiteral:
    uri: geosparql:wktLiteral
    base: str
    description: 'Well-Known Text (WKT) representation of geometry.
      See OGC Simple Features specification.
      '
    examples:
    - value: POINT(4.2894 52.0705)
    - value: POLYGON((4.0 52.0, 4.5 52.0, 4.5 52.5, 4.0 52.5, 4.0 52.0))
classes:
  GeoSpatialPlace:
    class_uri: geosparql:Feature
    description: "Geospatial location with coordinates, geometry, and projections.\n\nCRITICAL DISTINCTION FROM CustodianPlace:\n\n| Aspect | CustodianPlace | GeoSpatialPlace |\n|--------|----------------|-----------------|\n| Nature | Nominal reference | Geospatial data |\n| Content | \"het herenhuis in de Schilderswijk\" | lat: 52.0705, lon: 4.2894 |\n| Purpose | Identify custodian by place name | Locate custodian precisely |\n| Ambiguity | May be vague (\"the mansion\") | Precise, measurable |\n| Source | Archival documents, oral history | GPS, cadastral surveys, geocoding |\n\n**TOOI Ontology Alignment**:\n\nThis class follows the TOOI pattern for geospatial data:\n- `tooi:BestuurlijkeRuimte` is a subclass of `geosparql:Feature` and `prov:Entity`\n- `tooi:BestuurlijkeRuimte-hasGeometry` \u2192 `geosparql:Geometry`\n- `tooi:RegistratieveRuimte` for administrative boundaries\n- `tooi:JuridischeRuimte` for legal jurisdiction boundaries\n\nLike TOOI, we separate:\n- **geosparql:Feature**\
      \ (this class): The real-world place with location data\n- **geosparql:Geometry**: The mathematical representation (WKT, GeoJSON)\n\n**Use Cases**:\n\n1. **Building-level precision**: Museum building footprint (Polygon)\n2. **City-level approximation**: Heritage institution centroid (Point)\n3. **Administrative boundaries**: Archive jurisdiction area (MultiPolygon)\n4. **Historical boundaries**: Pre-merger municipal territory (Polygon + temporal_extent)\n\n**Relationship to CustodianPlace**:\n\nCustodianPlace.has_geospatial_location \u2192 GeoSpatialPlace\n\nA nominal place reference (\"Rijksmuseum\") links to its geospatial location\n(lat: 52.3600, lon: 4.8852, geometry: building footprint polygon).\n\n**Relationship to AuxiliaryPlace**:\n\nAuxiliaryPlace.has_geospatial_location \u2192 GeoSpatialPlace\n\nSecondary/subordinate locations (branch offices, storage depots, reading rooms)\ncan also link to precise geospatial coordinates. This enables:\n- Mapping all custodian locations\
      \ (primary + auxiliary)\n- Spatial queries across an organization's entire footprint\n- Building footprints for off-site storage facilities\n- Historical boundary tracking for branch offices\n\n**Relationship to OrganizationalChangeEvent**:\n\nOrganizational changes may affect geographic location:\n- RELOCATION: New GeoSpatialPlace, old one gets temporal_extent.end_of_the_end\n- MERGER: Multiple locations \u2192 single primary + auxiliary locations\n- SPLIT: One location \u2192 multiple successor locations\n"
    exact_mappings:
    - geosparql:Feature
    close_mappings:
    - geo:SpatialThing
    - schema:Place
    - schema:GeoCoordinates
    related_mappings:
    - prov:Entity
    - tooi:BestuurlijkeRuimte
    - crm:E53_Place
    slots:
    - has_coordinates
    - has_altitude
    - has_geographic_extent
    - identified_by
    - coordinate_reference_system
    - has_geofeature
    - geometric_extent
    - osm_id
    - spatial_resolution
    - has_score
    - temporal_extent
    slot_usage:
      has_coordinates:
        range: Coordinates
        inlined: true
        required: true
        examples:
        - value:
            latitude: 52.36
            longitude: 4.8852
      coordinate_reference_system:
        ifabsent: string(EPSG:4326)
      identified_by:
        description: 'Cadastral identifiers for this geospatial place. MIGRATION NOTE (2026-01-14): Replaces cadastral_id per slot_fixes.yaml. Use Identifier with identifier_scheme=''cadastral'' for parcel IDs. Netherlands: Kadaster perceelnummer format {gemeente}-{sectie}-{perceelnummer}'
        examples:
        - value:
      temporal_extent:
        range: TimeSpan
        inlined: true
        required: false
        examples:
        - value:
            begin_of_the_begin: '1920-01-01'
            end_of_the_end: '2001-01-01'
    comments:
    - Follows TOOI BestuurlijkeRuimte pattern using GeoSPARQL
    - 'CRITICAL: NOT a nominal reference - this is measured/surveyed location data'
    - Use CustodianPlace for nominal references, this class for coordinates
    - lat/lon required; geometry_wkt optional for point locations
    - Link from CustodianPlace via has_geospatial_location slot
    - Link from AuxiliaryPlace via has_geospatial_location slot (subordinate sites)
    - Link from OrganizationalChangeEvent via has_affected_territory slot
    - temporal_extent tracks boundary changes over time (was valid_from_geo/valid_to_geo)
    - OSM and GeoNames IDs enable external linking
    see_also:
    - http://www.opengis.net/ont/geosparql
    - https://www.geonames.org/
    - https://www.openstreetmap.org/
    - https://identifier.overheid.nl/tooi/def/ont/
    examples:
    - value:
        geospatial_id: https://nde.nl/ontology/hc/geo/rijksmuseum-building
        has_coordinates:
          latitude: 52.36
          longitude: 4.8852
        altitude: 0.0
        geometric_extent:
        - has_format:
            has_value: POLYGON((4.8830 52.3590, 4.8870 52.3590, 4.8870 52.3610, 4.8830 52.3610, 4.8830 52.3590))
          has_type:
            has_label: POLYGON
        coordinate_reference_system: EPSG:4326
        osm_id: way/27083908
        spatial_resolution: BUILDING
        has_geofeature:
        - has_type: SpotFeature
          has_code:
            has_label: S.MUS
    - value:
        geospatial_id: https://nde.nl/ontology/hc/geo/amsterdam-centroid
        has_coordinates:
          latitude: 52.3676
          longitude: 4.9041
        geometric_extent:
        - has_type:
            has_label: POINT
        coordinate_reference_system: EPSG:4326
        spatial_resolution: CITY
        has_geofeature:
        - has_type: PopulatedPlace
          has_code:
            has_label: P.PPLC
    - value:
        geospatial_id: https://nde.nl/ontology/hc/geo/noord-holland-archive-territory-pre-2001
        has_coordinates:
          latitude: 52.5
          longitude: 4.8
        geometric_extent:
        - has_format:
            has_value: MULTIPOLYGON(((4.5 52.2, 5.2 52.2, 5.2 52.8, 4.5 52.8, 4.5 52.2)))
          has_type:
            has_label: MULTIPOLYGON
        coordinate_reference_system: EPSG:4326
        spatial_resolution: REGION
        has_geofeature:
        - has_type: AdministrativeBoundary
          has_code:
            has_label: A.ADM1
        temporal_extent:
          begin_of_the_begin: '1920-01-01'
          end_of_the_end: '2001-01-01'
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"