地图

has.createMapContext

has.createMapContext(string mapId): MapContext

创建map上下文MapContext对象。

起始版本： 1.0.0

参数：

返回值：

返回MapContext对象。

示例：

let mapContext = has.createMapContext('mapId');

MapContext

[h2]MapContext.getCenterLocation

MapContext.getCenterLocation(Object object)

获取当前地图中心的经纬度。返回的是gcj02坐标系坐标。

起始版本： 1.0.0

注意事项： 在调用此接口时如果使用网络资源，需要先完成配置服务器域名。

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.getCenterLocation({
  iconPath: '/path/icon.png', // 此处仅为样例，请开发者更换为可用图片资源地址
  success: (res) => {
    console.info('getCenterLocation success, res:', res);
  },
  fail: (err) => {
    console.error('getCenterLocation fail, err:', err);
  },
  complete: (res) => {
    console.info('getCenterLocation complete, res:', res);
  }
});

[h2]MapContext.getRegion

MapContext.getRegion(Object object)

获取当前地图的视野范围。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

success返回值：

southwest返回值：

northeast返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.getRegion({
  success: (res) => {
    console.info('getRegion success, res:', res);
  },
  fail: (err) => {
    console.error('getRegion fail, err:', err);
  },
  complete: (res) => {
    console.info('getRegion complete, res:', res);
  }
});

[h2]MapContext.getRotate

MapContext.getRotate(Object object)

获取当前地图的旋转角。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.getRotate({
  success: (res) => {
    console.info('getRotate success, res:', res);
  },
  fail: (err) => {
    console.error('getRotate fail, err:', err);
  },
  complete: (res) => {
    console.info('getRotate complete, res:', res);
  }
});

[h2]MapContext.getScale

MapContext.getScale(Object object)

获取当前地图的缩放级别。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.getScale({
  success: (res) => {
    console.info('getScale success, res:', res);
  },
  fail: (err) => {
    console.error('getScale fail, err:', err);
  },
  complete: (res) => {
    console.info('getScale complete, res:', res);
  }
});

[h2]MapContext.getSkew

MapContext.getSkew(Object object)

获取当前地图的倾斜角。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.getSkew({
  success: (res) => {
    console.info('getSkew success, res:', res);
  },
  fail: (err) => {
    console.error('getSkew fail, err:', err);
  },
  complete: (res) => {
    console.info('getSkew complete, res:', res);
  }
});

[h2]MapContext.includePoints

MapContext.includePoints(Object object)

缩放视野使所有输入的坐标点都在可视范围内。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

points属性：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.includePoints({
  points: [
    { latitude: 30.492150773775826, longitude: 114.5387855706236 },
    { latitude: 31.492150773775826, longitude: 113.5387855706236 }
  ],
  padding: [20, 20, 20, 20],
  success: () => {
    console.info('includePoints success');
  },
  fail: (err) => {
    console.error('includePoints fail, err:', err);
  },
  complete: (res) => {
    console.info('includePoints complete, res:', res);
  }
});

[h2]MapContext.moveToLocation

MapContext.moveToLocation(Object object)

将地图中心移至当前定位点，此时需设置地图组件show-location为true。

起始版本： 1.0.0

需要权限：

1. 在module.json5中声明ohos.permission.APPROXIMATELY_LOCATION。

2. 使用has.authorize()申请scope.userLocation授权。

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.moveToLocation({
  longitude: 114.2342423,
  latitude: 34.232424232,
  success: () => {
    console.info('moveToLocation success');
  },
  fail: (err) => {
    console.error('moveToLocation fail, err:', err);
  },
  complete: (res) => {
    console.info('moveToLocation complete, res:', res);
  }
});

[h2]MapContext.translateMarker

MapContext.translateMarker(Object object)

平移marker，带动画。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

destination属性：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.translateMarker({
  markerId: 1000,
  destination: {
    longitude: 78.232323,
    latitude: 23.121212
  },
  autoRotate: true,
  rotate: 90,
  duration: 1000,
  animationEnd: () => {
    console.info('translateMarker animationEnd');
  },
  success: () => {
    console.info('translateMarker success');
  },
  fail: (err) => {
    console.error('translateMarker fail, err:', err);
  },
  complete: (res) => {
    console.info('translateMarker complete, res:', res);
  }
});

