dkaoster / taiwan-atlas

Pre-built TopoJSON from the Ministry of the Interior.

Taiwan Atlas TopoJSON

Similar to the topojson/us-atlas project, this repository provides a topojson redistribution of the shapefiles provided by Taiwan's Ministry of the Interior. See the demo for usage example.

All of these files are provided at a scale of 1:10 thousand.

File Reference

# villages-10t.json · Download

A TopoJSON file containing the geometry collections villages, towns, counties, and nation. The geometry is quantized and simplified, but not projected. This topology is derived from the Ministry of the Interior’s 村里界圖(TWD97經緯度). The town boundaries are computed by merging villages, the county boundaries by merging towns, and the nation boundary is computed by merging counties, ensuring a consistent topology.

# villages-mercator-10t.json · Download

A TopoJSON file containing the geometry collections villages, towns, counties, and nation. The geometry is quantized, simplified, and projected with the mercatorTw projection. This topology is derived from the Ministry of the Interior’s 村里界圖(TWD97經緯度). The town boundaries are computed by merging villages, the county boundaries by merging towns, and the nation boundary is computed by merging counties, ensuring a consistent topology. This file also contains a compBorders object for optionally drawing the borders of the composed areas.

# towns-10t.json · Download

A TopoJSON file containing the geometry collections towns, counties, and nation. The geometry is quantized and simplified, but not projected. This topology is derived from the Ministry of the Interior’s 鄉鎮市區界線(TWD97經緯度). The county boundaries are computed by merging towns and the nation boundaries by merging counties, ensuring a consistent topology.

# towns-mercator-10t.json · Download

A TopoJSON file containing the geometry collections towns, counties, and nation. The geometry is quantized, simplified, and projected with the mercatorTw projection. This topology is derived from the Ministry of the Interior’s 鄉鎮市區界線(TWD97經緯度). The county boundaries are computed by merging towns and the nation boundaries by merging counties, ensuring a consistent topology. This file also contains a compBorders object for optionally drawing the borders of the composed areas.

# districts-10t.json · Download

A TopoJSON file containing the geometry collections districts specifying legislative districts, counties, and nation. The geometry is quantized and simplified, but not projected. This topology is derived from the Ministry of the Interior’s 鄉鎮市區界線(TWD97經緯度) and combined via the districts specified in this json file. The county boundaries are computed by merging districts and the nation boundaries by merging counties, ensuring a consistent topology.

# districts-mercator-10t.json · Download

A TopoJSON file containing the geometry collections districts specifying legislative districts, counties, and nation. The geometry is quantized, simplified, and projected with the mercatorTw projection. This topology is derived from the Ministry of the Interior’s 鄉鎮市區界線(TWD97經緯度) and combined via the districts specified in this json file. The county boundaries are computed by merging districts and the nation boundaries by merging counties, ensuring a consistent topology. This file also contains a compBorders object for optionally drawing the borders of the composed areas.

# counties-10t.json · Download

A TopoJSON file containing the geometry collections counties, and nation. The geometry is quantized and simplified, but not projected. This topology is derived from the Ministry of the Interior’s 直轄市、縣市界線(TWD97經緯度). The nation boundaries are computed by merging counties, ensuring a consistent topology.

# counties-mercator-10t.json · Download

A TopoJSON file containing the geometry collections counties and nation. The geometry is quantized, simplified, and projected with the mercatorTw projection. This topology is derived from the Ministry of the Interior’s 直轄市、縣市界線(TWD97經緯度). The nation boundaries are computed by merging counties, ensuring a consistent topology. This file also contains a compBorders object for optionally drawing the borders of the composed areas.

# nation-10t.json · Download

A TopoJSON file containing the geometry collections nation. The geometry is quantized and simplified, but not projected. This topology is derived from the Ministry of the Interior’s 直轄市、縣市界線(TWD97經緯度).

# nation-mercator-10t.json · Download

