#### # new Basemap(options)

基础地图对象
[ES5引入方式]：
zondy.Basemap()
[ES6引入方式]：
import { Map } from "@mapgis/webclient-common"

#### 参数

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
`options` | Object |  | 构造参数
`baseLayers` | Collection | new Collection() | 图层管理器
`id` | String | '' | 基础地图的ID
`title` | String | '' | 基础地图的名称
`thumbnailUrl` | String | '' | 基础地图的缩略图地址

绑定事件

- 添加基础图层事件

##### 支持如下方法：

[1、销毁Map对象]
[2、通过json对象构造并返回一个新的Map对象]
[3、转换为json对象]
[4、克隆并返回一个新的Map对象]

##### 示例

添加底图图层

    // ES5引入方式
    const { Map, Basemap, Collection } = zondy
    const { IGSTileLayer } = zondy.layer
    // ES6引入方式
    import { Map, Basemap, Collection, IGSTileLayer } from "@mapgis/webclient-common"
    //创建Map对象
    const map = new Map({
      // 初始化底图图层集合
      basemap: new Basemap({
        // 可以设置多个图层到底图集合中
        baseLayers: new Collection(
          [
            // 创建一个图层
            new IGSTileLayer({
              url: '服务及地址'
            })
          ]
        )
      })
    });

### 继承关系

- Evented

### 成员变量

#### 成员变量概述

名称 | 类型 | 描述
--- | --- | ---
`baseLayers` | `Collection` | `图层管理容器中包含的子图层`
`id` | `Collection` | `基础地图的id`
`spatialReference` | `Collection` | `基础地图的坐标系`
`thumbnailUrl` | `Collection` | `基础地图的缩略图地址`
`title` | `Collection` | `基础地图的名称`

#### 成员变量详情

类型: Collection

#### # baseLayers

图层管理容器中包含的子图层

类型: Collection

#### # id

基础地图的id

类型: Collection

#### # readonly spatialReference

基础地图的坐标系

类型: Collection

#### # thumbnailUrl

基础地图的缩略图地址

类型: Collection

#### # title

基础地图的名称

### 方法

#### 方法概述

名称 | 返回值类型 | 描述
--- | --- | ---
`fromJSON` | `Map` | `通过json对象构造并返回一个新的Map对象`
`clone` | `Basemap` | `克隆并返回一个新的Map对象`
`destroy` | `` | `销毁Map对象`
`off` | `Object` | `移除事件 示例如下:`
`on` | `Object` | `注册一个新的监听事件; 示例如下：`
`toJSON` | `Object` | `转换为json对象`

#### 方法详情

#### # static fromJSON(json)

通过json对象构造并返回一个新的Map对象

#### 参数

名称 | 类型 | 描述
--- | --- | ---
`json` | Object | json数据

返回值

一个新的Map对象

类型: Map

#### # clone()

克隆并返回一个新的Map对象

返回值

新的Basemap对象

类型: Basemap

#### # destroy()

销毁Map对象

#### # off(typesopt, fnopt, contextopt)

移除事件
示例如下:
[1、移除一个事件的指定回调函数]
[2、移除一个事件的所有回调函数]
[3、移除多个事件的同一个指定的回调函数]
[4、移除多个指定事件的回调函数]
[5、删除时指定上下文 - types类型为字符串]
[6、删除时指定上下文 - types类型为对象]

#### 参数

名称 | 类型 | 描述
--- | --- | ---
`types` | string | 移除指定事件类型上绑定的回调函数 当类型为字符串时，可以移除单个或多个事件类型绑定的回调函数，单个事件："click"，多个事件：以空格分割:"click double-click"； 当types为对象时，使用如下方式移除事件：{'click': onClickFun, 'mouse-move': onMouseMoveFun}
`fn` | function | 事件回调函数，当types为字符串，且不指定要删除的回调函数时，删除该事件上的所有回调函数
`context` | Object | 事件回调函数的this关键字将指向的对象

Inherited From:
  - Evented#off

返回值

当前实例

类型: Object

##### 示例

##### 移除一个事件的指定回调函数

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的off方法移除一个事件的回调函数
    view.off('click', clickFunction)

##### 移除一个事件的所有回调函数

    // 一个事件的回调函数1
    const clickFunction1 = function (event) {
      console.log("点击事件1:", event)
    }

    // 一个事件的回调函数2
    const clickFunction2 = function (event) {
      console.log("点击事件2:", event)
    }

    // 调用MapView或SceneView的off方法移除一个事件的所有回调函数
    // 不指定回调函数，则移除该事件上的所有绑定的回调函数
    view.off('click')