[h2]MapContext.toScreenLocation

MapContext.toScreenLocation(Object object)

获取经纬度对应的屏幕坐标。坐标原点为地图左上角。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.toScreenLocation({
  longitude: 78.232323,
  latitude: 23.121212,
  success: (res) => {
    console.info('toScreenLocation success, res:', res);
  },
  fail: (err) => {
    console.error('toScreenLocation fail, err:', err);
  },
  complete: (res) => {
    console.info('toScreenLocation complete, res:', res);
  }
});

[h2]MapContext.setLocMarkerIcon

MapContext.setLocMarkerIcon(Object object)

设置定位点图标。支持网络路径、本地路径、代码包路径。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.setLocMarkerIcon({
  iconPath: '/path/icon.png', // 此处仅为样例，请开发者更换为可用图片资源地址
  success: () => {
    console.info('setLocMarkerIcon success');
  },
  fail: (err) => {
    console.error('setLocMarkerIcon fail, err:', err);
  },
  complete: (res) => {
    console.info('setLocMarkerIcon complete, res:', res);
  }
});

[h2]MapContext.moveAlong

MapContext.moveAlong(Object object)

沿指定路径移动marker。用于轨迹回放等场景。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
let path = [];
path.push({ latitude: 31.99685233070878, longitude: 118.75846023442728 });
path.push({ latitude: 31.993617206525155, longitude: 118.76150529647698 });
mapContext.moveAlong({
  markerId: 1000,
  path: path, // 坐标数组
  autoRotate: true,
  isMapMoving: true,
  color: '#0A59F7CC',
  width: 10,
  duration: 3000,
  success: () => {
    console.info('moveAlong success');
  },
  fail: (err) => {
    console.error('moveAlong fail, err:', err);
  },
  complete: (res) => {
    console.info('moveAlong complete, res:', res);
  }
});

[h2]MapContext.setCenterOffset

MapContext.setCenterOffset(Object object)

设置地图中心点偏移。向后向下为增长，屏幕比例范围(0.25~0.75)，默认偏移为[0.5, 0.5]。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.setCenterOffset({
  offset: [0.25, 0.25],
  success: () => {
    console.info('setCenterOffset success');
  },
  fail: (err) => {
    console.error('setCenterOffset fail, err:', err);
  },
  complete: (res) => {
    console.info('setCenterOffset complete, res:', res);
  }
});

[h2]MapContext.addMarkers

MapContext.addMarkers(Object object)

添加marker。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.addMarkers({
  markers: xxx, // marker数组
  success: () => {
    console.info('addMarkers success');
  },
  fail: (err) => {
    console.error('addMarkers fail, err:', err);
  },
  complete: (res) => {
    console.info('addMarkers complete, res:', res);
  }
});

[h2]MapContext.removeMarkers

MapContext.removeMarkers(Object object)

移除marker。

起始版本： 1.0.18

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.removeMarkers({
  markerIds: [1000], // makerId数组
  success: () => {
    console.info('removeMarkers success');
  },
  fail: (err) => {
    console.error('removeMarkers fail, err:', err);
  },
  complete: (res) => {
    console.info('removeMarkers complete, res:', res);
  }
});

[h2]MapContext.addGroundOverlay

MapContext.addGroundOverlay(Object object)

添加图片图层，图片会随着地图缩放而缩放。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.addGroundOverlay({
  id: 1,
  src: 'https://www.example.com/xxx.png', // 此处仅为样例，请开发者更换为可用图片资源地址
  bounds: {
    southwest: {
      latitude: 39.7032,
      longitude: 116.2978
    },
    northeast: {
      latitude: 40.1032,
      longitude: 116.6978
    }
  },
  visible: true,
  zIndex: 1,
  opacity: 1,
  success: () => {
    console.info('addGroundOverlay success');
  },
  fail: (err) => {
    console.error('addGroundOverlay fail:', err);
  },
  complete: (res) => {
    console.info('addGroundOverlay complete:', res);
  }
});

[h2]MapContext.updateGroundOverlay

MapContext.updateGroundOverlay(Object object)

