| name | dmap-android |
| description | 滴滴地图（滴图出行技术开放平台）Android SDK 开发指南，涵盖地图、定位、WebService、导航四大模块。在编写、审查或调试使用滴滴地图 Android SDK 的代码时应运用此技能。适用于地图初始化、标记、覆盖物、图层管理、事件处理、相机控制、UI 设置；定位服务（单次/连续/导航定位）；POI 搜索、地理编码、路线规划等 WebService 接口；以及组件导航与自定义导航等任务。当用户提及 DiMap、滴滴地图、滴图、DMapLocationClient、定位 SDK、WebService、POI 搜索、逆地理编码、路线规划、导航 SDK、DMapNavi 或相关 Android 移动端地图开发需求时自动触发。 |
| license | MIT |
| version | 1.0.0 |
滴滴地图 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 一行代码快速接入导航界面
- 使用
DMapNavi API 自定义导航 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
