← Catalogue
World Models · legacy example

Address & Location Referencing

This meta-model describes the referencing fabric of the built world: civic and postal addresses, thoroughfares, geocodes and their reference systems, points of interest and place names. It is its own model because referencing schemes are governed independently of the things they locate: an address outlives occupants, a geocode outlives a building, and the same location is referenced by many models across the catalogue.

AI YAMLAGENTS.mdSource
IDworld.u7-address-and-location-referencing
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainbuilt-environment
Tagsaddress, location, referencing
Data structure

Bundles and layers

Bundle

addressing

Civic and postal designation of locations

Layers

civicAddresses`: structured addresses and their assignment lifecycle · `thoroughfares`: named streets, roads and waterways used in addressing · `postalDelivery`: postal formatting and delivery ordering

Bundle

geocoding

Coordinate and code representation of locations

Layers

geocodes`: coordinate and code values with precision · `referenceSystems`: the systems geocodes are expressed in

Bundle

placesOfInterest

Named places used for orientation and discovery

Layers

poiCatalogue`: points of interest with categories and lifecycle · `placeNames`: toponyms with language and status

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Service layers

How this specification operates

Dimension & namespace

  • REFERENCE `world.buildingStructure` (U1): buildings as addressable objects
  • REFERENCE `world.premisesSpatialUnit` (U2): premises addressed by sub-address and unit number
  • REFERENCE `world.landParcelCadastre` (P2): parcels as addressable objects where no building stands
  • REFERENCE `world.settlementUrbanForm` (U4): settlements and districts as address context and named places
  • REFERENCE `world.publicMandate` (A12): the registrar's mandate to assign and retire addresses
  • imports: iso-19160 (EXTEND: address class structure and lifecycle)
  • imports: upu-s42 (ALIGN: postal address templates and formatting)
  • imports: iso-19112 (REFERENCE: geographic identifier schemes)

Canon, patches & standards

  • REFERENCE `world.buildingStructure` (U1): buildings as addressable objects
  • REFERENCE `world.premisesSpatialUnit` (U2): premises addressed by sub-address and unit number
  • REFERENCE `world.landParcelCadastre` (P2): parcels as addressable objects where no building stands
  • REFERENCE `world.settlementUrbanForm` (U4): settlements and districts as address context and named places
  • REFERENCE `world.publicMandate` (A12): the registrar's mandate to assign and retire addresses
  • imports: iso-19160 (EXTEND: address class structure and lifecycle)
  • imports: upu-s42 (ALIGN: postal address templates and formatting)
  • imports: iso-19112 (REFERENCE: geographic identifier schemes)

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

  • `openGazetteerLicense`: public release of the authoritative address and place name list
  • `geocodingServiceContract`: resolution of addresses to geocodes and back for a consuming service
  • `poiListingAgreement`: a subject owner lists or updates its own POI entry

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

The owner archetype is the address registrar operating under a public mandate (A12), which stewards addresses, thoroughfares and geocodes as a reference asset. POI entries can be stewarded by their subject owners per S1, with publication and updates granted through S2.

Existing assembly

Objects, relationships, events and projections

Objects

  • `address`: a structured civic or postal designation of a location; key attributes: addressComponents, status, assignedAt
  • `thoroughfare`: a named street, road or waterway used in addressing; key attributes: name, thoroughfareKind, extent
  • `addressAssignment`: the act record binding an address to an addressable object; key attributes: objectRef, assignedAt, basis
  • `geocode`: a coordinate or code representation of a location; key attributes: value, precision, method
  • `referenceSystem`: a coordinate or grid system in which geocodes are expressed; key attributes: systemId, authority, kind
  • `poi`: a named point of interest usable for orientation or discovery; key attributes: name, category, status
  • `placeName`: a toponym with language and lifecycle; key attributes: name, language, nameStatus

Relationships

  • `address` -> onThoroughfare -> `thoroughfare` (n:1): the street context of a civic address
  • `addressAssignment` -> binds -> `address` (n:1): assignments attach addresses to buildings (U1), premises (U2) and parcels (P2)
  • `geocode` -> encodes -> `address` (n:1): a location can carry several geocodes of differing precision
  • `geocode` -> expressedIn -> `referenceSystem` (n:1): every geocode declares its system
  • `poi` -> situatedAt -> `address` (n:m): points of interest resolve to one or more addresses
  • `placeName` -> names -> `poi` (n:m): toponyms name POIs, thoroughfares and settlements (U4)

Events

  • `addressAssigned`: a new address was assigned to an addressable object
  • `addressRetired`: an address was withdrawn from use but kept as history
  • `thoroughfareRenamed`: a street or road received a new official name
  • `geocodeRevised`: a geocode value or precision was corrected
  • `poiRegistered`: a point of interest entered the catalogue
  • `poiClosed`: a point of interest ceased to exist or operate

Projections

  • `gazetteerProjection`: the authoritative address list with status; omits occupancy and ownership
  • `deliveryRoutingProjection`: postal formatting and delivery ordering; omits historic names and assignment provenance
  • `navigationProjection`: POIs, place names and geocodes for wayfinding; omits retired records