GpsAndMap 0.3.0

提供了一个封装了GPS坐标值与坐标系数据的GSP类，提供了一个基于 folium 二次封装的地图类

GpsAndMap

介绍

整合了GPS坐标和坐标系数据的GPS坐标类，提供了不同坐标系之间的转换方法，提供了不同GPS坐点球面距离的计算方法。 二次封装了 folium 库，提供了常用 Map 及相关 folium对象及 plugins对象的方法/属性接口，提供了便利的图层管理接口。

模块结构

• GpsModule.py
  • 【GPS坐标系类型】枚举定义
  • 【GPS坐标系类】定义
  • 【常用坐标】对象
• MapModule.py
  • 【颜色名】枚举定义
  • 【热力点类】定义
  • 【图标样式类】定义
  • 【提示样式类】定义
  • 【消息样式类】定义
  • 【封闭图形样式类】定义
  • 【线条样式类】定义
  • 【线上文本样式类】定义
  • 【网页标题样式类】定义
  • 【图标标记类】定义
  • 【圆圈标记类】定义
  • 【正多边形标记类】定义
  • 【蚂蚁路径标记类】定义
  • 【矩形标记类】定义
  • 【多边形标记类】定义
  • 【折线类】定义
  • 【参考线类】定义
  • 【热力层类】定义
  • 【图层类】定义
  • 【地图类】定义

依赖说明

本模块依赖以下库:

• DebugInfo
• folium
• 其它标准库

安装教程

pip install GpsAndMap

使用说明

GpsAndMap.GpsModule 模块

👉GPS坐标系类型定义了常用的坐标系: gcj02, wgs84, bd09

👉GPS坐标类定义了一个类,该类封装了GPS坐标的经纬度值,以及坐标系信息,以及不同坐标系的转换方法

from GpsAndMap.GpsModule import *

# 下面实例化了一个GPS坐标类, 该坐标经纬度值以 gcj02坐标系下取得
上海坐标: GPS坐标类 = GPS坐标类(121.5681254, 31.98545896, GPS坐标系类型.gcj02)  # 此处经纬度值为杜撰值,非真实值

# 下面取得并使用gcj02坐标系下的坐标值
print(上海坐标.gcj02坐标)

# 下面取得并使用wgs84坐标系下的坐标值, 类内部会自动进行坐标系转换
print(上海坐标.wgs84坐标)

# 下面取得并使用bd09坐标系下的坐标值, 类内部会自动进行坐标系转换
print(上海坐标.bd09坐标)

# 下面传入坐标系参数,取得对应坐标系下的坐标值
目标坐标系: GPS坐标系类型 = GPS坐标系类型.wgs84
print(上海坐标.目标坐标(目标坐标系=目标坐标系))

👉常用坐标对象集成了350+个常用地市的GPS坐标信息(gcj09坐标系),为日常使用提供了便利

from GpsAndMap.GpsModule import *

# 打印上海市坐标
print(常用坐标.上海市)

# 打印西安市在wgs84下的坐标
print(常用坐标.西安市.wgs84坐标)

# 打印常州市在bd09下的坐标
print(常用坐标.常州市.bd09坐标)

# 打印指定坐标系下的合肥市坐标
目标坐标系: GPS坐标系类型 = GPS坐标系类型.gcj02
print(常用坐标.合肥市.目标坐标(目标坐标系=目标坐标系))

👉以下代码打印了常用坐标对象内的地市列表, 方便查看

from DebugInfo.DebugInfo import *
from GpsAndMap.GpsModule import *

画板 = 打印模板()

画板.添加多行(list(常用坐标.常用坐标字典.keys()), 拆分列数=8).展示表格()

打印截图一角如下:

GpsAndMap.MapModule 模块

👉MapModule模块主要基于GPS坐标类, 对folium模块进行了二次封装, 以使对folium对象的操作是基于GPS坐标类对象的.

👉MapModule模块支持folium.Map对象生成与对应的html文档生成,支持简单的图层管理

👉MapModule模块支持添打点(Marker)标记, 圆圈(Circle)标记, 多边形/正多边形(Polygon)标记,折线(PolyLine)标记,以及这些标记上附带的弹窗消息,提示消息,以及样式信息

👉MapModule模块支持添加热力图,支持添加经度参考线,支持添加纬度参考线

👉MapModule模块支持添加坐标拾取,鼠标打点,鼠标绘图,蚂蚁路径等folium.plugins功能

👉MapModule模块支持直接添加和使用12+种瓦片底图,包括google, 高德系列, 智图GeoQ系列

👇 以代码演示了如何向地图中添加指定的瓦片底图, 并将Map对象保存为html以供阅览

# -*- coding:UTF-8 -*-

# region 引入必要依赖
from src.GpsAndMap.MapModule import *

# endregion

地图 = 地图类(中心点=常用坐标.北京市).添加瓦片.高德地图().智图GeoQ().地图

地图.保存html(目标路径='.')

以上生成的html地图如下,可以看到有高德地图和智图GeoQ两个瓦片图层

---

参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

特技

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. Gitee 官方博客 blog.gitee.com
3. 你可以 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
4. GVP 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 https://gitee.com/help
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 https://gitee.com/gitee-stars/