cnmaps 2.1.0

A Python package for querying, drawing, and clipping maps aligned to China's territorial claims

cnmaps 是一个以中国领土主张为标准开发的地图类 Python 扩展包

安装

安装 cnmaps 需要满足 Python 的解释器在 3.9 版本及以上。

使用pip安装

cnmaps 最简单也最快的安装方法是使用 pip 来安装 cnmaps： $ pip install -U cnmaps

从 2.0.0 开始，官方边界与样例数据已经拆分到独立包 cnmaps-data；安装 cnmaps 时会默认一并安装 cnmaps-data，无需再手动准备内置数据目录。

使用conda安装

你也可以使用 conda 安装： $ conda install -c conda-forge cnmaps

补充说明：conda-forge 当前只维护到 1.1.7 版本；2.x 及后续版本仅发布到 PyPI，conda 发行将停止后续维护。

快速开始

绘制国界

用最简单直接的方式，来绘制你的第一张中国地图。

import cartopy.crs as ccrs
import matplotlib.pyplot as plt
from cnmaps import get_adm_maps, draw_maps

fig = plt.figure(figsize=(10,10))
ax = fig.add_subplot(111, projection=ccrs.PlateCarree())

draw_maps(get_adm_maps(country='中国', level='国'))
plt.show()

绘制省界

cnmaps还可以绘制各省（特区/直辖市）的地图

import cartopy.crs as ccrs
import matplotlib.pyplot as plt
from cnmaps import get_adm_maps, draw_maps

fig = plt.figure(figsize=(10,10))
ax = fig.add_subplot(111, projection=ccrs.PlateCarree())

draw_maps(get_adm_maps(level='省'), linewidth=0.8, color='r') 

plt.show()

绘制市界

cnmaps可以绘制市级的行政区地图。

import cartopy.crs as ccrs
import matplotlib.pyplot as plt
from cnmaps import get_adm_maps, draw_maps

fig = plt.figure(figsize=(15,15))
ax = fig.add_subplot(111, projection=ccrs.PlateCarree())

draw_maps(get_adm_maps(level='市'), linewidth=0.5, color='g') 

plt.show()

绘制区县界

cnmaps可以绘制区县级的行政区地图。

import cartopy.crs as ccrs
import matplotlib.pyplot as plt
from cnmaps import get_adm_maps, draw_maps

fig = plt.figure(figsize=(20,20))
ax = fig.add_subplot(111, projection=ccrs.PlateCarree())

draw_maps(get_adm_maps(level='区县'), linewidth=0.8, color='r') 

plt.show()

使用指南

针对本项目更多的使用方法，我们还有一份更详细的文档：cnmaps使用指南