🗺️ Conjunto de dados cartográficos de código aberto

O formato de Taiwan

SVG, GeoJSON, TopoJSON — dados cartográficos completos e de código aberto para desenvolvedores, designers e pesquisadores.

Por que o formato de Taiwan é importante

Peça a qualquer ferramenta de geração de imagens por IA para desenhar Taiwan e o resultado quase sempre será algo redondo e rechonchudo, entre uma azeitona e uma batata. Taiwan não é uma azeitona. É uma batata-doce de 394 quilômetros de comprimento, com uma cordilheira central que atravessa a ilha de norte a sul e mais de cem ilhas periféricas.

Representar o formato corretamente não é apenas um detalhe de design, mas uma questão de identidade. Esta página reúne todos os recursos cartográficos de código aberto que usamos no taiwan.md, para que qualquer pessoa possa representar Taiwan com precisão em seu próprio projeto.

🤖 vs. 🇹🇼 — A IA erra toda vez, de verdade

AI-generated Taiwan shape (wrong)
Gerado por IA (errado)
Correct Taiwan shape from Wikipedia
Versão correta (Wikipédia)

📐 Contornos SVG — incorporação direta

Quatro conjuntos selecionados de arquivos SVG, todos sob licenças CC ou em domínio público. Podem ser inseridos diretamente em qualquer página web, App ou projeto de design.

Taiwan icon — Wikipedia

taiwan-icon.svg

簡潔的填色輪廓 — 適合做 icon、favicon、按鈕。

Wikimedia Commons · CC

Baixar SVG
Taiwan outline — SimpleMaps

taiwan-simplemaps.svg

乾淨向量檔 — 適合網頁嵌入。

SimpleMaps · 5 KB

Baixar SVG
Taiwan location map with city markers

taiwan-location-map.svg

位置地圖 — 含經緯度網格與城市標記。

Wikimedia Commons · CC

Baixar SVG
Taiwan political division map with counties

taiwan-political-division.svg

縣市邊界 — 彩色行政區劃。

Wikimedia Commons · CC

Baixar SVG

Como usar

<!-- HTML -->
<img src="https://taiwan.md/assets/svg/taiwan-icon-wiki.svg" alt="Taiwan" width="200">

/* CSS */
background-image: url('https://taiwan.md/assets/svg/taiwan-icon-wiki.svg');

