Skip to content

MapView 地图概述

MapView 是 Android 车载导航应用中的 地图显示与交互组件。可在中控屏、仪表盘等多块屏幕上呈现可深度定制的导航地图,并叠加路线、标注、兴趣点、矢量图形等业务数据。

效果示意

MapView 地图概览


主要能力

以下按 产品能力 归纳 MapView 模块支持的功能。每项能力在独立指南中有详细说明与示例。

基础与显示

能力 说明 指南
地图初始化 配置默认地图中心、缩放级别、屏幕密度、日/夜样式及引擎就绪后的业务配置 快速开始
地图配色与主题 地图样式加载、日/夜切换、OEM 换肤与运行时样式切换 地图配色方案
主题与布局 主题切换;地图视口布局 主题与布局
地图特性开关 路况、三维地标与建筑、地形、指南针、比例尺、卫星底图等图层与控件 地图特性 · 卫星图
地图状态监听 首帧绘制、引擎运行状态等诊断与监听 地图状态监听
截图 当前视图截图与离屏截图 截图

相机与导航视角

能力 说明 指南
相机控制 地图位置、缩放、倾角、朝向;路线全览与区域适配;二维/三维显示模式 显示模式与视角
跟车模式 车头朝上、北朝上或静态跟车,与车辆位置联动 显示模式与视角
自动缩放 导航中按车速、前方可见距离与下一引导动作自动调整视野;三维模式下可配合倾角 Auto Zoom
自车位置 车辆图标、位置更新及二维/三维车辆样式 自车图标显示

地图数据与图层

能力 说明 指南
标注 图钉、标记等自定义标注的创建与管理 Annotation
Annotation Bubble 拥堵、路线气泡、Smart Bubble 等地图气泡 Annotation Bubble
路线渲染 导航路线的绘制、刷新、高亮与移除;沿线路况;已驶过路段消隐 路线渲染
叠加层 折线、多边形、贴图区域;续航圈、围栏、轨迹等矢量叠加 叠加层
地图兴趣点展示 搜索并在地图上展示兴趣点结果 地图显示兴趣点(POI)
路侧停车 展示路侧停车位、高亮与触摸交互 路侧停车

用户交互

能力 说明 指南
触摸与手势 平移、缩放、旋转、倾角;路线、标注、兴趣点等要素的点击与长按 触摸与手势

导航引导与多屏

能力 说明 指南
转弯气泡 逐向导航中的转向箭头与下一道路名 转弯气泡
路口放大图 复杂路口的独立放大视图 路口放大图
多屏显示 主屏与副屏等多块屏幕的地图联动与数据同步 多屏显示

文档索引

指南按能力主题组织,便于按场景查阅。

入门

# 文档
1 概述(本文)
2 快速开始

地图样式

# 文档
16 地图配色方案
9 主题与布局
8 地图特性
18 卫星图

相机

# 文档
3 显示模式与视角
20 Auto Zoom
4 自车图标显示

数据与图层

# 文档
5 Annotation
21 Annotation Bubble
6 路线渲染
7 叠加层
11 地图显示兴趣点(POI)
12 路侧停车

交互与高级能力

# 文档
10 触摸与手势
15 多屏显示
19 路口放大图
17 转弯气泡
13 截图
14 地图状态监听

产品指南

面向产品与设计的能力说明:


集成要点

  • 先完成 SDK 全局初始化,再初始化地图视图。
  • 须在地图 就绪回调之后 再配置相机、路线与各图层能力。
  • 初始地图中心由 客户端按业务场景指定,文档中的示例坐标仅供参考。
  • 在 Activity 或 Fragment 中正确转发地图生命周期,避免黑屏或资源泄漏。

完整接入步骤见 快速开始