## MapGIS Client for JavaScript（OpenLayers）产品介绍     MapGIS Client for JavaScript（Openlayers）是一套基于 OpenLayers 的云 GIS 网络客户端开发平台，无缝对接 MapGIS 云存储、云 GIS 服务器与云应用产品，能有效集成云端的地图、服务与资源，提供全面的 WebGIS 开发应用能力，支持高效地图可视化与分析应用功能，增强了大数据、实时流数据的高效可视化表达和分析功能。该套 SDK 中集成了 Openlayers5 原生接口和 MapGIS 扩展的功能接口，覆盖地图显示、数据管理、查询、编辑、统计、分析、专题图、可视化、标绘等全 WebGIS 功能，极大的丰富了 SDK 的功能和应用场景，可帮助您快速构建 WebGIS 应用。 > MapGIS Client for JavaScript (Openlayers) SDK 包含了 WebGIS 开发所需的开发库、API、示例等，结合司马云开发世界资源中心的配套开发资源，以及云听社区、开源社区GitHub 、Gitee，助力开发者高效开发。 ### OpenLayers     OpenLayers 是由 MetaCarta（美国地理搜索技术创业公司）公司开发的用于 GIS 客户端的开源 JavaScript 包，采用纯面向对象的 JavaScript 方式开发，全面支持跨浏览器。为了能够在客户端更好地展现和操作地图。OpenLayers 将抽象事物具体化为类，其核心类是 Map、WebGLMap、Layer、Source、View，几乎所有的动作都围绕这几个核心类展开，以实现地图加载和相关操作；把整个地图看作一个容器（Map、WebGLMap），核心为地图图层（Layer）、对应图层的数据源（Source）与矢量图层样式（Style）、地图表现相关的地图视图（View），除此之外容器中还有一些特别的层和控件，地图交互操作控件，以及有绑定在 Map 和 Layer 上的一系列待请求的事件。底层是 OpenLayers 的数据源，即 Image、GML、KML、Json、OGC 服务资源等，均为 source 与 format 命名空间下的子类，这些数据经过 Renderer 渲染，显示在地图容器中的图层 Layer 上。其中，地图容器（Map、WebGLMap）与图层（Layer）的渲染，提供 canvas、webgl 二种渲染类型，分别由 MapRenderer 与 LayerRenderer 实现。 > 详情请参考OpenLayers 官网地址 ### 主流地图库特点 - MapboxGL：基于 WebGL 独立渲染的开源二维地图库，其推出的矢量瓦片可视化效果和性能都很出众，标准被业内认可； - Leaflet：一款比较成熟的轻量级开源二维地图库，小而精悍，体验好，实践多、社区活跃、插件非常丰富，Mapbox 早期的地图库就是基于 Leaflet 开发； - OpenLayers：一套比较老牌和体系比较成熟的开源二维地图库，功能丰富且稳定，业内广泛使用，浏览器兼容好（兼容 IE6 及以上版本浏览器）； ## 产品下载     MapGIS Client for JavaScript 为开源产品，可从司马云-云开发世界下载正式发布的产品包，也可从开源社区（Gitee、GitHub）直接获取产品源码，自行编译、打包使用： - MapGIS 官方下载地址：http://smaryun.com/dev/download_detail.html#/download828 - GitHub 托管地址：https://github.com/MapGIS/WebClient-JavaScript - Gitee 托管地址：https://gitee.com/osmapgis/WebClient-JavaScript ## 环境参数 ### 硬件配置 推荐配置 - CPU：酷睿 i5 10400F 及以上 - 内存：16G 及以上 - 显存：独立显卡，显存 6G 及以上（gtx 1060） > 场景的流畅度除了和硬件配置有关外，也和数据量的大小有关，请根据实际情况进行选择。 ### 开发环境 - 前后台混合型项目 IDE 推荐：Microsoft Visual Studio（2015 及以上）、MyEclipse（2019 及以上）等 - 纯前端项目 IDE 推荐：Visual Studio Code、WebStorm 等 ### GIS 环境 ​ 产品融合了多种 GIS 服务标准，提供大量的 GIS 服务组件。开发时，用户可直接使用第三方已发布的 GIS 服务资源，也可以自行构建 GIS 服务器环境，支持如下 MapGIS 服务器产品： - 传统高性能 GIS 服务器平台：提供传统 GIS 相关的地图服务、要素服务、分析服务等。包括MapGIS IGServer 开发版、MapGIS IGServer .NET 版、MapGIS IGServer Java for Windows 版、 MapGIS IGServer（九州）版等版本。产品相关安装配置和操作使用手册，请参见司马云-开发世界-资源中心-服务器 GIS； - 大数据 GIS 分析服务器平台：MapGIS IGServer -X，提供矢量、影像、文本等大数据分析服务，产品相关安装配置和操作使用手册，请参见司马云-开发世界-资源中心-云 GIS-MapGIS 大数据与云平台-MapGIS IGServer-X； - 智能 GIS 分析服务器平台：MapGIS IGServer -S，提供智能 GIS 服务，产品相关安装配置和操作使用手册，请参见司马云-开发世界-资源中心-云 GIS-MapGIS 大数据与云平台-MapGIS IGServer-S。 ## 开发授权 ​ 您可以通过访问司马云官方网站获得开发者授权。提供免费云开发授权与硬 KEY 开发授权两种模式，开发者可结合实际应用需求选用。申请免费开发授权请前往帮助中心 - 免费云开发授权需联网完成授权验证。 - 硬 KEY 开发授权，可离线完成授权验证。 ## 开发 SDK ### 开发包     MapGIS Client for JavaScript（OpenLayers5） SDK，含 WebGIS 开发所需的开发库、API、示例、文档等资源，可访问MapGIS Client for JavaScript 产品门户在线体验，或下载资源本地部署。 ### 开发库 | 开发库 | 说明 | | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | webclient-openlayers-plugin.min.js / webclient-openlayers-plugin.js（可调试版） | OpenLayers5 开发库，包括地图可视化、基本操作、图形绘制、事件监听等功能，支持标准的 OGC 服务（WMS、WFS、WCS 等），提供地图显示、数据管理、查询、编辑、专题图、统计图、预案标绘、分析等全 WebGIS 功能，以及大数据分析相关功能 | | include-openlayers-local.js | 二次开发引用库，在此引入了 MapGIS Client for JavaScript（OpenLayers5）核心库 webclient-openlayers-plugin.min.js，OL5 原生库，以及其他第三方库，同时提供了示例访问 MapGIS IGServer 服务器的配置 | > 核心库分别提供压缩版（webclient-openlayers-plugin.min.js）与开发版（webclient-openlayers-plugin.js）两个版本，min 版一般在应用开发完成后发布部署阶段使用；二次开发阶段通常使用开发版，方便查阅与调试。 ### 开发 API     MapGIS Client for JavaScript 为用户提供离在线 API（应用程序编程接口），开发者可以通过 API 查找学习 MapGIS 提供的实现功能的方法。 - MapGIS Client for JavaScript（OpenLayers5） API - OpenLayers5 原生 API ### 开发示例     MapGIS Client for JavaScript（Openlayers5）为用户提供了功能全面的接口示例与配套文档，支持离在线访问，源码与效果可共同展现，同时提供即时编辑与运行功能，可以帮助您进行高效开发。 - 在线使用：MapGIS Client for JavaScript （Openlayers5）示例 - 离线使用：方式一，可在云开发世界下载MapGIS Client for JavaScript 开发包，解压后按说明步骤发布即可；方式二，可通过GitHub、Gitee获取产品源码，按说明文档编译运行。 ## 模块说明 MapGIS Client for JavaScript（OpenLayers5）对接云 GIS 产品，提供地图显示、数据管理、查询、编辑、专题图、统计图、预案标绘、分析等全 WebGIS 功能，以及大数据与智能 GIS 功能。 ### API 功能体系（导图）
openlayers API结构
基于openlayers扩展的mapgis开发接口