更新图片图层。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.updateGroundOverlay({
  id: 1,
  src: 'https://www.example.com/xxx.png', // 此处仅为样例，请开发者更换为可用图片资源地址
  bounds: {
    southwest: {
      latitude: 39.7032,
      longitude: 116.2978
    },
    northeast: {
      latitude: 40.1032,
      longitude: 116.6978
    }
  },
  visible: true,
  zIndex: 1,
  opacity: 1,
  success: () => {
    console.info('updateGroundOverlay success');
  },
  fail: (err) => {
    console.error('updateGroundOverlay fail:', err);
  },
  complete: (res) => {
    console.info('updateGroundOverlay complete:', res);
  }
});

[h2]MapContext.removeGroundOverlay

MapContext.removeGroundOverlay(Object object)

移除图片图层。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.removeGroundOverlay({
  id: 1,
  success: () => {
    console.info('removeGroundOverlay success');
  },
  fail: (err) => {
    console.error('removeGroundOverlay fail:', err);
  },
  complete: (res) => {
    console.info('removeGroundOverlay complete:', res);
  }
});

[h2]MapContext.addArc

MapContext.addArc(Object object)

添加弧线。途经点与夹角必须设置一个。同时设置途经点和夹角时，以夹角角度为准。夹角定义为起点到终点，与起点外切线逆时针旋转的角度。

以下情况无法正确绘制出弧线：

• 途经点和夹角都未设置。

• 夹角为180的整数倍。

• 未设置夹角时，start、end、pass三个点其中有两个点完全相同。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.addArc({
  id: 1,
  start: {
    latitude: 39.7032,
    longitude: 116.2978
  },
  end: {
    latitude: 40.1032,
    longitude: 116.6978
  },
  pass: {
    latitude: 40.1032,
    longitude: 116.2978
  },
  angle: 90,
  width: 5,
  color: '#000000',
  success: () => {
    console.info('addArc success');
  },
  fail: (err) => {
    console.error('addArc fail:', err);
  },
  complete: (res) => {
    console.info('addArc complete:', res);
  }
});

[h2]MapContext.removeArc

MapContext.removeArc(Object object)

删除弧线。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.removeArc({
  id: 1,
  success: () => {
    console.info('removeArc success');
  },
  fail: (err) => {
    console.error('removeArc fail:', err);
  },
  complete: (res) => {
    console.info('removeArc complete:', res);
  }
});

[h2]MapContext.setBoundary

MapContext.setBoundary(Object object)

设置地图的显示边界范围。此接口同时会限制地图的最小缩放整数级别。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.setBoundary({
  southwest: {
    latitude: 39.7032,
    longitude: 116.2978
  },
  northeast: {
    latitude: 40.1032,
    longitude: 116.6978
  },
  success: () => {
    console.info('setBoundary success');
  },
  fail: (err) => {
    console.error('setBoundary fail:', err);
  },
  complete: (res) => {
    console.info('setBoundary complete:', res);
  }
});

[h2]MapContext.fromScreenLocation

MapContext.fromScreenLocation(Object object)

获取屏幕上的点对应的经纬度，坐标原点为地图左上角。

起始版本： 2.0.2

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.fromScreenLocation({
  x: 100,
  y: 100,
  success: (res) => {
    console.info('fromScreenLocation success:', res);
  },
  fail: (err) => {
    console.error('fromScreenLocation fail:', err);
  },
  complete: (res) => {
    console.info('fromScreenLocation complete:', res);
  }
});

[h2]Bounds

经纬度范围。

起始版本： 2.0.2

[h2]LatLng

经纬度。

起始版本： 2.0.2

[h2]MapContext.eraseLines

MapContext.eraseLines(Object object)

擦除或置灰已添加到地图中的线段。

起始版本： 2.0.2

参数：

Object参数：

示例：

let mapContext = has.createMapContext('mapId');
mapContext.eraseLines({
  lines: [{
    id: 1,
    index: 0,
    clear: true
  }],
  success: () => {
    console.info('eraseLines success');
  },
  fail: (err) => {
    console.error('eraseLines fail:', err);
  },
  complete: (res) => {
    console.info('eraseLines complete:', res);
  }
});