OGLAPOffline Grid Location Addressing
Start building
Open Addressing Protocol · v1.0.0

Addresses that belong to the territory they serve.

OGLAP turns a point on the map into an address with institutional memory: country, region, locality, grid cell, and microspot all carried in the code itself. The protocol works deterministically offline, with no API key, no vendor gate, and no network dependency.

GN
Country
ISO 3166-1
-
CON
Region
Conakry
-
QYTC
Zone
Yattaya Fossedè
-
B0B1
Macrobloc
100 m cell
-
2282
Microspot
1 m offset
Derived human addressB0B1-2282 Yattaya Fossedè, Conakry, Guinea
The Problem

A missing address is missing infrastructure.

When a place cannot be named in a stable, machine-readable way, the consequences compound: failed deliveries, slower emergency response, incomplete public records, and financial services that never arrive. The paradox is sharpest where connectivity is weakest.

4B
People worldwide with no formal, machine-readable address
440M
People in Africa (~30% of the population) without a formal address
~50%
Of urban environments globally remain poorly addressed
2.9B
Projected informal-settlement residents by 2050 (UN-Habitat)
Design Philosophy

A protocol with a point of view.

OGLAP starts from a simple conviction: an address should be usable by residents, legible to institutions, and computable by machines, even when the network disappears. Every format decision serves that idea.

01

Territory First

The code begins with real jurisdiction: country, region, local zone, then fine grid. An institution can sort, aggregate, audit, or delegate without asking an outside service where the address belongs.

02

Offline by Default

After the reference files are loaded, encoding and decoding happen locally. No server to reach, no quota to exhaust, no signal to hope for. The same coordinate produces the same code everywhere.

03

Readable Under Pressure

Short, visually distinct segments reduce the effort of reading, dictating, and transcribing. OGLAP is designed for forms, phone calls, notebooks, SMS, and real workflows, not only databases.

04

Sovereign and Open

Released under MIT with attribution, OGLAP can be audited, adapted, and governed locally. No vendor controls access to the protocol, the data, or the evolution of a national deployment.

05

Portable Without Flattening Place

The engine stays common, but each country brings its own hierarchy, boundaries, and naming conventions. Portability does not mean flattening the world; it means making each territory computable on its own terms.

Core Idea

One point, two useful forms.

Most geocoders choose between machine precision and human readability. OGLAP produces both from the same computation: a formal code for systems, and a local address people can actually say and recognize.

Machines
GN-CON-QYTC-B0B1-2282
Predictable, compact, and hierarchical. Systems can index it, validate it, sort it by prefix, and connect it to administrative levels without an external geocoding service.
People
B0B1-2282 Yattaya Fossedè, Conakry, Guinea
Short enough to copy, local enough to understand. It preserves microspot precision while giving the code a recognizable place name.
Technical Architecture · §5

The engine stays universal; the country lives in data.

Deploying OGLAP does not require rewriting the encoder. Territorial knowledge lives in three JSON files validated at startup: the boundaries, names, hierarchy, and rules that make a code truly belong to a country.

{cc}_oglap_country_profile.json

Defines how the grid behaves: cell sizes, alphabet, resolution rules, naming conventions, country extent, CRS, and version compatibility.

Country Profile
{cc}_localities_naming.json

Carries administrative geometries, zone codes, place identifiers, and parent-child relationships. It is the institutional map the protocol makes computable.

Localities Naming
{cc}_full.json

Bundles the places, structured addresses, metadata, and bounding boxes needed for spatial lookup and reverse geocoding.

Places Database
Comparative Analysis · §6

Built for public adoption, not just coordinate conversion.

DimensionWhat3WordsPlus CodesOGLAP
LicensingProprietary, patentedOpen (Apache 2.0)MIT + Attribution
Offline capabilityRecently addedFullFull · 3 config files
Code format///three.dictionary.words6CX8MC66+3Q4GN-CON-QYTC-B0B1-2282
Spatial precision3 m × 3 m~3.5 m max1 m × 1 m microspot
Spatial intuitionLowLowHigh · hierarchical
Administrative contextNoneNoneFull hierarchy
Gov. adoption readinessProprietary dependencyAbstract, non-territorialDesigned for institutions
Data sovereigntyCommercial serversTied to Google MapsFully sovereign & local

OGLAP

Technical White Paper & Protocol Specification
Version1.0.0
DateMay 2026
AuthorErnest Cece Peguita
ContributorsJean Gustave Delamou · Guinee IO
LicenseMIT + Attribution
StatusProduction · Public
Length32 pages
Read the white paper on Zenodo
Executive Summary

A protocol for places the network does not always reach.

For billions of people, the absence of an address is not an administrative anomaly: it is a daily infrastructure failure. It makes places harder to deliver to, rescue, register, finance, and govern.

Existing tools often solve the coordinate, but not the context. They describe a point in space without necessarily carrying the jurisdiction, governance, readability, or field constraints that determine whether an address will actually be adopted.

OGLAP proposes another path: embed the geocode in the administrative and territorial structure of the country that uses it. Its dual-format model gives systems a complete hierarchical code, such as GN-CON-QYTC-B0B1-2282, and gives people a derived, readable, local address, such as B0B1-2282 Yattaya Fossedè, Conakry, Guinea. The protocol remains portable by design, but every deployment respects the territory it serves.

Table of Contents
01Executive Summaryp. 4
02The Global Addressing Crisis: Problem Statementp. 6
03Survey of Existing Digital Addressing Systemsp. 8
04Introducing OGLAP: Design Philosophy & Rationalep. 11
05Technical Architecture of the OGLAP Protocolp. 12
06Comprehensive Comparative Analysisp. 19
07Strengths of the OGLAP Protocolp. 20
08Limitations, Risks & Mitigation Strategiesp. 24
09Use Cases & Deployment Scenariosp. 26
10Licensing, Governance & Intellectual Propertyp. 27
11Conclusion & Recommendationsp. 28
12Next Steps & Development Roadmapp. 29
AAppendix A: OGLAP Code Format Specificationp. 31
BAppendix B: Glossary of Termsp. 32
Get started

Test the protocol, then build with it.

Explore the full specification, try the engine in the developer playground, or integrate the reference SDKs directly.

Read the white paper on ZenodoDeveloper playground
Copied