# 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
```
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).
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.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
```
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).