map（地图显示功能）为开发者提供易于上手的接口，开发者可以通过相关接口便捷地在HarmonyOS应用/元服务中加入地图相关的功能，包括显示地图、在地图上绘制（覆盖物）、添加动画、与地图交互、更新地图状态、常用工具函数等功能。

该模块提供以下地图常用功能：

* [MapComponentController](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcomponentcontroller)：显示地图，与地图有关的所有方法从此处接入。

地图覆盖物：

* [Marker](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-marker)：标记。
* [MapPolyline](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mappolyline)：折线。
* [MapArc](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-maparc)：弧线。
* [MapPolygon](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mappolygon)：多边形。
* [MapCircle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcircle)：圆形。
* [PointAnnotation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-pointannotation)：点注释。
* [Bubble](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-bubble)：气泡。
* [ClusterOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-clusteroverlay)：点聚合。
* [ImageOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-imageoverlay)：图片覆盖物。
* [BuildingOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-buildingoverlay)：3D建筑。
* [TraceOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-traceoverlay)：动态轨迹。
* [TileOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-tileoverlay)：瓦片图层。
* [Heatmap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-heatmap)：热力图。
* [MvtOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mvtoverlay)：矢量图层。
* [FlowFieldOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-flowfieldoverlay)：流场图层。
* [MassPointOverlay](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-masspointoverlay)：海量点图层。

添加动画：

* [Animation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-animation)：动画抽象类。
* [AlphaAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-alphaanimation)：控制透明度的动画类。
* [RotateAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-rotateanimation)：控制旋转的动画类。
* [ScaleAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-scaleanimation)：控制缩放的动画类。
* [TranslateAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-translateanimation)：控制移动的动画类。
* [FontSizeAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-fontsizeanimation)：控制字体大小的动画类。
* [PlayImageAnimation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-playimageanimation)：控制多张图片的帧动画类。
* [AnimationSet](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-animationset)：动画类集合。

与地图交互：

* [MapEventManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapeventmanager)：地图监听事件管理器。

更新地图状态：

* [newLatLng](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-newlatlng)：设置地图的中心点和缩放层级。
* [newLatLngBounds](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-newlatlngbounds)：设置地图经纬度范围、地图区域和边界之间的距离。
* [scrollBy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-scrollby)：按像素移动地图中心点。
* [zoomBy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-zoomby)：根据给定增量并以给定的屏幕像素点为中心点缩放地图级别。
* [zoomIn](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-zoomin)：放大地图缩放级别，在当前地图显示的级别基础上加1。
* [zoomOut](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-zoomout)：缩小地图缩放级别，在当前地图显示的级别基础上减1。
* [zoomTo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-zoomto)：设置地图缩放级别。

常用工具函数：

* [calculateDistance](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-calculatedistance)：计算坐标点之间的距离。
* [convertCoordinate](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-convertcoordinate)：坐标系转换，使用Promise异步回调。
* [convertCoordinateSync](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-convertcoordinatesync)：坐标系转换。
* [rectifyCoordinate](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-rectifycoordinate)：根据用户输入的坐标系和坐标以及获取当前的路由地，判断是否需要修正坐标。

## 导入模块



```
1. import { map } from '@kit.MapKit';
```