##### 移除多个事件的同一个指定的回调函数

    // 多个事件的同一个回调函数
    const eventFunction = function (event) {
      console.log("事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个事件的同一个指定的回调函数
    view.off('click double-click', eventFunction)

##### 移除多个指定事件的回调函数

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个指定事件的回调函数
    view.off({
       // 移除click事件上一个指定的函数
      "click": clickFunction,
      // 移除double-click上所有指定的函数
      "double-click": undefined
    })

##### 删除时指定上下文 - types类型为字符串

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的off方法移除一个事件的回调函数
    view.off('click', clickFunction, view)
    // 调用MapView或SceneView的off方法移除一个事件的所有回调函数
    view.off('click', undefined, view)

##### 删除时指定上下文 - types类型为对象

    // 一个事件的回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }
    // 调用MapView或SceneView的off方法移除多个指定事件的回调函数
    view.off({
       // 移除click事件上一个指定的函数
      "click": clickFunction,
      // 移除double-click上所有指定的函数
      "double-click": undefined
    }, view)

#### # on(typesopt, fnopt, contextopt)

注册一个新的监听事件;
示例如下：
[1、注册一个事件]
[2、一次注册多个事件 - 同一个回调函数]
[3、一次注册多个事件 - 分别指回调应函数]
[4、当types为字符串时 - 指定上下文]
[5、当types为对象时 - 指定上下文]

#### 参数

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
`types` | String | Object | null | 事件类型 当types为字符串时，可以定义单个或多个事件，单个事件："click"，多个事件：以空格分割:"click double-click"； 当types为对象时，使用如下方式指定事件：{'click': onClickFun, 'mouse-move': onMouseMoveFun}
`fn` | function | null | 事件回调函数
`context` | Object | null | 事件回调函数的this关键字将指向的对象

Inherited From:
  - Evented#on

返回值

当前实例

类型: Object

##### 示例

##### 注册一个事件

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    view.on('click', clickFunction)

##### 一次注册多个事件 - 同一个回调函数

    // 初始化一个事件回调函数
    const eventFunction = function (event) {
      console.log("事件:", event)
    }

    // 调用MapView或SceneView的on方法注册多个事件
    // 多个事件类型使用同一个回调函数
    view.on('click right-click-down', eventFunction)

##### 一次注册多个事件 - 分别指回调应函数

    // 初始化一个左键点击事件回调函数
    const clickFunction = function (event) {
      console.log("click事件:", event)
    }

    // 初始化一个右键按下事件回调函数
    const rightClickFunction = function (event) {
      console.log("right-click-down事件:", event)
    }

    // 调用MapView或SceneView的on方法注册多个事件
    // 每一个事件类型，使用单独的回调函数
    // 注意使用此种方式，一种类型的事件仅能指定一个回调函数
    view.on({
      "click": clickFunction,
      "right-click-down": rightClickFunction
    })

##### 指定上下文 - types类型为字符串

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
      console.log("上下文对象:", this)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    // 指定view为回调函数的上下文对象
    view.on('click', clickFunction, view)

##### 指定上下文 - types类型为对象

    // 初始化一个点击事件回调函数
    const clickFunction = function (event) {
      console.log("点击事件:", event)
      console.log("上下文对象:", this)
    }
    // 调用MapView或SceneView的on方法注册一个点击事件
    // 指定view为回调函数的上下文对象
    view.on({
      "click": clickFunction,
      "right-click-down": clickFunction
    }, view)

#### # toJSON()

转换为json对象

返回值

导出的json对象

类型: Object

### 事件

#### 事件概述

名称 | 描述
--- | ---
`底图图层创建事件（已废弃）` | `底图图层创建事件（已废弃）`
`底图图层更新事件（已废弃）` | `底图图层更新事件（已废弃）`
`底图图层移除事件（已废弃）` | `底图图层移除事件（已废弃）`

#### 事件详情

#### # 底图图层创建事件（已废弃）

##### 属性:

Name | Type | Attributes | Default | Description
--- | --- | --- | --- | ---
`event` | Object |  |  | 事件对象
`type` | LayerEventType | <optional> | 'layerview-created' | 事件类型
`layer` | Layer | <optional> |  | 事件接收对象
`layerView` | LayerView | <optional> |  | 事件地图视图中心
`view` | BaseView | <optional> |  | 事件地图视图对象

##### 示例

<h7>视图图层创建事件

    basemap.on('layerview-created', (event) => {
      console.log("添加地图图层事件:", event)
    })

#### # 底图图层更新事件（已废弃）

##### 属性:

Name | Type | Attributes | Default | Description
--- | --- | --- | --- | ---
`event` | Object |  |  | 事件对象
`type` | LayerEventType | <optional> | 'layerview-update' | 事件类型
`layer` | Layer | <optional> |  | 事件接收对象
`layerView` | LayerView | <optional> |  | 事件地图视图中心
`view` | BaseView | <optional> |  | 事件地图视图对象

##### 示例

<h7>视图图层创建事件

    basemap.on('layerview-update', (event) => {
      console.log("添加地图图层事件:", event)
    })

#### # 底图图层移除事件（已废弃）

##### 属性:

Name | Type | Attributes | Default | Description
--- | --- | --- | --- | ---
`event` | Object |  |  | 事件对象
`type` | LayerEventType | <optional> | 'layerview-remove' | 事件类型
`layer` | Layer | <optional> |  | 事件接收对象
`layerView` | LayerView | <optional> |  | 事件地图视图中心
`view` | BaseView | <optional> |  | 事件地图视图对象

##### 示例

<h7>视图图层创建事件

    basemap.on('layerview-remove', (event) => {
      console.log("添加地图图层事件:", event)
    })