AXIOMCodex editionDocs ↗
Ontology crosswalk

Commercial use covered by the Commercial All-access license: Overture Maps Places-sourced records.

POI Intelligence — Ontology Crosswalk

Schema: pending (AXC-12 — schemas/poi-intelligence/v1.0.md) Target standards: schema.org/LocalBusiness (primary semantic), GS1 Global Location Number (GLN), OGC GeoJSON, DCAT-US v3.0 Authority: Schema.org consortium, GS1, OGC, U.S. DOC Status: FAIR-aligned, Google-rich-results compatible Dataset SPDX license: CDLA-Permissive-2.0 (Overture Maps Places; Foursquare-contributed records Apache-2.0 with the upstream NOTICE; every record retains its upstream license) · commercial use of Overture Maps Places-sourced records is licensed through the Commercial All-access license; upstream attribution and license notices apply

1. Why schema.org/LocalBusiness + GS1 GLN

schema.org/LocalBusiness is the de-facto vocabulary for any consumer-facing application, search engine, or LLM surfacing POI data, so the governed POI columns map onto it directly. GS1 GLN is the enterprise counterpart — retailers, logistics, and commercial real estate use GLN as the canonical location identifier. The governed package carries no GLN today; GLN is listed as the target slot for a location identifier, not a shipped field.

2. Dataset-level (DCAT-US v3.0)

DCAT-US field Value
dct:identifier urn:axiom:codex:dataset:poi-intelligence:v1.0.0
dct:title "Axiom POI Intelligence Dataset"
dct:description "Overture Maps Places points of interest for U.S. states with Overture taxonomy categories, H3 resolution-8 cell indexes, source observation timestamps, and source-mapped identifiers."
dcat:keyword ["poi", "local-business", "overture-maps", "places", "h3", "retail"]
dcat:theme ["http://publications.europa.eu/resource/authority/data-theme/ECON"]
dct:license CDLA-Permissive-2.0 with per-record upstream licenses (see below)

2.1 License complexity

POI records come from one governed source, Overture Maps Places. Its contributing datasets keep their own licenses: CDLA-Permissive-2.0 for most contributors, Apache-2.0 for Foursquare (NOTICE and change statement required), and CC0-1.0 for AllThePlaces. Every record retains its upstream license. Codex publishes two distributions:

Distribution License
research — Overture Maps Places-sourced records CDLA-Permissive-2.0 (per-record upstream licenses and notices retained)
commercial — Overture Maps Places-sourced records only, via the Commercial All-access license Axiom Codex Commercial All-access license (upstream notices apply)

3. Record-level crosswalk → schema.org/LocalBusiness

Every field below is a column of the governed POI package (Overture Maps Places full U.S. state packages); nothing outside that column list is published.

{
  "@context": [
    "https://schema.org",
    {"axiom": "https://axiomcodex.io/ns/v1/"}
  ],
  "@type": "LocalBusiness",
  "@id": "urn:aprs:record:poi:overture:08f2a...",
  "identifier": [
    {"@type": "PropertyValue", "propertyID": "Overture GERS", "value": "08f2a..."}
  ],
  "name": "Example Cafe",
  "additionalType": "coffee_shop",
  "geo": {"@type": "GeoCoordinates", "latitude": 40.7, "longitude": -74.0},
  "axiom:h3Index": "88283082b9fffff",
  "axiom:confidence": 0.93,
  "axiom:sourceFeed": "overture-maps-places",
  "isBasedOn": "https://..."
}

3.1 Field-by-field mapping

Codex field schema.org / PROV Notes
record_id @id Stable normalized source-record identity
id identifier (Overture GERS) Overture place/GERS identifier
overture_id identifier Overture source object identifier bound to the snapshot
name name Source place name
ontology_type additionalType (IRI) Primary mapped Overture taxonomy type
primary_type additionalType Primary Overture category
types additionalType[] JSON-encoded taxonomy hierarchy and alternates
location geo.GeoCoordinates JSON-encoded point (OGC GeoJSON)
h3_index axiom:h3Index H3 resolution-8 cell for spatial joins
confidence axiom:confidence Unthresholded upstream confidence; not operating status
status axiom:operatingStatus Reported operating status; null means unreported, not open
first_seen_at / last_seen_at prov:generatedAtTime range Source observations, not opening or closure dates
observed_at prov:generatedAtTime Observation timestamp in the source snapshot
modified_at / ingested_at dateModified / prov:wasGeneratedBy Package modification and Codex ingestion times
source / source_system prov:wasAttributedTo overture
source_feed axiom:sourceFeed (overture-maps-places) Governed source identifier
source_uri isBasedOn Upstream source record URI
acl_tier axiom:aclTier Governed access-tier label; not an access grant
schema_version / normalization_version schemaVersion Codex projection and normalization versions

4. FAIR compliance

Principle Status
F ✅ (schema.org + DCAT-US for discovery)
A ✅ (Parquet)
I ✅ (schema.org primary, Overture taxonomy, H3)
R ⚠️ (per-record upstream licenses and notices apply)

5. Deviations

  • Overture taxonomy, not NAICS. Categories are Overture's own taxonomy (primary_type, types); the package carries no NAICS, ISIC, or GLN codes.
  • Observation times are not lifecycle dates. first_seen_at, last_seen_at, and observed_at describe source observations, not verified openings or closures.
  • No cross-source entity resolution. Each row is one Overture Maps Places record; upstream identifiers are preserved in id and overture_id.

6. Changelog

  • v1.0 (2026-04-16) — Initial crosswalk. AXC-12 schema spec pending.
  • 2026-10-06 — Field mapping limited to the governed POI package columns.
← all standardsRead the standard →