{"id":26210789,"url":"https://github.com/dkaoster/taiwan-atlas","last_synced_at":"2025-08-22T13:17:59.226Z","repository":{"id":40278172,"uuid":"316102736","full_name":"dkaoster/taiwan-atlas","owner":"dkaoster","description":"Pre-built TopoJSON from the Ministry of the Interior.","archived":false,"fork":false,"pushed_at":"2024-06-18T01:17:58.000Z","size":23804,"stargazers_count":140,"open_issues_count":2,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-10T03:51:38.737Z","etag":null,"topics":["atlas","taiwan","topojson"],"latest_commit_sha":null,"homepage":"https://observablehq.com/@dkaoster/taiwan-map","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dkaoster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-26T02:26:22.000Z","updated_at":"2025-03-14T07:46:12.000Z","dependencies_parsed_at":"2024-01-12T02:45:19.077Z","dependency_job_id":"f0847075-ae63-4509-883c-69f7b0f2b0ef","html_url":"https://github.com/dkaoster/taiwan-atlas","commit_stats":{"total_commits":59,"total_committers":3,"mean_commits":"19.666666666666668","dds":"0.44067796610169496","last_synced_commit":"f583a872d958ddd5443a7e4342619010667ab2ab"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaoster%2Ftaiwan-atlas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaoster%2Ftaiwan-atlas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaoster%2Ftaiwan-atlas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaoster%2Ftaiwan-atlas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dkaoster","download_url":"https://codeload.github.com/dkaoster/taiwan-atlas/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248154998,"owners_count":21056542,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atlas","taiwan","topojson"],"created_at":"2025-03-12T07:34:16.439Z","updated_at":"2025-04-10T03:51:40.203Z","avatar_url":"https://github.com/dkaoster.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Taiwan Atlas TopoJSON\n\nSimilar 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.\n\nAll of these files are provided at a scale of 1:10 thousand.\n\n## File Reference\n\n\u003ca href=\"#villages-10t.json\" name=\"villages-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003evillages-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/villages-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003evillages\u003c/i\u003e, \u003ci\u003etowns\u003c/i\u003e, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#villages-mercator-10t.json\" name=\"villages-mercator-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003evillages-mercator-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/villages-mercator-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003evillages\u003c/i\u003e, \u003ci\u003etowns\u003c/i\u003e, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#towns-10t.json\" name=\"towns-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003etowns-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/towns-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003etowns\u003c/i\u003e, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#towns-mercator-10t.json\" name=\"towns-mercator-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003etowns-mercator-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/towns-mercator-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003etowns\u003c/i\u003e, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#districts-10t.json\" name=\"districts-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003edistricts-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/districts-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003edistricts\u003c/i\u003e specifying legislative districts, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#districts-mercator-10t.json\" name=\"districts-mercator-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003edistricts-mercator-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/districts-mercator-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003edistricts\u003c/i\u003e specifying legislative districts, \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#counties-10t.json\" name=\"counties-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003ecounties-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/counties-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003ecounties\u003c/i\u003e, and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#counties-mercator-10t.json\" name=\"counties-mercator-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003ecounties-mercator-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/counties-mercator-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003ecounties\u003c/i\u003e and \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#nation-10t.json\" name=\"nation-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003enation-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/nation-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003enation\u003c/i\u003e. 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).\n\n\u003ca href=\"#nation-mercator-10t.json\" name=\"nation-mercator-10t.json\"\u003e#\u003c/a\u003e \u003cb\u003enation-mercator-10t.json\u003c/b\u003e · [Download](https://cdn.jsdelivr.net/npm/taiwan-atlas/nation-mercator-10t.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections \u003ci\u003enation\u003c/i\u003e. 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.\n\n\u003ca href=\"#tw.objects.nation\" name=\"tw.objects.nation\"\u003e#\u003c/a\u003e tw.objects\u003cb\u003e.nation\u003c/b\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/dkaoster/taiwan-atlas/master/img/nation.png\" width=\"50%\"\u003e\n\nThe nation object has two fields:\n- nation.properties.ID - \"TW\"\n- nation.properties.NAME - \"Taiwan\"\n\n\u003ca href=\"#tw.objects.counties\" name=\"tw.objects.counties\"\u003e#\u003c/a\u003e tw.objects\u003cb\u003e.counties\u003c/b\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/dkaoster/taiwan-atlas/master/img/counties.png\" width=\"50%\"\u003e\n\nThe county object has the following fields:\n- county.properties.COUNTYNAME - The name of the county in Chinese\n- county.properties.COUNTYENG - The name of the county in English\n- county.properties.COUNTYID - The character specifying id\n- county.properties.COUNTYCODE - The five digit county code\n\n\u003ca href=\"#tw.objects.towns\" name=\"tw.objects.towns\"\u003e#\u003c/a\u003e tw.objects\u003cb\u003e.towns\u003c/b\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/dkaoster/taiwan-atlas/master/img/towns.png\" width=\"50%\"\u003e\n\nThe town object has the following fields in addition to the county fields:\n- town.properties.TOWNNAME - The name of the county in Chinese\n- town.properties.TOWNENG - The name of the county in English\n- town.properties.TOWNID - The character specifying id\n- town.properties.TOWNCODE - The eight digit county code\n\n\u003ca href=\"#tw.objects.districts\" name=\"tw.objects.districts\"\u003e#\u003c/a\u003e tw.objects\u003cb\u003e.districts\u003c/b\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/dkaoster/taiwan-atlas/master/img/districts.png\" width=\"50%\"\u003e\n\nThe district object has the following fields in addition to the county fields:\n- district.properties.DISTRICTCODE - The eight digit county code dash (-) the district number\n\n\u003ca href=\"#tw.objects.villages\" name=\"tw.objects.villages\"\u003e#\u003c/a\u003e tw.objects\u003cb\u003e.villages\u003c/b\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/dkaoster/taiwan-atlas/master/img/villages.png\" width=\"50%\"\u003e\n\nThe village object has the following fields in addition to the town and county fields:\n- village.properties.VILLNAME - The name of the village in Chinese\n- village.properties.VILLENG - The name of the village in English\n- village.properties.VILLID - The village specifying id\n- village.properties.VILLCODE - The 11 digit county code\n\nThe compBorders object has the following fields:\n- compBorders.properties.BORDERLEVEL - The administrative level that this border encompasses.\n- compBorders.properties.NAME - The name in Chinese of the administrative area that this border encompasses.\n- compBorders.properties.ID - The id of the administrative area that this border encompasses.\n- compBorders.properties.CODE - The name of the administrative area that this border encompasses.\n- compBorders.properties.ENG - The name in English of the administrative area that this border encompasses.\n\n## MercatorTw Projection\n\n`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.\n\n`mercatorTw.getCompositionBorders()` returns a svg path string of the borders, given the current scale and translation.\n\nThis package exports the mercatorTw projection and can be used in your own projects.\n\n```js\nimport mercatorTw from 'taiwan-atlas';\n```\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkaoster%2Ftaiwan-atlas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdkaoster%2Ftaiwan-atlas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkaoster%2Ftaiwan-atlas/lists"}