59 releases

✓ Uses Rust 2018 edition

0.12.2 May 26, 2019
0.12.0 Feb 17, 2019
0.11.0 Dec 3, 2018
0.10.3 Nov 23, 2018
0.0.4 Feb 7, 2015

#1 in #geo

Download history 2615/week @ 2019-07-30 3134/week @ 2019-08-06 2215/week @ 2019-08-13 2508/week @ 2019-08-20 2514/week @ 2019-08-27 2759/week @ 2019-09-03 2978/week @ 2019-09-10 3500/week @ 2019-09-17 3591/week @ 2019-09-24 3137/week @ 2019-10-01 3741/week @ 2019-10-08 3000/week @ 2019-10-15 3034/week @ 2019-10-22 2440/week @ 2019-10-29 1963/week @ 2019-11-05

9,279 downloads per month
Used in 45 crates (28 directly)

MIT/Apache

770KB
10K SLoC

geo

Build Status geo on Crates.io Coverage Status

geo

Geospatial Primitives, Algorithms, and Utilities

The geo crate provides geospatial primitive types such as Point, LineString, and Polygon, and provides algorithms and operations such as:

  • Area and centroid calculation
  • Simplification and convex hull operations
  • Euclidean and Haversine distance measurement
  • Intersection checks
  • Transformation to and from PostGIS types
  • Affine transforms such as rotation and translation.

Please refer to the documentation for a complete list.

The primitive types also provide the basis for other functionality in the Geo ecosystem, including:

Example

use geo::{line_string, polygon};
use geo::convexhull::ConvexHull;

// An L shape
let poly = polygon![
    (x: 0.0, y: 0.0),
    (x: 4.0, y: 0.0),
    (x: 4.0, y: 1.0),
    (x: 1.0, y: 1.0),
    (x: 1.0, y: 4.0),
    (x: 0.0, y: 4.0),
    (x: 0.0, y: 0.0),
];

// Ccalculate the polygon's convex hull
let hull = poly.convex_hull();

assert_eq!(hull.exterior(), line_string![
    (x: 0.0, y: 0.0),
    (x: 0.0, y: 4.0),
    (x: 1.0, y: 4.0),
    (x: 4.0, y: 1.0),
    (x: 4.0, y: 0.0),
    (x: 0.0, y: 0.0),
]);

Contributing

Contributions are welcome! Have a look at the issues, and open a pull request if you'd like to add an algorithm or some functionality.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.4–1.2MB
~25K SLoC