https://github.com/dkaoster/taiwan-atlas
Pre-built TopoJSON from the Ministry of the Interior.
https://github.com/dkaoster/taiwan-atlas
atlas taiwan topojson
Last synced: 2 months ago
JSON representation
Pre-built TopoJSON from the Ministry of the Interior.
- Host: GitHub
- URL: https://github.com/dkaoster/taiwan-atlas
- Owner: dkaoster
- License: mit
- Created: 2020-11-26T02:26:22.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-06-18T01:17:58.000Z (over 1 year ago)
- Last Synced: 2025-04-10T03:51:38.737Z (7 months ago)
- Topics: atlas, taiwan, topojson
- Language: JavaScript
- Homepage: https://observablehq.com/@dkaoster/taiwan-map
- Size: 22.7 MB
- Stars: 140
- Watchers: 4
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Taiwan Atlas TopoJSON
Similar to the [topojson/us-atlas](https://github.com/topojson/us-atlas) project, this repository provides a topojson redistribution of the shapefiles provided by Taiwan's Ministry of the Interior. See [the demo](https://observablehq.com/@dkaoster/taiwan-map) for usage example.
All of these files are provided at a scale of 1:10 thousand.
## File Reference
# villages-10t.json · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/villages-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7438). The town boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) 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](https://cdn.jsdelivr.net/npm/taiwan-atlas/villages-mercator-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7438). The town boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) 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](https://cdn.jsdelivr.net/npm/taiwan-atlas/towns-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7441). The county boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) towns and the nation boundaries by merging counties, ensuring a consistent topology.
# towns-mercator-10t.json · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/towns-mercator-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7441). The county boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) 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](https://cdn.jsdelivr.net/npm/taiwan-atlas/districts-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7441) and combined via the districts specified in [this json file](https://github.com/dkaoster/taiwan-atlas/blob/master/utils/districts.json). The county boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) districts and the nation boundaries by merging counties, ensuring a consistent topology.
# districts-mercator-10t.json · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/districts-mercator-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7441) and combined via the districts specified in [this json file](https://github.com/dkaoster/taiwan-atlas/blob/master/utils/districts.json). The county boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) 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](https://cdn.jsdelivr.net/npm/taiwan-atlas/counties-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7442). The nation boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) counties, ensuring a consistent topology.
# counties-mercator-10t.json · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/counties-mercator-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7442). The nation boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) 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](https://cdn.jsdelivr.net/npm/taiwan-atlas/nation-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7442).
# nation-mercator-10t.json · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/nation-mercator-10t.json "Source")
A [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) 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經緯度)](https://data.gov.tw/dataset/7442). 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](https://github.com/d3/d3-geo#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.
```js
import mercatorTw from 'taiwan-atlas';
```
## License
MIT