Coordtransform

https://docs.rs/coordtransform/0.3.0/coordtransform/
Admin
Coordtransform is a Rust library that provides mutual conversion between multiple coordinate systems...
Tokens:5,713
Snippets:46
Trust Score:9.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Coordinate System Conversion Examples in Rust

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/index.html

Demonstrates various coordinate system transformations using the coordtransform crate. Ensure the crate is added as a dependency to your project.

```rust
use coordtransform::*

// bd09百度坐标系 -> gcj02火星坐标系
let (lon, lat) = bd09_to_gcj02(116.404, 39.915);

// bd09火星坐标系 -> gcj02百度坐标系
let (lon, lat) = gcj02_to_bd09(116.404, 39.915);

// WGS84坐标系 -> gcj02火星坐标系
let (lon, lat) = wgs84_to_gcj02(116.404, 39.915);

// gcj02火星坐标系 -> WGS84坐标系
let (lon, lat) = gcj02_to_wgs84(116.404, 39.915);

// bd09百度坐标系 -> WGS84坐标系
let (lon, lat) = bd09_to_wgs84(116.404, 39.915);

// WGS84坐标系 -> bd09百度坐标系
let (lon, lat) = wgs84_to_bd09(116.404, 39.915);

// WGS84坐标系 -> EPSG:3857坐标系
let (x, y) = wgs84_to_epsg3857(116.404, 39.915);

// EPSG:3857坐标系 -> WGS84坐标系
let (lon, lat) = epsg3857_to_wgs84(12958752.0, 4825923.0);
```

--------------------------------

### Coordinate System Conversions

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/index.html

This section details the various functions available for converting between different coordinate systems.

```APIDOC
## Functions

### bd09_to_epsg3857

Converts from BD09 Coordinate System to EPSG:3857 Coordinate System.

### bd09_to_gcj02

Converts from Baidu Coordinate System (BD09) to Mars Coordinate System (GCJ02).

### bd09_to_wgs84

Converts from Baidu Coordinate System (BD09) to WGS84 Coordinate System.

### epsg3857_to_bd09

Converts from EPSG:3857 Coordinate System to BD09 Coordinate System.

### epsg3857_to_gcj02

Converts from EPSG:3857 Coordinate System to GCJ02 Coordinate System.

### epsg3857_to_wgs84

Converts from EPSG:3857 Coordinate System (Web Mercator Projection) to WGS84 Coordinate System.

### gcj02_to_bd09

Converts from GCJ02 Mars Coordinate System to BD09 Baidu Coordinate System.

### gcj02_to_epsg3857

Converts from GCJ02 Coordinate System to EPSG:3857 Coordinate System.

### gcj02_to_wgs84

Converts from GCJ02 Mars Coordinate System to WGS84 Coordinate System.

### wgs84_to_bd09

Converts from WGS84 Coordinate System to Baidu Coordinate System (BD09).

### wgs84_to_epsg3857

Converts from WGS84 Coordinate System to EPSG:3857 Coordinate System (Web Mercator Projection).

### wgs84_to_gcj02

Converts from WGS84 Coordinate System to Mars Coordinate System (GCJ02).

```

--------------------------------

### Convert GCJ02 to EPSG:3857

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_epsg3857.html

Use this function to convert longitude and latitude from the GCJ02 coordinate system to the EPSG:3857 coordinate system. The input is in degrees, and the output is in meters.

```rust
use coordtransform::gcj02_to_epsg3857;

let (x, y) = gcj02_to_epsg3857(116.404, 39.915);
```

--------------------------------

### Convert EPSG:3857 to GCJ02 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_gcj02.html

Use this function to convert coordinates from the EPSG:3857 system (meters) to the GCJ02 system (degrees). The function takes X and Y coordinates in meters and returns a tuple of longitude and latitude in degrees.

```rust
use coordtransform::epsg3857_to_gcj02;

let (lon, lat) = epsg3857_to_gcj02(12958752.0, 4825923.0);
```

--------------------------------

