polyline-iter 0.1.0

Zero-dependency iterator-based Google Encoded Polyline encoder and decoder
Documentation

About

Zero-dependency Rust crate for encoding and decoding Google's polyline format.

Compared to the georust/polyline crate, the polyline-iter decodes polyline into an iterator over points instead of vector, which is benefitial when only a single iteration over the polyline is needed. And in such cases it performs twice as fast as the georust/polyline crate and has no hidden allocations.

Usage

Add this to your Cargo.toml:

[dependencies]
polyline-iter = "0.1"

Example

use polyline_iter::PolylineIter;

let iter = PolylineIter::new(5, "angrIk~inAgwDybH_|D_{KeoEwtLozFo`Gre@tcA");
assert_eq!(
    iter.collect::<Vec<_>>(),
    vec![
        (55.58513, 12.99958),
        (55.61461, 13.04627),
        (55.64485, 13.11219),
        (55.67816, 13.18223),
        (55.71840, 13.22343),
        (55.71222, 13.21244),
    ]
);

// If the points are not needed, the iterator can be used directly
assert_eq!(PolylineIter::new(5, "angrIk~inAgwDybH_|D_{KeoEwtLozFo`Gre@tcA").count(), 6);

// Transcoding into a polyline with a different precision
let polyline6 = polyline_iter::encode(6, PolylineIter::new(5, "angrIk~inAgwDybH_|D_{KeoEwtLozFo`Gre@tcA"));

License

All code in this project is dual-licensed under either:

at your option.