mapjson

Overview

mapjson returns topojson (or geojson) for any geographic layer in a single AJAX call. The shortest possible call returns 110m world countries with no attached properties — the most common use case for a world map.

// Minimal call — 110m world countries, no properties
d3.json("https://api.mapjson.com/v1/geo").then(topo => {
  const countries = topojson.feature(topo, topo.objects.geo);
  // draw your map
});

// With filtering and properties
d3.json("https://api.mapjson.com/v1/geo?layer=countries&filter=europe&detail=medium&properties=name,iso2")
  .then(topo => { /* ... */ });

Endpoint

Layers

Detail Levels

Properties

Available on countries and regions layers. No properties are returned by default — pass ?properties=name,iso2 to request specific fields. This keeps the default response as small as possible.

Examples

https://api.mapjson.com/v1/geo

https://api.mapjson.com/v1/geo?layer=countries&filter=europe&detail=medium&properties=name,iso2

https://api.mapjson.com/v1/geo?layer=regions&filter=FR&detail=high

https://api.mapjson.com/v1/geo?layer=regions&filter=US&detail=medium

https://api.mapjson.com/v1/geo?layer=regions&filter=PL&detail=high

https://api.mapjson.com/v1/geo?layer=lakes&detail=medium&format=geojson

Response

The default response is a topojson Topology object. The feature collection is always at topo.objects.geo regardless of which layer you requested. All responses include Access-Control-Allow-Origin: *.

{
  "type": "Topology",
  "objects": {
    "geo": {
      "type": "GeometryCollection",
      "geometries": [
        {
          "type": "Polygon",
          "arcs": [[0, 1, 2]],
          "properties": {
            "name": "France",
            "iso2": "FR",
            "iso3": "FRA",
            "isoNum": "250",
            "continent": "Europe",
            "capital": "Paris",
            "capitalLat": 48.8566,
            "capitalLng": 2.3515
          }
        }
        // ...
      ]
    }
  },
  "arcs": [ ... ],
  "bbox": [-180, -90, 180, 90]
}

When no properties parameter is given, each feature's properties object is empty ({}).

Country Codes

Use these ISO alpha-2 codes with the filter parameter (e.g. filter=DE) to retrieve a specific country.