### Convert GCJ02 to BD09 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_bd09.html

Use this function to convert longitude and latitude from the GCJ02 Martian coordinate system to the BD09 Baidu coordinate system. Ensure the `coordtransform` crate is imported.

```rust
use coordtransform::gcj02_to_bd09;

let (lon, lat) = gcj02_to_bd09(116.404, 39.915);
```

--------------------------------

### Convert BD09 to EPSG:3857 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_epsg3857.html

Use this function to convert longitude and latitude from the BD09 coordinate system to the EPSG:3857 coordinate system. The input is in degrees, and the output is in meters.

```rust
use coordtransform::bd09_to_epsg3857;

let (x, y) = bd09_to_epsg3857(116.404, 39.915);
```

--------------------------------

### Convert EPSG:3857 to BD09 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_bd09.html

Use this function to convert coordinates from the EPSG:3857 system (in meters) to the BD09 system (in degrees). The function takes X and Y coordinates in meters and returns a tuple of longitude and latitude in degrees.

```rust
use coordtransform::epsg3857_to_bd09;

let (lon, lat) = epsg3857_to_bd09(12958752.0, 4825923.0);
```

--------------------------------

### Convert WGS84 to EPSG:3857

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_epsg3857.html

Use this function to convert longitude and latitude from the WGS84 coordinate system to the EPSG:3857 (Web Mercator) coordinate system. The input is in degrees, and the output is in meters.

```rust
use coordtransform::wgs84_to_epsg3857;

let (x, y) = wgs84_to_epsg3857(116.404, 39.915);
```

--------------------------------

### Convert BD09 to GCJ02 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_gcj02.html

Use this function to convert longitude and latitude from the Baidu Coordinate System (BD09) to the Mars Coordinate System (GCJ02). Ensure the `coordtransform` crate is imported.

```rust
use coordtransform::bd09_to_gcj02;

let (lon, lat) = bd09_to_gcj02(116.404, 39.915);
```

--------------------------------

### Convert WGS84 to GCJ02 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_gcj02.html

Use this function to convert longitude and latitude from the WGS84 coordinate system to the GCJ02 (Mars) coordinate system. Ensure the `coordtransform` crate is imported.

```rust
use coordtransform::wgs84_to_gcj02;

let (lon, lat) = wgs84_to_gcj02(116.404, 39.915);
```

--------------------------------

### Convert WGS84 to Baidu Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_bd09.html

Use this function to convert longitude and latitude from the WGS84 coordinate system to the Baidu coordinate system. It takes WGS84 longitude and latitude as input and returns the converted longitude and latitude as a tuple.

```rust
use coordtransform::wgs84_to_bd09;

let (lon, lat) = wgs84_to_bd09(116.404, 39.915);
```

--------------------------------

### Convert Baidu Coordinates to WGS84

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_wgs84.html

Use this function to convert longitude and latitude from Baidu coordinates to WGS84 coordinates. Ensure the `coordtransform` crate is imported.

```rust
use coordtransform::bd09_to_wgs84;

let (lon, lat) = bd09_to_wgs84(116.404, 39.915);
```

--------------------------------

### Convert EPSG:3857 to WGS84 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_wgs84.html

Use this function to convert coordinates from the EPSG:3857 (Web Mercator) projection to the WGS84 geographic coordinate system. The input coordinates are in meters, and the output is a tuple of longitude and latitude in degrees.

```rust
use coordtransform::epsg3857_to_wgs84;

let (lon, lat) = epsg3857_to_wgs84(12958752.0, 4825923.0);
```

--------------------------------

### Coordinate Transformation Functions

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/all.html

This section details the various functions available for transforming coordinates between different systems such as BD09, EPSG3857, GCJ02, and WGS84.

