高德地图API用户手册：地图开发与标注

"地图开发和标注API手册，适用于Symbian平台，由高德软件提供，版本V2.0，涵盖了地图API的主要类、结构和功能，包括MapView、TGeoPoint、Overlay、OverlayItem等核心模块。" 这篇文档是关于在Symbian平台上进行地图开发和标注的API手册，由高德软件有限公司编写，版本号为V2.0。手册旨在详细介绍如何实现在Symbian系统中利用地图API创建和操作地图及图层标注。 1. **概述** - **1.1 说明**：文档内容聚焦于地图与基于地图的图层标注的实现，阐述了Symbian平台上的地图API所包含的5个主要模块：MapView（视图框架模块）、MapController（地图管理模块）、OverlayBundle（Overlay管理模块）、Overlay（覆盖物模板类）和OverlayItem（覆盖物项类）。 - **1.2 约定**：地图API规定了一些使用规则，例如MapController中的图标以CFbsBitmap格式存储，用户应通过MapView与地图交互；点Item的锚点位于地图图标底线中心；Overlay是抽象类，需要子类化才能使用；Overlay的管理通过OverlayBundle完成，建议使用MapView提供的接口。 2. **结构** - **2.1 概要框架图**：这部分给出了主要类和基本结构的关系图，帮助开发者理解各组件间的层次和依赖关系。 - **2.1.1 主要类及基本结构图**：描述了MapView、MapController、OverlayBundle、Overlay以及OverlayItem等类的结构。 - **2.1.2 绘制事件结构图**：详细说明了绘制过程中的事件处理机制。 - **2.1.3 键盘事件及触摸屏事件处理**：解释了如何处理用户的输入事件，包括键盘和触摸屏操作。 3. **主要模块的功能概述** - **3.1 MapView**：作为视图框架模块，它提供了地图显示和用户交互的基础。 - **3.2 TGeoPoint**：这是一个表示地图上经纬度坐标的类，用于精确定位地图上的位置。 - **3.3 Overlay**：这是一个抽象基类，用于创建自定义覆盖物，用户需要根据需求派生出具体类。 - **3.4 OverlayBundle**：负责管理和组织多个Overlay，提供批量添加和管理覆盖物的功能。 - **3.5 PointizedOverlay**：专注于处理点状覆盖物的类。 - **3.6 OverlayItem**：是覆盖物的基本单元，可以代表地图上的特定对象。 - **3.7 PointItem**：表示单个点，通常与地图图标相关联。 - **3.8 LineizedOverlay**：用于创建和管理线状覆盖物，如路径或路线。 - **3.9 LineItem**：表示一条线，是LineizedOverlay的组成部分。 - **3.10 API的图标管理**：描述了如何管理和使用地图上的图标资源。 - **3.11 MapController**：地图动作模块，控制地图的缩放、平移、旋转等操作。 这个API手册为开发者提供了全面的参考资料，包括类定义、事件处理、地图操作和覆盖物管理等方面，有助于开发者高效地在Symbian平台上构建地图应用并实现自定义的图层标注功能。通过理解和应用这些知识，开发者可以创建出具有丰富交互和定制化元素的地图应用程序。