中国地图合规九段线工具包

解决地图发表中的合规痛点

在可视化项目中绘制中国地图时，最容易踩的雷往往不是配色或样式，而是版图合规问题。很多开发者在使用 ECharts、DataV 或 PPT 导出成品图后，才发现缺少南海诸岛附图，或者九段线坐标画错变成了乱码（□□□）。更严重的是出现“一张图里两幅中国地图”的附图错误。任何需要对外发表或交付的含中国版图的可视化，如果缺失合规九段线和标准南海附图，都不得直接交付。

基于官方数据的工作流

该技能的核心原则是禁止手绘近似坐标，所有九段线数据均源自自然资源部标准地图服务（通过 frykit 库加载）。

• 快速分级出图：调用 draw_china_choropleth，传入省份 adcode 字典，即可生成带合规九段线的省级分级图。
• 自定义图层叠加：如果你的数据是 .shp 或 .geojson 格式，使用 draw_china_with_layer 可以直接叠加流域、生态区等自定义专题图层，并支持 log1p 压缩处理右偏数据。
• 光栅图片后处理：对于已经导出的静态图片，insert_nanhai_inset 能自动采样主图配色，在右下角合成同色系的南海方形附图。
• 中文防乱码：通过 get_cjk_font 使用绝对路径字体（如 msyh.ttc），彻底摆脱沙箱环境下 matplotlib 字体缓存缺失导致的中文方块问题。

适用边界与合规底线

• 附图必须是右下角的方形南海区域，包含九段线，绝不能再画一整幅缩小的中国全图。
• 主图的 Y 轴下界需收敛至 14°N（如 ax.set_ylim(14, 55)），将南海部分完全交给附图表示。
• 正式发表前，仍需按 references/compliance.md 获取审图号或明确标注标准地图来源。