<!-- Markdown -->
![Taiwan](https://taiwan.md/assets/svg/taiwan-icon-wiki.svg)

Todos os SVG estão sob licenças Creative Commons ou em domínio público. A atribuição da fonte é recomendada, mas não obrigatória.

🌐 TopoJSON — mapa interativo por condado e cidade

Se você deseja criar um mapa interativo — com zoom, efeitos ao passar o mouse e cores baseadas em valores de dados — não precisa de caminhos SVG, mas de dados com coordenadas geográficas reais. Empacotamos os arquivos TopoJSON extraídos do taiwan-vue-components de Waiting (licença MIT, 2018).

TopoJSON é uma versão compactada do GeoJSON: as fronteiras compartilhadas entre condados e cidades vizinhos são armazenadas apenas uma vez, reduzindo o arquivo em 80%. Com topojson-client, é possível convertê-lo novamente em GeoJSON em tempo real.

TopoJSON vs GeoJSON — qual escolher

TopoJSON

TopoJSON: arquivos menores, fronteiras compartilhadas entre regiões vizinhas, ideal para mapas interativos na web.

GeoJSON

GeoJSON: formato simples, diretamente compatível com Python geopandas, QGIS e a maioria das ferramentas GIS.

Contorno nacional (22 condados e cidades)

Arquivo TopoJSON de aproximadamente 21 KB, contendo 22 condados, cidades e municípios especiais, cada um como uma feature independente. Um ponto de partida para criar mapas choropleth.

taiwan-country.topo.json
TopoJSON · 22 features · ~21 KB
Baixar TopoJSON

Dados municipais dos 22 condados e cidades

Empacotamos os arquivos TopoJSON em nível municipal de todos os 22 condados e cidades, extraídos do mesmo repo de origem.

taiwan-towns-63000.topo.json
臺北市 Taipei · 23 KB
Baixar TopoJSON
taiwan-towns-64000.topo.json
高雄市 Kaohsiung · 69 KB
Baixar TopoJSON
taiwan-towns-65000.topo.json
新北市 New Taipei · 24 KB
Baixar TopoJSON
taiwan-towns-66000.topo.json
臺中市 Taichung · 21 KB
Baixar TopoJSON
taiwan-towns-67000.topo.json
臺南市 Tainan · 27 KB
Baixar TopoJSON
taiwan-towns-68000.topo.json
桃園市 Taoyuan · 13 KB
Baixar TopoJSON
taiwan-towns-10002.topo.json
宜蘭縣 Yilan · 8 KB
Baixar TopoJSON
taiwan-towns-10004.topo.json
新竹縣 Hsinchu · 7 KB
Baixar TopoJSON
taiwan-towns-10005.topo.json
苗栗縣 Miaoli · 8 KB
Baixar TopoJSON
taiwan-towns-10007.topo.json
彰化縣 Changhua · 9 KB
Baixar TopoJSON
taiwan-towns-10008.topo.json
南投縣 Nantou · 10 KB
Baixar TopoJSON
taiwan-towns-10009.topo.json
雲林縣 Yunlin · 12 KB
Baixar TopoJSON
taiwan-towns-10010.topo.json
嘉義縣 Chiayi · 12 KB
Baixar TopoJSON
taiwan-towns-10013.topo.json
屏東縣 Pingtung · 14 KB
Baixar TopoJSON
taiwan-towns-10014.topo.json
臺東縣 Taitung · 11 KB
Baixar TopoJSON
taiwan-towns-10015.topo.json
花蓮縣 Hualien · 10 KB
Baixar TopoJSON
taiwan-towns-10016.topo.json
澎湖縣 Penghu · 4 KB
Baixar TopoJSON
taiwan-towns-10017.topo.json
基隆市 Keelung · 2 KB
Baixar TopoJSON
taiwan-towns-10018.topo.json
新竹市 Hsinchu City · 1 KB
Baixar TopoJSON
taiwan-towns-10020.topo.json
嘉義市 Chiayi City · 1 KB
Baixar TopoJSON
taiwan-towns-09007.topo.json
連江縣 Lienchiang (Matsu) · 2 KB
Baixar TopoJSON
taiwan-towns-09020.topo.json
金門縣 Kinmen · 3 KB
Baixar TopoJSON

以上已收錄全部 22 縣市。鄉鎮界資料出自 github.com/waiting7777/taiwan-vue-components,MIT License © 2018 Waiting。

🧭 Tabela de códigos das divisões administrativas

As divisões administrativas de Taiwan são codificadas com códigos numéricos. Veja abaixo a tabela das 22 divisões administrativas em nível de condado e cidade (padrão dos nomes de arquivo: `towns-{code}.json`).

Código Divisão administrativa Tipo
63000 臺北市 Taipei municipality
64000 高雄市 Kaohsiung municipality
65000 新北市 New Taipei municipality
66000 臺中市 Taichung municipality
67000 臺南市 Tainan municipality
68000 桃園市 Taoyuan municipality
10002 宜蘭縣 Yilan county
10004 新竹縣 Hsinchu county
10005 苗栗縣 Miaoli county
10007 彰化縣 Changhua county
10008 南投縣 Nantou county
10009 雲林縣 Yunlin county
10010 嘉義縣 Chiayi county
10013 屏東縣 Pingtung county
10014 臺東縣 Taitung county
10015 花蓮縣 Hualien county
10016 澎湖縣 Penghu county
10017 基隆市 Keelung city
10018 新竹市 Hsinchu City city
10020 嘉義市 Chiayi City city
09007 連江縣 Lienchiang (Matsu) offshore
09020 金門縣 Kinmen offshore

💻 Exemplos de uso

D3.js — choropleth interativo

// D3.js v7 + topojson-client
import * as d3 from 'd3';
import * as topojson from 'topojson-client';

const topo = await d3.json('https://taiwan.md/assets/geo/taiwan-country.topo.json');
const counties = topojson.feature(topo, topo.objects.map);

const projection = d3.geoMercator()
  .center([121, 24])
  .scale(8000)
  .translate([400, 300]);

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

d3.select('svg')
  .selectAll('path')
  .data(counties.features)
  .join('path')
    .attr('d', path)
    .attr('fill', d => colorScale(d.properties.value))
    .attr('stroke', '#333');

Python — geopandas

# Python — convert TopoJSON to GeoDataFrame
import json, geopandas as gpd
from topojson import Topology

with open('taiwan-country.topo.json') as f:
    topo = json.load(f)

# Convert to GeoJSON
topology = Topology(topo)
gdf = gpd.GeoDataFrame.from_features(
    topology.to_geojson()['features']
)
gdf.plot(column='name', legend=True)

Leaflet — sobreposição em mapa de mosaicos

// Leaflet + topojson
import L from 'leaflet';
import * as topojson from 'topojson-client';

const map = L.map('map').setView([24, 121], 7);
L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png').addTo(map);

fetch('https://taiwan.md/assets/geo/taiwan-country.topo.json')
  .then(r => r.json())
  .then(topo => {
    const geojson = topojson.feature(topo, topo.objects.map);
    L.geoJSON(geojson, {
      style: { color: '#4a90e2', weight: 1, fillOpacity: 0.3 }
    }).addTo(map);
  });

Vue — taiwan-vue-components

// Vue 2 — taiwan-vue-components (original source)
npm install taiwan-vue-components

// In your Vue component
import { Country, Taipei, Kaohsiung } from 'taiwan-vue-components';

<template>
  <div>
    <Country :width="400" :height="600" fill="#f0f0f0" stroke="#333" />
    <Taipei :width="300" :height="300" />
  </div>
</template>

📚 Outras fontes de dados abertos

Se você precisa de mais do que está incluído aqui — maior resolução, projeções diferentes ou limites administrativos históricos — estas são as fontes que recomendamos:

  • 政府資料開放平臺 (data.gov.tw) — 政府官方開放資料平台,包含內政部發布的行政區界 shapefile。
  • Natural Earth — 公有領域全球地圖資料,1:10m / 1:50m / 1:110m 三種比例尺。適合做含台灣的世界地圖。
  • OpenStreetMap (Taiwan relation) — OSM 社群編輯的台灣地圖,可透過 Overpass API 與 Geofabrik 下載 OSM XML 或 PBF。
  • GADM — Taiwan — 全球行政區資料庫,台灣行政區界 0-3 級,提供 Shapefile / GeoPackage / KMZ / R 格式。
  • g0v.tw — 台灣公民科技社群。許多 g0v 專案以開源形式發布整理過的地圖資料和視覺化。

⚖️ Licenças e fontes

Todos os arquivos desta página são de código aberto. Confira abaixo as informações completas sobre fontes e licenças:

  • taiwan-icon-wiki.svg · taiwan-location-map.svg · taiwan-political-division.svg — Wikimedia Commons,Creative Commons 授權。
  • taiwan-simplemaps.svg — SimpleMaps,標註來源後可免費商業使用。
  • taiwan-country.topo.json · taiwan-towns-*.topo.json — 出自 waiting7777/taiwan-vue-components, MIT License © 2018 Waiting.