#PostgreSQL #GIS #GEO #PostGIS

postgis

An extension to rust-postgres, adds support for PostGIS

15 releases

✓ Uses Rust 2018 edition

new 0.7.0 Mar 25, 2020
0.6.0 Mar 17, 2018
0.5.0 Aug 21, 2017
0.4.0 Mar 4, 2017
0.1.6 Jun 13, 2015

#40 in Database interfaces

Download history 248/week @ 2019-12-02 567/week @ 2019-12-09 541/week @ 2019-12-16 98/week @ 2019-12-23 223/week @ 2019-12-30 314/week @ 2020-01-06 658/week @ 2020-01-13 633/week @ 2020-01-20 421/week @ 2020-01-27 146/week @ 2020-02-03 325/week @ 2020-02-10 249/week @ 2020-02-17 222/week @ 2020-02-24 247/week @ 2020-03-02 203/week @ 2020-03-09 247/week @ 2020-03-16

1,440 downloads per month
Used in 8 crates (6 directly)

MIT license

205KB
4.5K SLoC

rust-postgis

Build Status Crates.io

Documentation

An extension to rust-postgres, adds support for PostGIS.

  • PostGIS type helper
  • GCJ02 support (used offically in Mainland China)
  • Tiny WKB (TWKB) support

Usage

use postgres::{Connection, TlsMode};
use postgis::ewkb;
use postgis::LineString;

fn main() {
    // conn ....
    for row in &conn.query("SELECT * FROM busline", &[]).unwrap() {
        let route: ewkb::LineString = row.get("route");
        let last_stop = route.points().last().unwrap();
        let _ = conn.execute("INSERT INTO stops (stop) VALUES ($1)", &[&last_stop]);
    }
}

Handling NULL values:

let route = row.get_opt::<_, Option<ewkb::LineString>>("route");
match route.unwrap() {
    Ok(Some(geom)) => { println!("{:?}", geom) }
    Ok(None) => { /* Handle NULL value */ }
    Err(err) => { println!("Error: {}", err) }
}

Writing other geometry types into PostGIS

rust-postgis supports writing geometry types into PostGIS which implement the following traits:

  • Point, LineString, ...
  • AsEwkbPoint, AsEwkbLineString, ...

See the TWKB implementation as an example.

An example for reading a TWKB geometry and writing it back as EWKB:

use postgis::twkb;
use postgis::LineString;

for row in &conn.query("SELECT ST_AsTWKB(route) FROM busline", &[]).unwrap() {
    let route: twkb::LineString = row.get(0);
    let last_stop = route.points().last().unwrap();
    let _ = conn.execute("INSERT INTO stops (stop) VALUES ($1)", &[&last_stop.as_ewkb()]);
}

Unit tests

Unit tests which need a PostgreSQL connection are ignored by default. To run the database tests, declare the connection in an environment variable DBCONN. Example:

export DBCONN=postgresql://user@localhost/testdb

Run the tests with

cargo test -- --ignored

Dependencies

~6MB
~133K SLoC