OGLAPOffline Grid Location Addressing
Developers

Encode any coordinate in three lines, fully offline.

Reference SDKs in JavaScript, Python, and Dart. Deterministic by design: identical inputs produce identical codes on every device, with no API key, no rate limit, and no network dependency.

Zero network calls
Deterministic output
MIT + Attribution
Install

Add the SDK to your project.

$npm install oglap-ggp-nodeJavaScript
$pip install oglapPython
$flutter pub add oglap --git-url=https://github.com/Guinee-IO/oglap-ggp-dart-flDart / Flutter
Loading playground…
SDK Reference

Core API surface.

initOglap({ profile, localitiesNaming }) → Reportasync

Runs the validation pre-flight (schema, country bounds, package-version compatibility, dataset alignment) and loads engine state. Supports direct mode (in-memory objects) and download mode (pinned dataset, persisted to local cache).

coordinatesToLap(lat, lng) → LapResult

Resolves the administrative context, computes the local or national grid, and returns the full LAP code, the derived human address, and the decomposed segments. Four input-validation gates reject non-finite, out-of-range, and out-of-territory coordinates.

lapToCoordinates(code) → Location

Parses a LAP code and reverses the grid arithmetic to recover the coordinate at the centre of the addressed microspot, together with the administrative segments.

getPlaceByLapCode(code) → Place

Point-in-polygon containment against an R-tree (Flatbush) index; returns the smallest containing administrative boundary and bubbles up missing hierarchical fields from enclosing parents. Non-mutating, antimeridian-safe.

validateLapCode(code) → Report

Returns a deterministic report enumerating every check as pass, warn, or fail. The engine refuses to apply state on any fatal condition, so stale or malformed configurations cannot silently degrade accuracy.

Copied