# Dmap Android

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

- Skill: `didi/dmap-android` (Agent Skill, multi-file: 51 files)
- Install (CLI): `npx skillmds@latest add didi/dmap-android`
- Raw SKILL.md: https://api.skillmd.com/api/skills/didi/dmap-android/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: didi (https://skillmd.com/u/didi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/didi/dmap-android

---


# 滴滴地图 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
```