DevTools Logo

World Map

About this tool

The World Map is a drill-down atlas: start at the whole globe, click a country to open its states or provinces, then click one of those for its districts — all rendered as real vector boundaries with d3-geo and SVG, not map tiles. The boundaries are same-origin static files, so the tool needs no map API key, account, tile provider, or geocoding request; choropleth values stay in your browser.

Depth varies honestly by what open data actually covers. The current snapshot has top-level provinces/states (ADM1) for 236 countries and territories, and 51 curated countries go one level further to districts (ADM2) — Turkey's 81 provinces and their ilçe, for example. Natural Earth's roughly 7,333 populated-place points appear with population and capital status and are scoped to the focused boundary. They are a useful mapped sample, not a complete list of every city or village. Village- or neighborhood-level polygon boundaries are not part of a complete open global dataset, so the map does not pretend to have them.

Hovering a region highlights its border and shows its name; clicking drills in with a short animated zoom into that region's bounding box (skipped automatically if your system has reduced motion turned on). A breadcrumb trail and a Back button retrace your steps, browser Back/Forward works the same way through a `?r=` URL parameter, and a search box jumps straight to any country or region by name without clicking through the hierarchy.

Beyond navigation, the map doubles as a small GIS utility: paste your own CSV or JSON data to color the currently visible regions as a choropleth with an auto-generated legend, then export what's on screen as SVG or PNG (or copy the PNG straight to your clipboard), or copy/download the GeoJSON for the region you're looking at.

How to use

  1. Open the map

    The tool loads straight into the world view — every country is already on screen and clickable.

  2. Hover to identify

    Move over any country to see its border highlighted and its name in a tooltip.

  3. Click to drill in

    Click a country for its provinces/states, then a province for its districts; click a leaf district to fit its boundary and see only its mapped settlements.

  4. Search or step back

    Jump straight to a place with the search box, or retrace your steps with the breadcrumb or the Back button.

  5. Color and export

    Paste CSV or JSON into the choropleth panel to color the map, then export it as SVG, PNG, or GeoJSON.

Use cases

Teaching geography live

Drill from continent to country to district in front of a class without switching tools or waiting on tile servers.

Visualizing regional data

Paste a population, sales, or survey-results CSV keyed by country or region code and get an instant colored map with a legend.

Grabbing a quick region boundary

Copy the GeoJSON for a single country, province, or district instead of hunting through a full shapefile download for one shape.

Producing a map graphic

Export a clean SVG or PNG of any region at any zoom level for a slide, blog post, or report — no watermark, no attribution to strip out first.

Common mistakes

Mistake:Expecting district-level detail everywhere

Fix:Only about 51 curated countries have district (ADM2) boundaries; the rest stop at state/province, with settlement points shown below that as a reference, not a boundary.

Mistake:Pasting choropleth codes that don't match anything on screen

Fix:Use ISO alpha-3 codes (TUR, DEU, FRA…) or the exact name shown on the map — the panel lists exactly which rows matched, which didn't, and which lines were unreadable.

Mistake:Reading settlement dots as administrative areas

Fix:Points at the deepest level mark named places only (with population and capital status) — no polygon exists for them in the source data, so they're drawn and labeled differently from the region shapes above.

Mistake:Assuming the map calls out to a tile or geocoding service

Fix:Every boundary is a static file served from the same origin as the page; nothing you paste into the choropleth panel is ever sent anywhere.

Frequently asked questions

References & standards