### API 结构说明     MapGIS Client for JavaScript（OpenLayers5）的**核心库**为**webclient-openlayers-plugin.min.js**，此开发库实质上是在 Web 客户端层对调用 MapGIS IGServer 等云 GIS 服务器提供的服务的接口封装，通过简便的功能控件、接口便能直接获取使用云 GIS 服务器提供的数据与功能服务资源。     OpenLayers 具有强大的互联网地图展现能力，并支持跨各种主流浏览器。此开发库充分借鉴了 OpenLayers 纯面向对象的开发思想，对接 MapGIS IGServer 等云 GIS 服务器产品，在 OpenLayers5 框架的基础上进行扩展，构造了调用 MapGIS IGServer 数据服务和功能服务的相关类，将前端 OpenLayers5 与云 GIS 服务器融合，富端强云的结合将会给开发和应用带来更大的便捷、更好客户端体验。
OL5 API结构
基于OpenLayers5扩展的mapgis开发接口

- Map 命名空间：调用地图数据资源的类，如矢量地图文档服务、瓦片地图服务等； - Service 命名空间：调用 GIS 功能资源服务的类，如查询、编辑、分析等功能服务； - Object 命名空间：结构类，或者 MapGIS 对象类，主要协助地图数据资源类和 GIS 功能资源类完成资源调用功能。 > 调用云 GIS 服务器资源的类都以简单明了代表实际意义的英文名称来命名，方便用户获取资源调用接口。具体请查看配套的 OpenLayers5 API，在 API 文档中每个类说明的最前面的文字内容写明了该类的继承类（父类）和子类，供广大用户学习和参考。 ## 版本说明 ### V10.6.2.10 - 添加设置地图文档中组图层下图层透明度属性接口 - 维护更新，修复若干 Bug ### V10.6.0.10 - 维护更新，修复若干 Bug ### V10.5.6.10 - 维护更新，修复若干 Bug ### V10.5.4.10 - 维护更新，修复若干 Bug ### V10.5.2.10 1. 功能新增 - OpenLayers 示例全面优化，提供配套示例说明文档与 API； - 丰富了对接 MapGIS IGServer 服务的功能示例，包括图层要素、文档类别的查询、编辑、分析功能等。 2. 性能优化-无 3. 站点维护 - 示例说明文档美化 ### V10.5.0.10 1. 全面整合了 OpenLayers 与 zondyclient 等脚本库，代码模块化，采用最新的 JavaScript ES6 标准； 2. 提供 OpenLayers 开发库、示例、API，支持基于 OpenLayers5 的二维数据可视化（含 OGC、MapGIS 地图服务、第三方地图服务等）、量算、查询编辑、空间分析、专题图，以及大数据可视化与分析等功能； 3. 新增集成 Turf.js 客户端空间分析库，提供客户端空间计算能力，支持实现在客户端层的空间分析、拓扑分析、空间关系计算等功能。 ## 第三方依赖 - OpenLayers：专为 WebGIS 客户端开发提供的 JavaScript 类库包，目前主流地图可视化引擎之一（https://openlayers.org/） - ECharts：基于 JavaScript 的开源可视化图表库（https://echarts.apache.org/zh/index.html） - MapV：地理信息可视化开源库（https://mapv.baidu.com/） - Turf：客户端空间分析开源库（https://turfjs.org/） - D3：基于 Web 标准的 JavaScript 图形可视化库（https://d3js.org/）