# WAFPRO map assets

Prepared on 2026-09-11. These are local vector datasets; rendering them requires no third-party runtime requests.

## Ready to use

| File | Content | Structure |
| --- | --- | --- |
| `world-countries.geojson` | 177 world country/area features; Natural Earth 1:110m | Standard GeoJSON `FeatureCollection`. `properties`: `name`, `nameZh`, `iso3`, `iso2`, `label: [longitude, latitude]`. `Polygon` / `MultiPolygon`. |
| `china-provinces.geojson` | 34 province-level areas, including Taiwan, Hainan, Hong Kong and Macau | GeoJSON `FeatureCollection`. `properties`: `name` (Chinese), `adcode`, `cp: [longitude, latitude]`. `Polygon` / `MultiPolygon`. |
| `china-south-sea-inset.json` | Apache ECharts' south sea islands schematic inset | `viewBox: [0, 0, 64, 93.1]`; `path` is an SVG `d`; `points` are original screen coordinates. Place in a separate inset; coordinates are not longitude/latitude. |
| `china-south-sea-inset.svg` | Standalone SVG version of same inset | `viewBox="-3 -3 70 100"`; change fill in your application. |

World source keeps Natural Earth's country/area identifiers and boundary definitions. Use `properties.iso3` as a geometry key; it does not need to become a user-facing country classification. Antarctica is included; applications may omit it from the display.

China is a visualization dataset from ECharts 4.9.0. The inset is the source project's schematic cartographic inset, not surveyed coordinates. The source includes 30 zero-area tiny island rings: these are preserved and padded with an existing endpoint, so no island geometry has been invented. One open ring was explicitly closed. The file works directly with planar SVG/Canvas polygon rendering.

## Source and license

### World: public domain

- Original GeoJSON: https://raw.githubusercontent.com/nvkelso/natural-earth-vector/master/geojson/ne_110m_admin_0_countries.geojson
- Project: https://github.com/nvkelso/natural-earth-vector
- Official terms: https://www.naturalearthdata.com/about/terms-of-use/
- Natural Earth explicitly permits commercial use and modification, without permission or required credit. Optional attribution: `Made with Natural Earth.`
- `world-110m.geojson` retains the full downloaded source. The prepared file trims attributes and rounds coordinates to four decimal places; geometry is otherwise unchanged.

### China and inset: Apache-2.0

- Pinned source: https://raw.githubusercontent.com/apache/echarts/4.9.0/map/json/china.json
- Decoder reference: https://raw.githubusercontent.com/apache/echarts/4.9.0/src/coord/geo/parseGeoJson.js
- Inset source: https://raw.githubusercontent.com/apache/echarts/4.9.0/src/coord/geo/fix/nanhai.js
- License: https://raw.githubusercontent.com/apache/echarts/4.9.0/LICENSE
- Notice: https://raw.githubusercontent.com/apache/echarts/4.9.0/NOTICE
- Apache-2.0 allows commercial use, modification and distribution subject to its terms. Retain `echarts-LICENSE.txt`, `echarts-NOTICE.txt`, source attribution and modification notices with distributed assets.
- The source map uses ECharts' UTF8-compressed coordinates. `prepare-maps.cjs` decodes them to ordinary numeric GeoJSON and extracts the unmodified inset point paths. Changes are recorded inside the output metadata.

## Reproduce and checks

Run `node prepare-maps.cjs` in this folder. No packages required.

Verified: both files parse, all coordinates are finite, all rings are closed and contain at least four entries, world has 177 features / 10,654 coordinates, China has 34 features / 16,204 coordinates. China's degenerate source rings are described above.

The original downloads and transformation script are included for provenance. Highcharts map collection was not used because its present collection license requires a Highcharts Maps license.