Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/martgnz/es-atlas

Pre-built TopoJSON from the Spanish National Geographic Institute.
https://github.com/martgnz/es-atlas

d3-geo d3js spain topojson

Last synced: 18 days ago
JSON representation

Pre-built TopoJSON from the Spanish National Geographic Institute.

Awesome Lists containing this project

README 

        
# Spain Atlas TopoJSON






This repository provides a simple script to generate TopoJSON files from the [Spanish National Geographic Institute’s](http://www.ign.es/ign/main/index.do) [National Reference Geographic Equipment](http://centrodedescargas.cnig.es/CentroDescargas/equipamiento.do?method=mostrarEquipamiento) vector data.



## Getting started



Clone or download the repository, start a terminal and run `npm install` in the folder. This command will download the shapefiles from the IGN, join them and convert them to [TopoJSON](https://github.com/topojson/topojson).



If you need to make further adjustments (simplification, quantization) you can adjust the `package.json` config and run `npm install` again.



## File Reference



# es/municipalities.json · [Download](https://unpkg.com/es-atlas/es/municipalities.json)



A TopoJSON which contains four objects: _municipalities_, _provinces_, _autonomous regions_ and _border_. Every city, province and region has its corresponding [National Statistics Institute](http://www.ine.es/en/welcome.shtml) identifier and name, so it's easy to get started.



# _es_.objects.municipalities






# _es_.objects.provinces






# _es_.objects.autonomous_regions






# _es_.objects.border






# es/provinces.json · [Download](https://unpkg.com/es-atlas/es/provinces.json)



This file provides provinces and autonomous regions, to keep a smaller footprint on less detailed maps.



# es/autonomous_regions.json · [Download](https://unpkg.com/es-atlas/es/autonomous_regions.json)



This file only provides autonomous regions, to keep a smaller footprint on less detailed maps.



## Usage



To render the map I recommend using the `geoConicConformalSpain` projection created by Roger Veciana, included in [d3-composite-projections](https://github.com/rveciana/d3-composite-projections). This projection ensures that the Canary Islands are painted closer to the mainland and [include a border](https://bl.ocks.org/rveciana/d635afded8c4eae36ecf61a15bdf0a98) to mark the projection zone.



You can see an interactive example in this [Observable notebook](https://observablehq.com/@martgnz/mapa-de-espana-con-topojson-y-es-atlas).



For the browser with [d3-geo](https://github.com/d3/d3-geo) and SVG:



```html



const svg = d3.select("svg");

const projection = d3.geoConicConformalSpain();

const path = d3.geoPath(projection);



d3.json("https://unpkg.com/es-atlas/es/municipalities.json")

  .catch(err => console.warn(err))

  .then(es => {

    svg

      .append('path')

      .attr('d', path(topojson.mesh(es)))

      .attr('fill', 'none')

      .attr('stroke', 'black');



    svg

      .append('path')

      .attr('d', projection.getCompositionBorders())

      .attr('fill', 'none')

      .attr('stroke', 'black');

  })



```



In Node (using [d3-geo](https://github.com/d3/d3-geo) and [node-canvas](https://github.com/Automattic/node-canvas)):



```js

const fs = require('fs');

const d3_composite = require('d3-composite-projections');

const d3 = require('d3-geo');

const topojson = require('topojson-client');

const Canvas = require('canvas');

const es = require('./node_modules/es-atlas/es/municipalities.json');



const canvas = new Canvas(960, 500);

const context = canvas.getContext('2d');

const projection = d3_composite.geoConicConformalSpain();

const path = d3.geoPath(projection, context);



context.beginPath();

path(topojson.mesh(es));

context.stroke();



canvas.pngStream().pipe(fs.createWriteStream('preview.png'));

```



### Reference



# simplification



Removes points to reduce the file size. Set to `1e-4` by default.



# quantization



Removes information by reducing the precision of each coordinate. Set to `1e4` by default.



# autonomous_regions



Filters the result by the given [autonomous region](http://www.ine.es/en/daco/daco42/codmun/cod_ccaa_en.htm) `id` separated by comma.



### Data license



The shapefiles have a [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/) license. You need to accept the [terms](http://www.ign.es/resources/licencia/Condiciones_licenciaUso_IGN.pdf) before using the files.



### Inspiration



The original idea and implementation comes from Mike Bostock’s [us-atlas](https://github.com/topojson/us-atlas) and [world-atlas](https://github.com/topojson/world-atlas).