```APIDOC
## Coordinate Transformation Functions

### Description
Provides functions to convert coordinates between different geodetic systems.

### Functions

- **bd09_to_epsg3857**
  Converts coordinates from BD09 to EPSG3857.

- **bd09_to_gcj02**
  Converts coordinates from BD09 to GCJ02.

- **bd09_to_wgs84**
  Converts coordinates from BD09 to WGS84.

- **epsg3857_to_bd09**
  Converts coordinates from EPSG3857 to BD09.

- **epsg3857_to_gcj02**
  Converts coordinates from EPSG3857 to GCJ02.

- **epsg3857_to_wgs84**
  Converts coordinates from EPSG3857 to WGS84.

- **gcj02_to_bd09**
  Converts coordinates from GCJ02 to BD09.

- **gcj02_to_epsg3857**
  Converts coordinates from GCJ02 to EPSG3857.

- **gcj02_to_wgs84**
  Converts coordinates from GCJ02 to WGS84.

- **wgs84_to_bd09**
  Converts coordinates from WGS84 to BD09.

- **wgs84_to_epsg3857**
  Converts coordinates from WGS84 to EPSG3857.

- **wgs84_to_gcj02**
  Converts coordinates from WGS84 to GCJ02.

```

--------------------------------

### epsg3857_to_gcj02

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_gcj02.html

Converts coordinates from the EPSG:3857 coordinate system to the GCJ02 coordinate system. The input coordinates are in meters, and the output is a tuple of longitude and latitude in degrees.

```APIDOC
## Function epsg3857_to_gcj02

### Summary
```
pub fn epsg3857_to_gcj02(x: f64, y: f64) -> (f64, f64)
```

### Description
EPSG:3857 Coordinate System -> GCJ02 Coordinate System

### Parameters
* `x` - X coordinate (meters)
* `y` - Y coordinate (meters)

### Return Value
Returns a tuple of (longitude, latitude) in degrees after conversion.

### Example
```rust
use coordtransform::epsg3857_to_gcj02;

let (lon, lat) = epsg3857_to_gcj02(12958752.0, 4825923.0);
```
```

--------------------------------

### epsg3857_to_wgs84 Function

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_wgs84.html

Converts coordinates from the EPSG:3857 (Web Mercator) coordinate system to the WGS84 coordinate system. The input coordinates are in meters, and the output is a tuple of longitude and latitude in degrees.

```APIDOC
## Function epsg3857_to_wgs84

### Summary
```
pub fn epsg3857_to_wgs84(x: f64, y: f64) -> (f64, f64)
```

### Description
EPSG:3857 Coordinate System -> WGS84 Coordinate System (Web Mercator Projection)

### Parameters
#### Path Parameters
- **x** (f64) - Required - X coordinate (meters)
- **y** (f64) - Required - Y coordinate (meters)

### Return Value
Returns a tuple of (longitude, latitude) in degrees after conversion.

### Example
```rust
use coordtransform::epsg3857_to_wgs84;

let (lon, lat) = epsg3857_to_wgs84(12958752.0, 4825923.0);
```
```

--------------------------------

### bd09_to_wgs84 Function

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_wgs84.html

Converts coordinates from the Baidu Coordinate System (BD09) to the WGS84 coordinate system. Accepts longitude and latitude as f64 and returns a tuple of f64 representing the converted longitude and latitude.

