Rust地理编码库flexpolyline的使用：高效处理Google Maps折线编码与解码

灵活折线编码(Flexible Polyline Encoding)

灵活折线编码是一种对坐标对或坐标三元组列表的有损压缩表示方法。它通过以下方式实现：

1. 减少每个值的小数位数
2. 仅编码与前一点的偏移量
3. 为每个坐标差值使用可变长度
4. 使用64个URL安全字符显示结果

这种编码是Encoded Polyline Algorithm Format的变体。相比原始编码，它具有以下优势：

• 输出字符串仅包含URL安全字符，可直接用作查询参数而无需URL编码
• 可配置浮点精度：允许表示精度高达微米（5位小数仅允许米级精度）
• 可编码具有给定精度的第三维度，可以是层级、海拔、高度或其他自定义值

示例代码

以下是使用flexpolyline库进行编码和解码的示例：

use flexpolyline::{Polyline, Precision};

// 编码
let coordinates = vec![
    (50.1022829, 8.6982122),
    (50.1020076, 8.6956695),
    (50.1006313, 8.6914960),
    (50.0987800, 8.6875156),
];

let polyline = Polyline::Data2d {
    coordinates,
    precision2d: Precision::Digits5,
};

let encoded = polyline.encode().unwrap();
assert_eq!(encoded, "BFoz5xJ67i1B1B7PzIhaxL7Y");

// 解码
let decoded = Polyline::decode("BFoz5xJ67i1B1B7PzIhaxL7Y").unwrap();
assert_eq!(
    decoded,
    Polyline::Data2d {
        coordinates: vec![
            (50.10228, 8.69821),
            (50.10201, 8.69567),
            (50.10063, 8.69150),
            (50.09878, 8.68752)
        ],
        precision2d: Precision::Digits5
    }
);

完整示例demo

下面是一个更完整的示例，展示如何使用flexpolyline库进行坐标编码和解码：

use flexpolyline::{Polyline, Precision};

fn main() {
    // 1. 准备坐标数据
    let coordinates = vec![
        (40.7128, -74.0060),  // 纽约
        (34.0522, -118.2437), // 洛杉矶
        (41.8781, -87.6298),  // 芝加哥
        (29.7604, -95.3698),  // 休斯顿
    ];

    // 2. 创建Polyline对象并设置精度
    let polyline = Polyline::Data2d {
        coordinates,
        precision2d: Precision::Digits5,
    };

    // 3. 编码为字符串
    match polyline.encode() {
        Ok(encoded) => {
            println!("编码后的折线字符串: {}", encoded);
            
            // 4. 解码字符串
            match Polyline::decode(&encoded) {
                Ok(decoded) => {
                    println!("解码后的坐标:");
                    if let Polyline::Data2d { coordinates, .. } = decoded {
                        for (i, (lat, lng)) in coordinates.iter().enumerate() {
                            println!("点 {}: 纬度={}, 经度={}", i+1, lat, lng);
                        }
                    }
                },
                Err(e) => println!("解码失败: {}", e),
            }
        },
        Err(e) => println!("编码失败: {}", e),
    }
}

安装说明

安装为库

运行以下Cargo命令：

cargo add flexpolyline

或在Cargo.toml中添加：

flexpolyline = "1.0.0"

安装为二进制

cargo install flexpolyline

技术规格

• 许可证：MIT
• 版本：1.0.0
• 大小：9.29 KiB
• 2021版

flexpolyline库由HERE地图团队开发，适用于需要高效处理地理坐标编码和解码的Rust应用程序。