A TopoJSON file containing the geometry collections nation. The geometry is quantized, simplified, and projected with the mercatorTw projection. This topology is derived from the Ministry of the Interior’s 直轄市、縣市界線(TWD97經緯度). This file also contains a compBorders object for optionally drawing the borders of the composed areas.

# tw.objects.nation

The nation object has two fields:

• nation.properties.ID - "TW"
• nation.properties.NAME - "Taiwan"

# tw.objects.counties

The county object has the following fields:

• county.properties.COUNTYNAME - The name of the county in Chinese
• county.properties.COUNTYENG - The name of the county in English
• county.properties.COUNTYID - The character specifying id
• county.properties.COUNTYCODE - The five digit county code

# tw.objects.towns

The town object has the following fields in addition to the county fields:

• town.properties.TOWNNAME - The name of the county in Chinese
• town.properties.TOWNENG - The name of the county in English
• town.properties.TOWNID - The character specifying id
• town.properties.TOWNCODE - The eight digit county code

# tw.objects.districts

The district object has the following fields in addition to the county fields:

• district.properties.DISTRICTCODE - The eight digit county code dash (-) the district number

# tw.objects.villages

The village object has the following fields in addition to the town and county fields:

• village.properties.VILLNAME - The name of the village in Chinese
• village.properties.VILLENG - The name of the village in English
• village.properties.VILLID - The village specifying id
• village.properties.VILLCODE - The 11 digit county code

The compBorders object has the following fields:

• compBorders.properties.BORDERLEVEL - The administrative level that this border encompasses.
• compBorders.properties.NAME - The name in Chinese of the administrative area that this border encompasses.
• compBorders.properties.ID - The id of the administrative area that this border encompasses.
• compBorders.properties.CODE - The name of the administrative area that this border encompasses.
• compBorders.properties.ENG - The name in English of the administrative area that this border encompasses.

MercatorTw Projection

mercatorTw.js uses a Taiwan-centric composite projection of four d3.geoMercator projections: One for the main island, and one for each of Penghu, Kinmen, Lienchiang, and Wuqiu respectively.

mercatorTw.getCompositionBorders() returns a svg path string of the borders, given the current scale and translation.

This package exports the mercatorTw projection and can be used in your own projects.

import mercatorTw from 'taiwan-atlas';

License

MIT

taiwan-atlas's Issues

Add Legislative Districts

Because Taiwan's legislative districts do not directly correspond with either its towns or villages, add an extra layer for legislative districts.

Weird artifacts in non-projected map

There are some weird extra lines in the non-projected map, that should be fixed.

Can not render correct map

@dkaoster
Thanks in advance for your awesome work.

But I got an issue to render your preprojected towns-mercator-10t.json file

I use following code in react to render a president election map

const rawProject: GeoRawProjection = function (x, y) {
  return [x, -y];
};

function myProjection() {
  return geoProjection(rawProject).precision(0).scale(2).translate([0, 0]);
}

const pathGenerator = d3.geoPath().projection(myProjection);

useEffect(() => {
  const g1 = d3.select(countiesRef.current);
  g1.selectAll("path")
    .data(counties.features)
    .join("path")
    .attr("fill", (feature) => countyColor(feature.properties.countyName))
    .attr("stroke", grey[200])
    .attr("stroke-width", 1)
    .attr("d", (feature) => pathGenerator(feature));
}, [myProjection, pathGenerator]);

and I got this broken map

Could you help me to fix this?

English Locality Names

Turns out, the shp files only contain the english names of the localities for the layer that shp file is for. In other words, the village shp file only has the english names for villages, not towns and counties. Therefore, there needs to be a properties processing step to get all the locality names right and also to help with #9.

Add outer island frames

Add frames to translated islands.

Change to date-based versioning to make historical mapping easier

In order to make it easier to publish and version maps by date (boundaries change), change versioning to be done by date.

Use 台 instead of 臺

The data that comes in from the ministry of the interior uses 臺, but should default it to 台.