高德地图 (AMap)

Feature: amap | 依赖: reqwest, serde_json

📖 官方文档：https://lbs.amap.com/api/webservice/summary

简介

高德地图 Web 服务 API 封装，支持地理编码、逆地理编码、路径规划、POI 搜索、距离测量和天气查询。

配置

[amap]
key = "your_amap_key"  # 高德 Web 服务 API Key (console.amap.com)

API

所有方法返回 Result<AmapResponse, afast::Error>。

#![allow(unused)]
fn main() {
// 配置自动从 config.toml 的 [amap] 段加载
let app = AFaster::new("config.toml".to_string()).await.unwrap();
let amap = &app.state.amap;  // 在 handler 中通过 state.amap 访问
}

AmapResponse

#![allow(unused)]
fn main() {
pub struct AmapResponse {
    pub status: String,    // "1"=成功, "0"=失败
    pub info: String,      // "OK" 或错误描述
    pub infocode: String,  // "10000"=成功
    pub data: Value,       // 业务数据 (geocodes/regeocode/route/pois/lives/forecasts...)
}
}

• response.is_ok() — 快速判断是否成功

地理编码

#![allow(unused)]
fn main() {
// 地理编码: 地址 → 坐标
let res = amap.geocode("北京市朝阳区阜通东大街6号", Some("北京")).await?;

// 逆地理编码: 坐标 → 地址
let res = amap.regeocode("116.397428,39.90923", Some("base"), Some(1000)).await?;
}

路径规划

#![allow(unused)]
fn main() {
// 步行
let res = amap.direction_walking("116.397428,39.90923", "116.407428,39.91923").await?;

// 驾车
let res = amap.direction_driving("116.397428,39.90923", "116.407428,39.91923", None, None).await?;

// 公交
let res = amap.direction_transit("116.397428,39.90923", "116.407428,39.91923", "北京", None, None).await?;

// 骑行 (v4 API)
let res = amap.direction_bicycling("116.397428,39.90923", "116.407428,39.91923").await?;

// 距离测量
let res = amap.distance("116.397428,39.90923", "116.407428,39.91923", None).await?;
}

POI 搜索

#![allow(unused)]
fn main() {
// 关键字搜索
let res = amap.poi_text("北京大学", Some("北京"), None, None, None, None).await?;

// 周边搜索
let res = amap.poi_around("116.397428,39.90923", Some("餐厅"), None, Some(1000), None, None, None, None).await?;

// 多边形搜索
let res = amap.poi_polygon("116.460988,40.006819|116.480988,40.006819|116.470988,39.996819", Some("肯德基"), None, None, None, None).await?;

// 详情搜索
let res = amap.poi_detail("B000A7BD6C").await?;
}

天气查询

#![allow(unused)]
fn main() {
// 实时天气
let res = amap.weather("110000", None).await?;

// 预报天气
let res = amap.weather("110000", Some("all")).await?;
}

错误码

注意事项

• 坐标格式: 高德地图使用 经度,纬度 顺序（与高德的经度,纬度相反！）
• 骑行路径使用 v4 API (/v4/direction/bicycling)，其余路径使用 v3
• 城市编码参考: 高德城市编码表
• 错误码详情: response.info + response.infocode

功能对比 (AMap vs TMap)