# MapContext.addGroundOverlay(Object object)

> 基础库 2.14.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：不支持
> 
> __小程序插件__：支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [map](/miniprogram/dev/component/map.md)

## 功能描述

创建自定义图片图层，图片会随着地图缩放而缩放。

## 参数

### Object object


```json
[
  {
    "属性": "id",
    "类型": "Number",
    "默认值": "",
    "必填": "是",
    "说明": "图片图层 id"
  },
  {
    "属性": "src",
    "类型": "String",
    "默认值": "",
    "必填": "是",
    "说明": "图片路径，支持网络图片、临时路径、代码包路径"
  },
  {
    "属性": "bounds",
    "类型": "Object",
    "默认值": "",
    "必填": "是",
    "说明": "图片覆盖的经纬度范围",
    "子项": [
      {
        "结构属性": "southwest",
        "类型": "Object",
        "默认值": "",
        "必填": "是",
        "说明": "西南角经纬度",
        "子项": [
          {
            "结构属性": "longitude",
            "类型": "number",
            "默认值": "",
            "必填": "是",
            "说明": "经度"
          },
          {
            "结构属性": "latitude",
            "类型": "number",
            "默认值": "",
            "必填": "是",
            "说明": "纬度"
          }
        ]
      },
      {
        "结构属性": "northeast",
        "类型": "Object",
        "默认值": "",
        "必填": "是",
        "说明": "东北角经纬度",
        "子项": [
          {
            "结构属性": "longitude",
            "类型": "number",
            "默认值": "",
            "必填": "是",
            "说明": "经度"
          },
          {
            "结构属性": "latitude",
            "类型": "number",
            "默认值": "",
            "必填": "是",
            "说明": "纬度"
          }
        ]
      }
    ]
  },
  {
    "属性": "visible",
    "类型": "Boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否可见"
  },
  {
    "属性": "zIndex",
    "类型": "Number",
    "默认值": "1",
    "必填": "否",
    "说明": "图层绘制顺序"
  },
  {
    "属性": "opacity",
    "类型": "Number",
    "默认值": "1",
    "必填": "否",
    "说明": "图层透明度"
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数"
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数"
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）"
  }
]
```