Format documentation

Geolith .glx

A single-file format for search, autocomplete, reverse geocoding and lookup by id. The file header lists its parts: the search part, and a routing part that is specified but not built yet. A reader keeps a small part of the file in memory and fetches the rest with HTTP range requests, so the file can sit in R2, S3 or on local disk.

Capabilities

What you get

One file

The indexes and the records in one file. No database, no server-side index.

Range reads

A reader fetches byte ranges, from object storage or local disk.

Four questions

Search, autocomplete, reverse geocoding and lookup by id.

Versioned spec

Version 1, byte by byte, with sample files and their expected answers.

Command line

glx-build writes a file from a Postgres table, glx-query queries it, glx-parts merges parts.

Browser viewer

Open a local file or URL and query it on a map. Nothing is uploaded.

Navigate

Jump into the docs