didi 滴滴地图 Android SDK 开发指南
滴图出行技术开放平台 Android SDK 统一开发指南。整合 地图（Map）、定位（Location）、WebService、导航（Navigation） 四大模块的 API 说明和代码示例，帮助开发者快速集成滴滴地图 Android SDK 并遵循正确的使用方式。
模块总览
| 模块 | 目录 | 用途 |
|---|---|---|
| 地图 Map | references/map/ |
地图视图、生命周期、标记、覆盖物、相机控制、事件、UI 设置 |
| 定位 Location | references/location/ |
定位客户端、单次/连续/导航定位、定位结果与监听 |
| WebService | references/webservice/ |
POI 搜索、地理编码、路线规划等在线服务接口 |
| 导航 Navigation | references/navigation/ |
组件导航（快速接入）与自定义导航（DMapNavi 深度定制） |
何时适用
在以下场景中参考这些指南：
地图模块
- 创建新的地图页面或 Activity、在布局中添加 MapView 组件
- 在地图上添加标记、折线、多边形、圆形、热力图等覆盖物
- 处理地图交互事件（点击、长按、相机变化、手势等）
- 控制地图相机位置、缩放、旋转、倾斜
- 配置地图 UI 控件和手势交互、调试地图渲染或性能问题
定位模块
- 在应用中集成滴滴定位服务、管理定位生命周期
- 实现单次定位、连续定位或导航模式定位
- 处理定位结果和定位错误
WebService 模块
- POI 关键词搜索、周边搜索、输入提示（自动补全）
- 逆地理编码（坐标转地址）、地理编码（地址转坐标）
- 规划驾车 / 步行 / 骑行 / 公交路线
导航模块
- 使用组件导航
DMapRouteActivity一行代码快速接入导航界面 - 使用
DMapNaviAPI 自定义导航 UI、处理诱导信息、路口放大图、车道线、TTS 播报等
快速参考
一、地图 Map（references/map/）
0. 初始化与配置
references/map/map-setup.md- 接入配置：环境要求、AAR 导入、权限声明、依赖项、隐私合规、鉴权初始化、混淆规则references/map/map-view.md- MapView：地图视图、生命周期、初始化references/map/map-options.md- MapOptions：地图初始配置references/map/di-map.md- DiMap：地图核心类、API 入口
1. 坐标与位置
references/map/lat-lng.md- LatLng：经纬度类references/map/lat-lng-bounds.md- LatLngBounds：经纬度边界references/map/camera-position.md- CameraPosition：相机位置（中心点、缩放、倾斜、旋转）
2. 相机控制
references/map/camera-update.md- CameraUpdate：相机更新对象references/map/camera-update-factory.md- CameraUpdateFactory：相机更新工厂类
3. 标记与覆盖物
references/map/marker.md- Marker：标记覆盖物references/map/marker-options.md- MarkerOptions：标记配置references/map/polyline.md- Polyline：折线覆盖物references/map/polyline-options.md- PolylineOptions：折线配置references/map/polygon.md- Polygon：多边形覆盖物references/map/polygon-options.md- PolygonOptions：多边形配置references/map/circle.md- Circle：圆形覆盖物references/map/circle-options.md- CircleOptions：圆形配置references/map/heat-overlay.md- HeatOverlay：热力图references/map/heat-overlay-options.md- HeatOverlayOptions：热力图配置
4. 信息窗口
references/map/info-window.md- InfoWindow：信息窗口references/map/info-window-options.md- InfoWindowOptions：信息窗口配置
5. 地图 UI
references/map/ui-settings.md- UiSettings：UI 设置（缩放按钮、手势、比例尺等）
6. 事件监听
references/map/events.md- 地图事件：点击、长按、相机变化、手势等
7. 工具类
references/map/bitmap-descriptor.md- BitmapDescriptor：图标描述references/map/animation.md- Animation：标记动画
二、定位 Location（references/location/）
0. 初始化与配置
references/location/location-setup.md- 接入配置：Key 申请、SHA1 获取、AAR 导入、权限声明、三方依赖、隐私合规、鉴权初始化references/location/dmap-location-client.md- DMapLocationClient：定位客户端、初始化和生命周期references/location/dmap-location-client-option.md- DMapLocationClientOption：定位配置选项
1. 定位结果
references/location/dmap-location.md- DMapLocation：定位结果对象
2. 定位监听
references/location/dmap-location-listener.md- DMapLocationListener：定位监听器
3. API 参考
references/location/api-reference.md- API 类参考：新旧版本差异、DMapLocationManager（旧版）、鉴权 SDK 类
4. 常见问题
references/location/faq.md- 常见问题与错误码：错误码排查、Key 校验失败、后台定位、坐标系、场景选择
三、WebService（references/webservice/）
0. 初始化
references/webservice/webservice-setup.md- 接入配置：AAR 导入、鉴权初始化、MapServiceClient 创建references/webservice/map-service-client.md- MapServiceClient：服务客户端初始化
1. POI 搜索
references/webservice/search-params.md- SearchParams：搜索参数references/webservice/poi-search.md- POI 搜索：关键词搜索、周边搜索、输入提示
2. 地理编码
references/webservice/geo-params.md- GeoParams：地理编码参数references/webservice/geocoding.md- 地理编码：正/逆地理编码
3. 路线规划
references/webservice/route-params.md- RouteParams：路线规划参数references/webservice/route-planning.md- 路线规划：驾车、步行、骑行、公交
4. 响应模型
references/webservice/place-response.md- PlaceTextSearchResponse：POI 搜索响应references/webservice/geo-response.md- ReverseGeoResponse/ForwardGeoResponse：地理编码响应references/webservice/route-response.md- RouteResponse：路线规划响应
四、导航 Navigation（references/navigation/）
0. 接入配置
references/navigation/navi-setup.md- 接入配置：环境要求、AAR 导入、权限声明、隐私合规、鉴权初始化
1. 组件导航（快速接入）
references/navigation/dmap-navi-page.md- DMapNaviPage：组件导航入口、DMapNaviParams 参数、INaviInfoCallback 回调
2. 自定义导航
references/navigation/dmap-navi.md- DMapNavi：自定义导航核心类、算路、导航控制、视野模式、算路策略
3. 导航事件监听
references/navigation/dmap-navi-listener.md- DMapNaviListener：诱导信息、路口放大图、车道线、TTS 播报、电子眼、GPS 信号
4. 主辅路与高架桥
references/navigation/parallel-road.md- ParallelRoadListener：主辅路/高架桥检测与切换
5. 数据模型
references/navigation/navi-models.md- NaviPoi、Poi、DMapCarInfo、DMapCalcRouteResult、NaviInfo 等数据模型
如何使用
请根据任务所属模块，阅读 references/<模块>/ 下对应的参考文件以获取详细说明和代码示例。每个参考文件包含：
- 功能简要说明
- 完整代码示例及解释
- API 参数说明和注意事项
示例：
references/map/map-view.md
references/map/marker.md
references/location/dmap-location-client.md
references/webservice/poi-search.md
references/navigation/dmap-navi-page.md
references/navigation/dmap-navi.md