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: derivative (base feeds retain upstream licenses — Foursquare CC-BY, OSM ODbL, Google Places restricted) → Codex commercial tier proprietary
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. Emitting our POIs as LocalBusiness JSON-LD gets the dataset into Google's Knowledge Graph and every generative AI that's scraping schema.org-flagged pages. GS1 GLN is the enterprise counterpart — retailers, logistics, and commercial real estate use GLN as the canonical location identifier.
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 |
"89K points of interest across U.S. metros with NAICS categorization, pioneer-flag classification, walkability and transit scores, and source-mapped identifiers." |
dcat:keyword |
["poi", "local-business", "naics", "pioneer-businesses", "walkability", "retail"] |
dcat:theme |
["http://publications.europa.eu/resource/authority/data-theme/ECON"] |
dct:license |
mixed (see below) |
2.1 License complexity
POI data combines multiple upstream licenses. Codex publishes three distributions:
| Distribution | License |
|---|---|
open — OSM-only subset |
ODbL-1.0 |
research — OSM + Foursquare CC-BY subset |
CC-BY-4.0 |
commercial — full including Google Places, licensed uplift from CBRE and AlphaDex |
proprietary |
3. Record-level crosswalk → schema.org/LocalBusiness
{
"@context": [
"https://schema.org",
{"axiom": "https://axiomcodex.io/ns/v1/"}
],
"@type": "LocalBusiness",
"@id": "urn:aprs:record:poi:foursquare:5a92f8a...",
"identifier": [
{"@type": "PropertyValue", "propertyID": "Foursquare", "value": "5a92f8a..."},
{"@type": "PropertyValue", "propertyID": "GS1 GLN", "value": "0614141999996"}
],
"name": "Example Cafe",
"address": {"@type": "PostalAddress", "streetAddress": "123 Main St", ...},
"geo": {"@type": "GeoCoordinates", "latitude": 40.7, "longitude": -74.0},
"telephone": "+1-212-555-0100",
"url": "https://example-cafe.com",
"isicV4": "5610",
"axiom:naicsCode": "722513",
"axiom:h3Index": "88283082b9fffff",
"axiom:isPioneer": true,
"axiom:walkScore": 92,
"axiom:transitScore": 85,
"axiom:photoCount": 47
}
3.1 Field-by-field mapping
| Codex field | schema.org | GS1 GLN |
|---|---|---|
poi_id |
@id |
— |
name |
name |
locationName (GLN term) |
category |
additionalType (IRI) |
locationRoleCode |
subcategory |
additionalType (IRI) |
— |
naics_code |
axiom:naicsCode (no schema.org slot) |
locationIndustryClassification |
isic_code |
isicV4 |
— |
lat / lng |
geo.GeoCoordinates |
locationCoordinates |
h3_index |
axiom:h3Index |
— |
address |
address.PostalAddress |
locationAddress |
phone |
telephone |
— |
website |
url |
locationWebsite |
is_pioneer |
axiom:isPioneer (bool) |
— |
walk_score |
axiom:walkScore |
— |
transit_score |
axiom:transitScore |
— |
reviews_sample |
review[] (partial) |
— |
photo_count |
axiom:photoCount |
— |
source_feed |
axiom:sourceFeed (foursquare / osm / google / manual) |
— |
3.2 GS1 GLN
GLN values are computed (not reused from source feeds) using GS1 CIN assignment when a canonical physical location is confirmed (≥2 sources agree on coordinates within 50m). Unmatched POIs omit GLN.
4. Pioneer businesses — Codex extension
The axiom:isPioneer flag has no counterpart in schema.org. It's a Codex-defined signal indicating a POI opened in the last 12 months in a growth context (rising surrounding cell-score, positive migration, new construction permits nearby). Documented at https://axiomcodex.io/ns/v1/isPioneer.jsonld (pending AXC-3).
5. FAIR compliance
| Principle | Status |
|---|---|
| F | ✅ (schema.org + DCAT-US for discovery) |
| A | ✅ (HTTPS JSON-LD + Parquet + OGC Features API) |
| I | ✅ (schema.org primary, NAICS + ISIC + GLN parallel) |
| R | ⚠️ (license is tier-dependent; Axiom extensions fully open) |
6. Deviations
- Multi-source identity. A single real-world POI can have multiple source identifiers (Foursquare ID + OSM ID + Google Place ID). Entity resolution (AXC-22) maps them to a shared
entity_urn; source-native IDs are preserved in theidentifier[]array. - NAICS vs ISIC vs schema.org taxonomies. schema.org uses its own controlled vocab for
additionalType; NAICS and ISIC are out of band. We publish all three side by side. - Reviews are sampled, not complete. schema.org
review[]is populated with up to 5 representative reviews per POI; full reviews are not redistributable under upstream licenses.
7. Changelog
- v1.0 (2026-04-16) — Initial crosswalk. AXC-12 schema spec pending.