# geo-coding

**Repository Path**: openeuler/geo-coding

## Basic Information

- **Project Name**: geo-coding
- **Description**: geo-coding is a Python client for geocoding related services, including common and popular encoding and conversion methods.
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-06-30
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: dev-utils

## README

==========
geo-coding
==========
geo-coding 是一个用于地理坐标相关服务的 Python 客户端，包括常见和流行的地理编码、坐标计算和坐标体系转换等功能。

服务场景
------------

* 服务于需要经纬度地理坐标定位、计算的业务和项目，例如各式各样的地理坐标大数据项目。
* 服务于类似地图项目的底层工具包，为很多需要计算经纬度确定方位的业务提供工具。

功能
------------
1. 地理编码器：使开发人员能够使用第三方地理编码程序和其他数据源轻松定位全球各地的地址、城市、国家和地标的坐标。
   支持百度、高德。

2. 坐标体系转换：例如百度，高德、大地坐标系和国测局等的标准进行经纬度坐标转换。

3. 距离：计算坐标之间的实际距离等实际功能。

4. 单位换算

5. 数据： 中国边界经纬度坐标、中国高校信息

优势
------------
现在具有地理功能的软件大多都很臃肿，而且适配中国地图的坐标软件并不多，该库是纯Python库轻量级的工具，想做到功能丰富一点，为实际业务提供底层快速的服务。

开发计划顺序
------------
* 2,5,3,4,1

版本支持
------------
* Python 3.x
* Linux: build/passing
* Windows: build/passing

使用示例
------------
* 0.0.1版开发完成，具体使用方式参考tests示例，后续再出详细文档。


开始贡献
------------
准备好贡献或使用了吗？ 这是为本地开发设置"地理编码"的方法。

1. 在 Gitee 上 Fork `geo-coding` 存储库。
2. 在本地clone你的仓库::

     $ git clone https://gitee.com/weihaitong/geo-coding.git

3. 这就是你如何使用这个工具::

     $ cd geo-coding/
     $ python setup.py install

4.如果你想为这个项目做贡献，你可以创建一个用于本地开发的分支::

     $ git checkout -b name-of-your-bugfix-or-feature

    现在您可以在本地进行更改。

5. 提交您的更改并将您的分支推送到 Gitee::

     $ git add .
     $ git commit -m "您对更改的详细描述"
     $ git push origin name-of-your-bugfix-or-feature

6. 通过 Gitee 网站提交拉取请求。


拉取请求指南
-----------------------

在提交拉取请求之前，请检查它是否符合以下准则：

1. 拉取请求应包括测试。
2. 如果拉取请求添加了功能，则应更新文档。 将您的新功能放入带有文档字符串的函数中，并将该功能添加到 README.rst 中的列表中。
3. 拉取请求应该适用于 Python 3.x。 并确保测试通过所有受支持的 Python 版本。