```APIDOC
## Function bd09_to_wgs84

### Description
Converts coordinates from the Baidu Coordinate System (BD09) to the WGS84 coordinate system.

### Signature
```rust
pub fn bd09_to_wgs84(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
#### Path Parameters
- **lon** (f64) - Required - The longitude in the Baidu Coordinate System.
- **lat** (f64) - Required - The latitude in the Baidu Coordinate System.

### Return Value
Returns a tuple of (longitude, latitude) in the WGS84 coordinate system.

### Example
```rust
use coordtransform::bd09_to_wgs84;

let (lon, lat) = bd09_to_wgs84(116.404, 39.915);
println!("Converted Lon: {}, Lat: {}", lon, lat);
```
```

--------------------------------

### epsg3857_to_bd09

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.epsg3857_to_bd09.html

Converts coordinates from the EPSG:3857 coordinate system to the BD09 coordinate system. The input coordinates are in meters, and the output is a tuple of longitude and latitude in degrees.

```APIDOC
## Function epsg3857_to_bd09

### Summary
```
pub fn epsg3857_to_bd09(x: f64, y: f64) -> (f64, f64)
```

### Description
EPSG:3857 Coordinate System -> BD09 Coordinate System.

### Parameters
* `x` - X coordinate (meters)
* `y` - Y coordinate (meters)

### Return Value
Returns a tuple of (longitude, latitude) in degrees after conversion.

### Example
```rust
use coordtransform::epsg3857_to_bd09;

let (lon, lat) = epsg3857_to_bd09(12958752.0, 4825923.0);
```
```

--------------------------------

### Convert GCJ02 to WGS84 Coordinates

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_wgs84.html

Use this function to convert longitude and latitude from GCJ02 (Mars coordinates) to WGS84 coordinates. Ensure the coordtransform crate is imported.

```rust
use coordtransform::gcj02_to_wgs84;

let (lon, lat) = gcj02_to_wgs84(116.404, 39.915);
```

--------------------------------

### gcj02_to_bd09 Function

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_bd09.html

Converts longitude and latitude from the GCJ02 (Martian) coordinate system to the BD09 (Baidu) coordinate system.

```APIDOC
## gcj02_to_bd09

### Description
Converts GCJ02 Martian coordinates to BD09 Baidu coordinates.

### Function Signature
```rust
pub fn gcj02_to_bd09(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
* `lon` (f64) - Required - Longitude in GCJ02 format.
* `lat` (f64) - Required - Latitude in GCJ02 format.

### Return Value
A tuple containing the converted longitude and latitude in BD09 format: `(f64, f64)`.

### Example
```rust
use coordtransform::gcj02_to_bd09;

let (lon, lat) = gcj02_to_bd09(116.404, 39.915);
// lon and lat will contain the BD09 coordinates
```
```

--------------------------------

### bd09_to_gcj02

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_gcj02.html

Converts longitude and latitude from the Baidu Coordinate System (BD09) to the Mars Coordinate System (GCJ02).

```APIDOC
## bd09_to_gcj02

### Description
Converts coordinates from the Baidu Coordinate System to the Mars Coordinate System.

### Function Signature
```rust
pub fn bd09_to_gcj02(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
#### Parameters
- **lon** (f64) - Required - 经度 Longitude
- **lat** (f64) - Required - 纬度 Latitude

### Return Value
Returns a tuple of (longitude, latitude) after conversion.

### Example
```rust
use coordtransform::bd09_to_gcj02;

let (lon, lat) = bd09_to_gcj02(116.404, 39.915);
```
```

--------------------------------

### wgs84_to_bd09 Function

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_bd09.html

Converts WGS84 coordinates (longitude, latitude) to Baidu coordinates (longitude, latitude).

```APIDOC
## wgs84_to_bd09

### Description
Converts WGS84 coordinates to Baidu coordinates.

### Signature
```rust
pub fn wgs84_to_bd09(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
#### Path Parameters
- **lon** (f64) - Required - Longitude in WGS84 format.
- **lat** (f64) - Required - Latitude in WGS84 format.

### Return Value
Returns a tuple containing the converted longitude and latitude in Baidu coordinate system format.

### Example
```rust
use coordtransform::wgs84_to_bd09;

let (lon, lat) = wgs84_to_bd09(116.404, 39.915);
// lon and lat now hold the Baidu coordinates.
```
```

--------------------------------

### gcj02_to_wgs84

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_wgs84.html

Converts longitude and latitude from the GCJ-02 coordinate system (Martian coordinates) to the WGS-84 coordinate system.

```APIDOC
## gcj02_to_wgs84

### Description
Converts longitude and latitude from the GCJ-02 coordinate system (Martian coordinates) to the WGS-84 coordinate system.

### Function Signature
```rust
pub fn gcj02_to_wgs84(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
#### Parameters
- **lon** (f64) - Required - Longitude in GCJ-02 format.
- **lat** (f64) - Required - Latitude in GCJ-02 format.

### Return Value
Returns a tuple containing the converted longitude and latitude in WGS-84 format: `(f64, f64)`.

### Example
```rust
use coordtransform::gcj02_to_wgs84;

let (lon, lat) = gcj02_to_wgs84(116.404, 39.915);
// lon and lat will contain the WGS-84 coordinates
```

--------------------------------

### wgs84_to_gcj02

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_gcj02.html

Converts WGS84 coordinates to GCJ02 (Mars) coordinates. This is useful for applications that need to display location data within China, where GCJ02 is the standard.

```APIDOC
## Function wgs84_to_gcj02

### Summary
```
pub fn wgs84_to_gcj02(lon: f64, lat: f64) -> (f64, f64)
```

### Description
WGS84坐标系 -> 火星坐标系 WGS84 Coordinate System -> Mars Coordinate System

### Parameters
* `lon` - 经度 Longitude
* `lat` - 纬度 Latitude

### Return Value
返回转换后的 (经度, 纬度) 元组 Returns a tuple of (longitude, latitude) after conversion

### Example
```rust
use coordtransform::wgs84_to_gcj02;

let (lon, lat) = wgs84_to_gcj02(116.404, 39.915);
```
```

--------------------------------

### bd09_to_epsg3857

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.bd09_to_epsg3857.html

Converts coordinates from BD09 to EPSG:3857. Accepts longitude and latitude in degrees and returns a tuple of (X, Y) in meters.

```APIDOC
## bd09_to_epsg3857

### Description
Converts coordinates from BD09 to EPSG:3857.

### Parameters
#### Path Parameters
- `lon` (f64) - Required - Longitude in degrees.
- `lat` (f64) - Required - Latitude in degrees.

### Return Value
Returns a tuple of (X, Y) in meters after conversion.

### Example
```rust
use coordtransform::bd09_to_epsg3857;

let (x, y) = bd09_to_epsg3857(116.404, 39.915);
```
```

--------------------------------

### wgs84_to_epsg3857

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.wgs84_to_epsg3857.html

Converts WGS84 coordinates (longitude, latitude) to EPSG:3857 (Web Mercator Projection) coordinates (X, Y).

```APIDOC
## Function wgs84_to_epsg3857

### Summary
```
pub fn wgs84_to_epsg3857(lon: f64, lat: f64) -> (f64, f64)
```

### Description
WGS84坐标系 -> EPSG:3857坐标系 (Web墨卡托投影) WGS84 Coordinate System -> EPSG:3857 Coordinate System (Web Mercator Projection)

### Parameters

* `lon` - 经度 Longitude (度 degrees)
* `lat` - 纬度 Latitude (度 degrees)

### Return Value

返回转换后的 (X, Y) 元组 (米) Returns a tuple of (X, Y) in meters after conversion

### Example

```rust
use coordtransform::wgs84_to_epsg3857;

let (x, y) = wgs84_to_epsg3857(116.404, 39.915);
```
```

--------------------------------

### gcj02_to_epsg3857

Source: https://docs.rs/coordtransform/0.3.0/coordtransform/fn.gcj02_to_epsg3857.html

Converts GCJ02 coordinates (longitude, latitude) to EPSG:3857 coordinates (X, Y).

```APIDOC
## gcj02_to_epsg3857

### Description
Converts GCJ02 coordinates to EPSG:3857 coordinates.

### Function Signature
```rust
pub fn gcj02_to_epsg3857(lon: f64, lat: f64) -> (f64, f64)
```

### Parameters
* `lon` (f64) - Required - Longitude in degrees.
* `lat` (f64) - Required - Latitude in degrees.

### Return Value
A tuple `(f64, f64)` representing the (X, Y) coordinates in meters in the EPSG:3857 coordinate system.

### Example
```rust
use coordtransform::gcj02_to_epsg3857;

let (x, y) = gcj02_to_epsg3857(116.404, 39.915);
```
```
Tokens:
Raw