whatisgithub

What is geocoding-playground?

walkthru-earth/geocoding-playground — explained in plain English

Analysis updated 2026-05-18

145TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A browser-only geocoder that searches 469 million real-world addresses using an in-browser database, with no backend server needed.

Mindmap

mindmap
  root((geocoding-playground))
    What it does
      Browser only geocoding
      469 million addresses
      Forward and reverse lookup
    Tech Stack
      TypeScript
      Svelte
      DuckDB-WASM
    Use Cases
      Address lookup in browser
      Embed core library
      Multilingual address parsing
    Audience
      Developers
      Map builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Look up the map location of a street address or postcode entirely in the browser

USE CASE 2

Find the nearest known address by clicking a point on the map

USE CASE 3

Embed the framework-agnostic geocoding library into a React, Vue, or Next.js app

USE CASE 4

Search addresses in multiple languages and countries with automatic abbreviation matching

What is it built with?

TypeScriptSvelteDuckDB-WASMMapLibre GLTailwind CSS

How does it compare?

walkthru-earth/geocoding-playgroundadguardteam/adguardmv3dex-original/okx-agent-trade-kit
Stars145146144
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-07-12
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Free to share and adapt for any purpose, including commercial use, as long as you give appropriate credit.

So what is it?

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.

Copy-paste prompts

Prompt 1
Explain how this project runs a full database engine like DuckDB inside the browser with no backend
Prompt 2
Show me how to embed the geocoding-core TypeScript library in my own web app
Prompt 3
Walk me through running this project locally with pnpm and querying an address
Prompt 4
Explain how the country-aware address parsers handle formats like Japanese addresses in this repo

Frequently asked questions

What is geocoding-playground?

A browser-only geocoder that searches 469 million real-world addresses using an in-browser database, with no backend server needed.

What language is geocoding-playground written in?

Mainly TypeScript. The stack also includes TypeScript, Svelte, DuckDB-WASM.

What license does geocoding-playground use?

Free to share and adapt for any purpose, including commercial use, as long as you give appropriate credit.

How hard is geocoding-playground to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is geocoding-playground for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.