walkthru-earth/geocoding-playground — explained in plain English
Analysis updated 2026-05-18
Look up the map location of a street address or postcode entirely in the browser
Find the nearest known address by clicking a point on the map
Embed the framework-agnostic geocoding library into a React, Vue, or Next.js app
Search addresses in multiple languages and countries with automatic abbreviation matching
| walkthru-earth/geocoding-playground | adguardteam/adguardmv3 | dex-original/okx-agent-trade-kit | |
|---|---|---|---|
| Stars | 145 | 146 | 144 |
| Language | TypeScript | TypeScript | TypeScript |
| Last pushed | — | 2024-07-12 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | moderate | moderate |
| Complexity | 3/5 | 3/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Geocoding Playground is a tool that runs entirely in your browser and lets you look up addresses, no server required. You can type in a street address or postcode and get back the matching location on a map (forward geocoding), or click anywhere on the map to find the nearest known address (reverse geocoding). What makes it unusual is the scale and approach. It queries a dataset of over 469 million addresses sourced from Overture Maps, a large open geographic data project. Rather than sending your queries to a backend server, the tool runs a real database engine (DuckDB) directly inside your browser using a technology called WebAssembly, and fetches only the relevant slices of the address data files over the internet as needed. Address parsing is country-aware, with dedicated logic for ten countries including the US, Japan, Germany, France, and others. The Japanese parser handles native script and can match addresses written with or without spaces. Street type abbreviations are expanded across 27 languages, so searching "avenue" will also match results stored as "ave." Results appear as markers on an interactive map. Multi-unit buildings show individual unit rows grouped by location so dense city blocks stay readable. The project is split into two parts: a standalone TypeScript library that handles all the geocoding logic and can be embedded in any web app, and a Svelte-based demo interface that showcases it. A live demo is available at walkthru.earth.
A browser-only geocoder that searches 469 million real-world addresses using an in-browser database, with no backend server needed.
Mainly TypeScript. The stack also includes TypeScript, Svelte, DuckDB-WASM.
Free to share and adapt for any purpose, including commercial use, as long as you give appropriate credit.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.