coordtransform 0.3.0

Provide mutual conversions between Baidu Coordinate System (BD09), Mars Coordinate System (GCJ02), and WGS84 Coordinate System.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

# coordtransform-rs

[![Crates.io](https://img.shields.io/crates/v/coordtransform.svg)](https://crates.io/crates/coordtransform)
[![Documentation](https://docs.rs/coordtransform/badge.svg)](https://docs.rs/coordtransform)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

提供百度坐标系(BD09)、火星坐标系(国测局坐标系、GCJ02)、WGS84坐标系的相互转换，基于 Rust 语言，无特殊依赖。
Provides mutual conversion between Baidu Coordinate System (BD09), Mars Coordinate System (GCJ02), and WGS84 Coordinate System, implemented in Rust with no special dependencies.

这是 [Go版本](https://github.com/qichengzx/coordtransform) 的 Rust 移植版本。
This is the Rust port of the [Go version](https://github.com/qichengzx/coordtransform).

## 坐标系说明 Coordinate System Description

- **WGS84坐标系**：即地球坐标系，国际上通用的坐标系
- **WGS84 Coordinate System**: The Earth coordinate system, commonly used internationally.
- **GCJ02坐标系**：即火星坐标系，WGS84坐标系经加密后的坐标系。Google Maps，高德在用
- **GCJ02 Coordinate System**: Also known as the Mars coordinate system, an encrypted version of the WGS84 coordinate system. Used by Google Maps and Amap.
- **BD09坐标系**：即百度坐标系，GCJ02坐标系经加密后的坐标系
- **BD09 Coordinate System**: Also known as the Baidu coordinate system, an encrypted version of the GCJ02 coordinate system.
- **EPSG:3857坐标系**：即Web墨卡托投影坐标系，广泛用于Web地图服务如Google Maps、OpenStreetMap等
- **EPSG:3857 Coordinate System**: Also known as Web Mercator projection, widely used in web mapping services like Google Maps and OpenStreetMap.

## 功能特性 Features

- [x] 火星坐标系 -> 百度坐标系 (`gcj02_to_bd09`)
- [x] 百度坐标系 -> 火星坐标系 (`bd09_to_gcj02`)
- [x] WGS84坐标系 -> 火星坐标系 (`wgs84_to_gcj02`)
- [x] 火星坐标系 -> WGS84坐标系 (`gcj02_to_wgs84`)
- [x] WGS84坐标系 -> 百度坐标系 (`wgs84_to_bd09`)
- [x] 百度坐标系 -> WGS84坐标系 (`bd09_to_wgs84`)
- [x] WGS84坐标系 -> EPSG:3857坐标系 (`wgs84_to_epsg3857`)
- [x] EPSG:3857坐标系 -> WGS84坐标系 (`epsg3857_to_wgs84`)
- [x] GCJ02坐标系 -> EPSG:3857坐标系 (`gcj02_to_epsg3857`)
- [x] EPSG:3857坐标系 -> GCJ02坐标系 (`epsg3857_to_gcj02`)
- [x] BD09坐标系 -> EPSG:3857坐标系 (`bd09_to_epsg3857`)
- [x] EPSG:3857坐标系 -> BD09坐标系 (`epsg3857_to_bd09`)

## 安装 Installation

在你的 `Cargo.toml` 中添加 Add the following to your `Cargo.toml`：

```toml
[dependencies]
coordtransform = "0.3.0"
```

## 快速开始 Quick Start

```rust
use coordtransform::*;

fn main() {
    // 百度坐标系 -> 火星坐标系
    let (lon, lat) = bd09_to_gcj02(116.404, 39.915);
    println!("BD09 to GCJ02: ({}, {})", lon, lat);

    // 火星坐标系 -> 百度坐标系
    let (lon, lat) = gcj02_to_bd09(116.404, 39.915);
    println!("GCJ02 to BD09: ({}, {})", lon, lat);

    // WGS84坐标系 -> 火星坐标系
    let (lon, lat) = wgs84_to_gcj02(116.404, 39.915);
    println!("WGS84 to GCJ02: ({}, {})", lon, lat);

    // 火星坐标系 -> WGS84坐标系 gcj02 -> WGS84
    let (lon, lat) = gcj02_to_wgs84(116.404, 39.915);
    println!("GCJ02 to WGS84: ({}, {})", lon, lat);

    // 百度坐标系 -> WGS84坐标系
    let (lon, lat) = bd09_to_wgs84(116.404, 39.915);
    println!("BD09 to WGS84: ({}, {})", lon, lat);

    // WGS84坐标系 -> 百度坐标系
    let (lon, lat) = wgs84_to_bd09(116.404, 39.915);
    println!("WGS84 to BD09: ({}, {})", lon, lat);

    // WGS84坐标系 -> EPSG:3857坐标系 (Web墨卡托投影)
    let (x, y) = wgs84_to_epsg3857(116.404, 39.915);
    println!("WGS84 to EPSG:3857: ({}, {})", x, y);

    // EPSG:3857坐标系 -> WGS84坐标系
    let (lon, lat) = epsg3857_to_wgs84(12958752.0, 4825923.0);
    println!("EPSG:3857 to WGS84: ({}, {})", lon, lat);

    // GCJ02坐标系 -> EPSG:3857坐标系
    let (x, y) = gcj02_to_epsg3857(116.404, 39.915);
    println!("GCJ02 to EPSG:3857: ({}, {})", x, y);

    // BD09坐标系 -> EPSG:3857坐标系
    let (x, y) = bd09_to_epsg3857(116.404, 39.915);
    println!("BD09 to EPSG:3857: ({}, {})", x, y);
}
```

## 基准测试 Benchmarking

运行基准测试 Run the benchmark tests：

```bash
cargo bench
```

## 测试 Testing

运行测试 Run the tests：

```bash
cargo test
```

## 许可证 License

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 相关项目 Related Projects

- [Go版本](https://github.com/qichengzx/coordtransform)
- [Python版本](https://github.com/wandergis/coordTransform_py)
- [JavaScript版本](https://github.com/wandergis/coordtransform)
- [命令行版本Command Line](https://github.com/wandergis/coordtransform-cli)