宗老师团队国家工程-园区GIS应用

园区GIS底板

地理信息系统是XXX园区信息化建设的重要支撑系统，以其直观易懂的地图表现及强大的空间分析能力，在应用建设中需求非常强烈。园区GIS底板通过融合GIS引擎、数据治理和各类园区GIS图层形成园区的地理信息系统，支撑园区GIS资源的统一管理和应用，不仅能接入天地图资源、卫星影像和其他委办的共享GIS数据，也能创建具备自身特色的业务图层，支撑各类应用场景中GIS资源的调用。

园区GIS引擎

园区GIS引擎提供一整套的GIS服务能力，支持将矢量数据，瓦片数据，第三方地图等接入并发布为地图服务，支持预览和修改，便捷的调整地图图层显示、叠加、切换。通过参数配置，实现地图透明度、状态、视野、级别等配置；可以灵活的增加自定义图标、点标记、信息窗体等覆盖物；另外还支持点击地图、点击覆盖物、地图移动、点击地图要素等事件类功能。

GIS引擎对外提供数据接入，基础GIS服务和高级GIS服务。数据接入层支持标准的地理信息矢量数据，栅格瓦片数据，第三方GIS图层等数据接入并发布为图层服务。基础GIS服务提供JS API 、Web API 、Java SDK等多种对接方式，对外提供二三维地图基础功能，包括常见的地图交互，地图工具，分析工具，图层展示等。GIS引擎作为三维时空，CIM等应用的基础能力，可对外提供三维场景服务，地图特效，建筑信息模拟，城市信息模拟等高级GIS服务。

图层管理

地图的所有图层都在此进行管理，可以管理的图层有矢量图层、栅格瓦片图层、可编辑图层和ARCGIS图层。​​​​​​​

图层修改

可以对图层的名称、图层地址、图层样式文件等内容进行修改，修改不会改变图层的代码，为调用方快速调整图层提供了便利。

系统内置的必备图层不支持修改。

​​​​​​​图层查看

选择某一个地图，点击预览即可在新窗口查看对应的图层。在查看界面，可以使用鼠标的滚轮对地图进行放大和缩小，也可以通过点击鼠标左键拖动地图的位置。对于ARCGIS图层，系统不支持查看。

​​​​​​​图层新增

可以新增四类图层：矢量图层、栅格瓦片图层、可编辑图层、ARCGIS图层。其中矢量图层涉及图层名称、图层代码、地图文件（需要将地图矢量数据（shp，shx，dbf，pri）文件压缩成zip包）和地图样式文件（sld样式文件）。栅格瓦片图层涉及图层名称、图层代码、选择地图文件和服务器文件路径。可编辑图层涉及图层名称、图层代码、属性字段（分为字符串、双精度浮点型、整型和日期四种）和地图样式文件（sld样式文件）。ARCGIS图层涉及图层名称、图层代码和图层链接（URL格式）。​​​​​​​

图层删除

可以对图层进行删除操作。删除图层后，使用该图层的功能将移除该图层，用户需要在删除图层前确认使用该图层的应用已进行了相关处理。

 

信息系统在使用GIS引擎地图功能的过程中，通过调用GIS引擎提供的API接口控制地图的默认级别、中心点坐标和图层顺序。

地图状态设置

信息系统在使用GIS引擎地图功能的过程中，通过此API控制地图的随机地图中心位置、随机地图缩放级别。既系统自动返回一组随机的地图中心位置和地图的缩放级别。

显示范围设置

信息系统在使用GIS引擎时，通过此API控制控制地图的显示范围。根据指定的按钮ID、左下角经纬度和右上角经纬度，确定显示范围。

地图基本操作

信息系统在使用GIS引擎时，通过此API控制地图的放大、缩小。控制方式包括点击放大按钮、缩小按钮或者鼠标滚轮滑动，同时可以控制每次缩放的级别跨度。

限制显示范围

信息系统在使用GIS引擎时，通过此API限制地图的显示范围或取消地图的显示范围控制。控制参数为左下角经纬度、右上角经纬度。限制地图范围的规则为：地图的中心点经纬度，不能被移除左下角经纬度和右上角经纬度所框定的区域。

限制显示级别

信息系统在使用GIS引擎时，通过此API控制地图可被缩放的级别。控制参数为：最大显示级别和最小显示级别。限制规则为：通过点击或者鼠标滚动，地图的缩放级别必须介于最大显示级别和最小显示级别之间。

地图控件

信息系统在使用GIS引擎时，通过此API控制地图的主要空间，包含缩放标尺、比例尺、方向盘、回到默认视图、经纬度显示、鹰眼和鼠标返回位置信息。

缩放标尺：鼠标点击或者拖动标尺，可以对地图进行放大或缩小，标尺旁还提供了街道、市级、省级和国级的缩放级别提示。

经纬度显示：地图上实时显示当前地图的中心点坐标。

回到默认视图：点击回到默认视图，则地图回到默认大小和位置。

鼠标返回位置信息：鼠标点击地图的任意位置，都能显示鼠标所点击位置的经纬度。

​​​​​​​图层

图层叠加

信息系统在使用GIS引擎时，通过此API可控制图层的有无，点击按钮控制加载该和移除图层。

图层切换

信息系统在使用GIS引擎时，通过此API可以控制整个图层的显隐状态，整个地图的图层，根据已设定的规则隐藏或显示一些图层。

图层透明度

信息系统在使用GIS引擎时，通过此API可控制某一个图层的透明图，根据调用方传递的透明度数值，将对应的图层透明度调整为改数值。

层级设定

信息系统在使用GIS引擎时，通过此API可控制图层的层级，点击对应按钮则加载该图层，再次点击则移除该图层。

三方标准图层

信息系统在使用GIS引擎时，通过此API可以引入第三方标准图层的数据，并覆盖在现有的图层之上。

静态图片图层

信息系统在使用GIS引擎时，通过此API可以在现有的图层上，引入外部的图片图层，根据左下角经纬度和右上角经纬度围成的区域，将图片铺展开来。

热力图

根据传递的经纬度和数值，地图引擎自动计算出热力图并加载在原来的图层上面，用户可以通过开启或关闭参数控制热力图是否显示。

插值图

插值图可将带权重值的离散点位显示成不同颜色区域的图片，支持设置色带参数、裁剪区域。

风场图

风场图可将json格式的风向数据用流动动画线条的方式显示，支持设置流线颜色、速度、宽度等。

等压线图

等压线数据为带有压强值的线条gis数据，将线条和压强数值展示在地图上，即可呈现出等压线图，支持设置线条颜色、宽度、数值文本样式。

行政区划聚合

离散的点位可以按照行政区划自动计算总和数字，并展示在各区划行政中心位置，默认支持省市县级别区划。​​​​​​

覆盖物

点标记

信息系统在使用GIS引擎时，通过此API可以在地图上添加点标记。地图引擎根据传递的经纬度及图标URL地址数据，将所有的点加载在原有的图层之上，用户可以通过开启或关闭参数控制点标记是否显示。点标记的图标大小不会随地图的缩放而改变。

自定义图标

信息系统在使用GIS引擎时，通过此API可以在地图上添加不同类型的图标。地图引擎根据传递的经纬度、图标中心偏离系数及图标URL地址数据，将所有的点加载在原有的图层之上，用户可以通过开启或关闭参数控制自定义图标是否显示。自定义的图标大小不会随地图的缩放而改变。

复杂样式标记

通过此API可以在地图上添加不同类型的复杂样式标记。地图引擎根据传递的标题、副标题、内容等参数，将所有的点加载在原有的图层之上，用户可以通过开启或关闭参数控制复杂样式标记是否显示。复杂样式标记的大小不会随地图的缩放而改变。

覆盖物悬浮窗

信息系统在使用GIS引擎时，通过此API可以在地图上添加的覆盖物悬浮窗。鼠标悬浮在地图上对应的图标时，展示悬浮窗的内容。

自定义信息窗体

信息系统在使用GIS引擎时，通过此API可以在地图上添加的自定义信息窗体。鼠标悬浮在地图上对应的图标时，在指定位置展示悬浮窗体及其内容。

自动调整地图范围

信息系统在使用GIS引擎时，通过此API可以根据地图上的信息自动调整地图的层级和中心点经纬度。地图上先加载点位数据，然后地图引擎根据加载的数据，自动放大或缩小地图级别并调整经纬度，将所有的数据合理的显示在视野内。

移除覆盖物

信息系统在使用GIS引擎时，通过此API可以移除地图上的覆盖物、悬浮窗等。根据传递的图标ID，系统将对应的图标从地图上移除，也可以使用强制指令，将地图上的所有图标都移除。

添加点、线、面

信息系统在使用GIS引擎时，通过此API可以在地图的指定经纬度上添加点、线或面。根据传递的经纬度在地图上画置点、线或面，再根据线宽和颜色对其进行渲染。

限制显示级别

信息系统在使用GIS引擎时，通过此API可以控制图标显示的级别范围。随着地图级别的缩放当小于最小级别或者大于最大级别时，地图移除对应图标。

特殊线条样式

折线、多边形的边框可展示成水利行业标准的线条样式

​​​​​​​工具

测距、测面

调用此API后，用户可在地图上绘制出一段线条或一个区域面，API将返回线条的长度和区域面的面积。

空间查询

通过此API可对GIS引擎数据图层进行以下空间查询： -点查询：点击图层上的图标后，返回被点击的结果； -周边查询：界面绘制出圆心和半径后，返回在圆形区域内的结果； -矩形查询：界面绘制出矩形后，返回在矩形区域内的结果； -多边形查询：界面绘制出多边形形状后，返回在此多边形区域内的结果；

覆盖物空间查询

通过此API可对覆盖物图层进行周边查询、矩形查询、多边形查询。

坐标转换

此API可将经纬度坐标由一个坐标系转换成另一个坐标系，支持的坐标系有wgs84、国测局02、百度。

缓冲区分析

调用此API可计算出点、线、面图形扩张（收缩）一定距离的区域结果。

地理编码

调用此API可将一个地址描述转换为经纬度坐标。（目前仅支持联网调用）

逆地理编码

调用此API可将一个经纬度坐标转换为一个标准的地址文本。

搜索POI

调用此API可返回某关键字相关的地址结果列表及坐标信息。

卷帘对比

地图视图内显示卷帘条，可在卷帘两侧展示不同图层，并调整卷帘的位置。

分屏对比

左右两侧分别展示一个地图，两地图可展示不同图层，中心点、地图级别一致。​​​​​​

事件

点击地图

信息系统在使用GIS引擎时，通过此API可以控制鼠标点击时是否返回地图上对应位置的经纬度。

点击覆盖物

信息系统在使用GIS引擎时，通过此API可以返回鼠标点击的覆盖物id，供界面弹出详细信息。点击对应的标记物，系统弹出包含对应内容的弹窗。

地图移动相关事件

通过此API可以根据地图开始移动或结束移动的动作返回关联的事件。当地图开始移动时，出发对应ID的事件，当地图结束移动时，出发另一个对应ID的事件。

点击地图要素

信息系统在使用GIS引擎时，通过此API可以根据点击的地图要素，返回要素的相关地图数据信息或者触发指定的地图事件。

鼠标移入移出事件

鼠标移入点标记或瓦片图层对象区域均支持事件回调。

​​​​​​​地图编辑

创建多边形

信息系统在使用GIS引擎时，通过此API可以在地图上创建多边形。传递一组连续的经纬度，地图引擎根据这些经纬度的顺序，依次在地图上打点并连接成多边形，再根据颜色和线宽，对多边形进行渲染。

编辑多边形

信息系统在使用GIS引擎时，通过此API可以对地图上的多边形进行细粒度的编辑。找到某一个多边形，鼠标滑动到多边形的边上，点击后即可拖拽到自定义的位置，然后点击保存，即可保存为新的多边形。

搜索地图要素

信息系统在使用GIS引擎时，通过此API可以根据点击位置查询地图要素，并返回要素相关的地图数据信息；支持根据地图要素字段信息查询。

切割多边形

信息系统在使用GIS引擎时，通过此API可以地图上已经存在的多边形进行切割。系统根据传递的经纬度依次链接为线段，然后根据这些线段将多边形进行切割。

删除多边形

信息系统在使用GIS引擎时，通过此API可以对地图上已经存在的多边形进行删除。选择某一个或者一些多边形，将这些ID传递到地图引擎后，即可将这些多边形删除。

​​​​​​​动画

轨迹回放

信息系统在使用GIS引擎时，通过此API可以对地图上已经存在轨迹进行播放。播放参数有播放速度、开始、暂停、结束播放并返回起点、结束播放并返回结束点。点击开始播放，地图上的元素就会根据已经设定好的轨迹，开始逐渐向前运动。

弧形飞线

FlyLine对象可实现彩虹飞线的效果，支持独立的样式、数据设置，能够以飞线的形式表现地理位置上两个点之间的OD数据。

轨迹飞线

RoutePath对象可实现地面行车轨迹飞线的效果，支持独立的样式、数据设置。

按时间播放轨迹

可按照轨迹点的时间回放轨迹，支持速度调节。​

UI组件

散点图

本组件是展示如何利用覆盖物API实现散点图分布效果。支持独立的样式、和外部数据源，包括散点层的散点样式、标注样式、弹框样式以及交互变量等，能够以散点的形式表现地理位置上的点数据信息。

呼吸气泡

本组件是展示如何利用覆盖物API实现呼吸气泡效果。支持独立的样式、数据和交互配置，包括呼吸气泡的大小、动画效果、气泡类型以及经纬度等，能够以呼吸气泡的形式表现地理位置上的点数据信息。

流式气泡

本组件是展示如何利用覆盖物API实现流式气泡分布效果。支持独立的样式和外部数据源，包括气泡的大小、位置、颜色、动画效果以及经纬度等，能够以流式气泡的形式表现地理位置上的点数据信息。

线热力图

本组件是展示如何利用矢量图形API实现流式气泡分布效果。支持独立的样式、数据和外部数据源，能够以热力线的形式表现地理位置上的线路信息，适用于地图上线路图的大屏展示，例如展示地铁线路图。

区域热力图

本组件是展示如何利用矢量图形API实现流式气泡分布效果。支持独立的样式、数据和外部数据源，包括区域的标注、颜色、边线、鼠标交互事件以及位置信息等，能够以热力区域的形式表现地理位置上的区域信息。

​​​​​​​几何计算

几何计算API能够判断点线、点面、线线、线面、面面的位置关系；也能够计算两点距离、点线距离、线路长度计算、区域面积计算。

​​​​​​​全景地图

地图展示

将全景图标准的6张图片数据展示成360度的全景场景，并支持鼠标调整角度。

鹰眼地图

在全景图页面左下角可展示小地图，实时显示当前视线水角度，叠加其他全景图点位图标，支持点击切换。

点位切换

在全景图上可叠加显示其他全景图点位图标，点击可切换全景点位。

标签展示

根据建筑物的经纬度及高度坐标，可在全景图上叠加显示建筑物名称等信息。

​​​​​​​创建标签

用户可通过点击全景图自行创建标签（保存于浏览器缓存中），右键点击地图、输入标签名称、点击保存按钮后即可存储并在地图显示标签。通过标签列表也可快速定位到标签位置或删除标签

引入3d地图引擎js后，声明Map对象，指定地图中心点、地图级别、倾斜角度、显示图层后，即可展示一个三维地图场景。

地图状态设置

通过setCenter方法可设置地图中心位置，setZoom方法可设置地图级别，setPitch可设置倾斜角，setRotation可设置地图水平角。

地图控件

三维JS API提供了预置的地图控件Toolbar，可直接进行放大、缩小、抬高角度、降低角度、旋转地图、回到正北的常用操作功能。

天空盒设置

传入上下前后左右6张图片后，可将三维场景近景天空盒设置为图片效果。视点离地面较远时天空盒不显示。

场景切换

组合切换天空盒及亮度，实现白天、夜晚、傍晚的场景效果。

​​​​​​​三维模型

地形图显示

Map对象提供了showTerrain参数，设置为true后，三维地图将呈现出山地等地形高度。

倾斜摄影模型

创建Tileset对象，指定倾斜摄影服务的url地址后，地图将自动定位、显示该倾斜摄影模型。

gltf模型

目前支持gltf格式的三维模型文件，创建Model对象，并指定模型文件的uri后、坐标、比例、角度后，该模型将显示在三维地图中。同时支持将地图模式设置为始终跟踪模型。

模型编辑

可对三维场景中展示的gltf三维模型或倾斜摄影模型进行编辑调整，包括拖动、缩放、旋转。调整后的模型配置可持久化存储并重新加载。

​​​​​​​图层

图层叠加

通过map.add方法可以将一个图层(Layer)叠加显示。

图层切换

通过设置Layer.show属性，可以控制图层的显示、隐藏，来实现图层切换的功能。

图层透明度

通过设置Layer.opacity属性，可以控制图层的透明度。

三方标准图层

通过声明XYZLayer，ArcGISLayer，可以将xyz瓦片图层或Arcgis rest服务图层引入，显示在三维地图中。

静态图片图层

声明StaticImageLayer对象，传入图片的url和图片边界点的经纬度，即可在三维地图的对应位置叠加显示该图片。

热力图

声明Heatmap对象，指定数据源、透明度、颜色样式后，即可在三维地图上展示出热力图的效果。

超图图层

本引擎支持超图iServer地图服务的展示，可以将超图服务作为底图，在其基础上实现其他的业务功能。

图层滤镜

可针对地图显示的瓦片图层进行滤镜设置，包括亮度、色调、饱和度项

插值图

插值图可将带权重值的离散点位显示成不同颜色区域的图片，支持设置色带参数、裁剪区域。

风场图

风场图可将json格式的风向数据用流动动画线条的方式显示，支持设置流线颜色、速度、宽度等。

建筑物图层

将Geojson格式的建筑物数据以白模建筑或贴图建筑的形式展现在地图中。

建筑物拔高

动态调整3dtiles格式的建筑物的高度比例。

分类建筑物

根据3dtiles数据的属性字段设置不同的展示样式。

​​​​​​​覆盖物

自定义图标

声明Marker对象，指定图标url、经纬度坐标、图标宽高等属性，即可将图标展示在三维地图的指定位置上。

复杂样式标记

声明InfoWindow对象，指定经纬度坐标、html标记等属性，即可将各种样式的文本框展现在三维地图中。

自定义信息窗体

本示例演示了如何通过组合使用自定义图标和复杂样式标记，实现鼠标移入图标展示信息框的功能。

添加矢量图形

API提供了根据坐标位置信息绘制出各种矢量图形的方法，包括点、线、面、矩形、圆、立体图形、圆柱，并支持各种颜色样式的自定义。

添加矢量图层 （六棱锥、四棱锥、立体宽度墙、方盒）

在三维场景中创建贴图六棱锥、纯色四棱锥、带宽度的墙体及立方体。

编辑矢量图形（四棱锥、方盒、圆柱）

可对四棱锥、立方体、圆柱三种立体图形进行编辑，并持久化存储编辑信息。

地理围栏

描述：可显示三维围栏效果，支持围栏动效。

绘制矢量图形

可绘制不贴地的线、面图形；贴合地形的点、线、面、矩形、圆图形。

量测

在三维空间可量测距离、面积、单点坐标、两点高度差、两点方位角、三点构成的夹角、两点构成的三角各边长度

​​​​​​​事件

地图事件

API中的Map对象支持事件响应机制，在三维地图中鼠标点击地图或鼠标移动时，能够返回对应位置的经纬度。

点击覆盖物

在地图上叠加显示的图标、自定义标记、矢量图形等都支持点击回调，应用可在点击时进行自定义的响应处理。

​​​​​​​三维分析

地表透明

设置地表透明度后，可透过地表查看地下的三维模型。

地表开挖

用户绘制挖掘区域面，指定挖掘深度后，即可在地面显示挖掘洞，可展示地面下的模型信息。

日照分析

在三维场景中，可根据所在地理位置及时间，显示出模型的阴影。

淹没分析

用户在地形起伏的三维场景里，绘制出分析面后，可播放该区域水位上涨的淹没动画效果。

水库水位库容分析

示例中展示了水库的基底地形（蓝色较深、红色较浅），并支持通过界面调节水位高度滑块控制地图中的水体高度，同时水面面积和蓄水量也级联更新。

分层分户

针对带有楼层结构信息的3dtiles格式的BIM建筑数据，可在界面中展示出楼层结构图，并支持楼层的显示、隐藏控制以及楼层内某构件的高亮及自动定位。

雨天气效果

在三维地图场景中，模拟下雨的天气效果。

雪天气效果

在三维地图场景中，模拟下雪的天气效果

雾天气效果

在三维地图场景中，模拟雾的天气效果

三维柱状图

提供带有经纬度坐标及数值属性的数据，可在三维地图中以柱状图的形式展示，柱子高度表示数值高低，也可配置柱子颜色区间。

空间查询

在三维地图中，可叠加显示GIS引擎的后端图层，并支持鼠标点击查询、按半径画圆查询、画矩形查询、画多边形查询的方式将图层中的查询范围内的结果显示出来。

卷帘对比

地图视图内显示卷帘条，可在卷帘两侧展示不同图层及三维模型，并支持交换位置。

分屏对比

提供左右两侧分别展示一个地图，两地图可展示不同图层，中心点、地图级别、水平角、俯仰角一致。

通视分析

在三维场景中，用户选定观察点和目标点后，会生成一条连接线，线段的颜色可表达出可看到、被遮挡的不同状态。绿色表示可见，红色表示不可见。

剖面分析

在三维场景中绘制一条折线后，界面将显示以该折线为走向的地面剖面图。鼠标在剖面图上滑动时，三维地图也会同步显示对应的点位信息。

缓冲区分析

针对点、线、面类型的矢量图形，可计算出其边界外扩一定距离的缓冲区范围。缓冲区结果均为面类型数据。

可视域分析

在三维地图中，以某一点为观察点，确定观察方向后，可展示观察范围内的地面可见性。 点击可视域分析按钮，在地图上单击鼠标，确定观察点，移动鼠标可以调整可视角度与距离，再次单击鼠标，确定区域选择。分析结果将自动展示，红色为不可见，绿色为可见。

限高分析

可将三维地图中指定高度以上的模型用指定颜色混合显示。

河流截面积

在河流两侧选取两点，结合地形走向可生成一个剖面。可计算出剖面中河流区域的截面积及河流上方区域的截面积。

​​​​​​​动画

轨迹回放

通过此API可以在三维地图上已经存在轨迹进行播放，播放的对象可以是一个图标，也可以是一个三维模型。播放参数有播放速度、开始、暂停、结束播放并返回起点、结束播放并返回结束点。

执行规则：点击开始播放，地图上的元素就会根据已经设定好的轨迹，开始逐渐向前运动。

引入GL引擎js后，通过声明Map对象，指定容器、中心点经纬度坐标、缩放级别、俯仰角、矢量瓦片底图样式后，即可展示GL地图场景。

地图状态设置

调用setCenter、setZoom、setRotation、setPitch方法可分别设置地图场景的视点位置、地图级别、水平角度、俯仰角度。

显示范围设置

调用fitExtent方法可将地图视窗自适应显示某个区域，支持的参数有区域边界矩形范围、四个方向的内边距、地图动画开关及时长、自适应后视点的俯仰角度、水平角度。

地图基本操作

调用zoomIn、zoomOut API可分别实现地图的放大和缩小。

地图样式设置

调用setStyle API可动态设置矢量瓦片底图的风格，如浅色、深色。样式格式为mapbox，可在mapbox网站进行配置。

声明Layer对象可创建图层，layerCode参数为GIS引擎图层管理中的图层代码。通过add或remove API可添加、删除图层到地图对象中。

图层透明度

Layer对象的setOpacity方法可调节图层的透明度，范围为0到1。

三方标准图层

声明XYZLayer对象后可创建xyz瓦片类型的图层，瓦片格式坐标系要求为3857。

静态图片图层

声明StaticImageLayer对象可将一张图片显示在地图的指定的矩形框内。

图层蒙版

创建Layer对象并指定maskColor后可创建出蒙版图层，蒙版图层还支持镂空区域（即“洞”）的设置。

图层滤镜

Layer对象的hueRotate可设置图层的色相、contrast可设置对比度、saturation可设置饱和度。通过多个参数的综合设置可调节瓦片图层的整体样式风格。

建筑物图层

创建Buildings对象即可在地图上显示三维白模建筑物，需指定geojson格式的建筑物矢量数据源，可设置纯色或贴图显示。

点标记层

创建MarkerLayer后，可将一批点位以单个图层的形式、统一的图标样式在地图上展示。

文本标记层

创建TextLayer后，可将一批点位数据以单个图层的形式、统一的文本样式在地图上展示。

热力图

创建HeatMapLayer对象后，可在地图上将点位的权重值用热力图的方式展现，可设置的参数为点位数据及权重值、透明度、热力半径、色带值等。

高德在线地图

创建AMapLayer对象后，可将高德地图作为底图。可设置高德底图的样式、显示元素等。

​​​​​​​覆盖物

自定义图标

创建Marker对象，指定图标url、经纬度坐标、图标宽高等属性，即可将图标展示在地图的指定位置上。

文本标记

创建Text对象，指定文本内容、经纬度坐标、字体颜色、大小后，即可将文字展示在地图的指定位置上。

信息窗体

创建infoWindow对象，指定div布局、坐标等属性，即可将自定义的布局样式展示在地图中。

矢量图形

API提供了根据坐标位置信息绘制出各种矢量图形的方法，包括点、线、面、平面、圆柱，并支持各种颜色样式的自定义。

地理围栏

创建GeoFencing对象，指定围栏坐标串、高度值、颜色值，即可展示出渐变色地图围栏。

​​​​​​​工具

经纬度和像素坐标互转

pixelToCoordinate方法能够实现屏幕像素坐标转换为经纬度坐标；

coordinateToPixel方法将经纬度坐标转换为当前屏幕区域的像素坐标

​​​​​​​事件

点击地图

API中的Map对象支持事件响应机制，在地图中鼠标点击地图，能够返回对应位置的经纬度。

点击覆盖物

在地图上叠加显示的图标、自定义标记、矢量图形等都支持点击回调，应用可在点击时进行自定义的响应处理。

​​​​​​​动画

轨迹回放

过此API可以对地图上已经存在轨迹进行播放。播放参数有播放速度、开始、暂停、结束播放并返回起点、结束播放并返回结束点。

执行规则：点击开始播放，地图上的元素就会根据已经设定好的轨迹，开始逐渐向前运动。

绕点旋转

本示例展示了如果利用定时器改变地图角度来实现绕点旋转的动画播放效果。

动画点标记

创建Circle对象即可在地图上展示一个圆形，示例中展示了如果利用定时器改变圆形大小，来实现点标记的动画效果。

发光图标

本示例展示了通过创建MarkerLayer及CircleLayer，并设置CircleLayer的animate属性，来实现一组发光图标的展示。

气泡飞线

创建VerticalLine，指定飞线坐标、颜色、透明度、飞行时长等参数，可在地图上展示垂直向上飞的飞线动画。

彩虹飞线

创建RainbowLine，指定起始点、终止点的坐标、飞线颜色、弧度等参数后，可在地图上展示出彩虹形式的飞线动画。

轨迹飞线

创建PolylineLayer，指定折线的坐标，设置飞线速度、长度后，即可在地图上用飞线的形式将折线展示出来。

飞行管理器

FlyManager为飞行管理类，支持初始化设置飞行路线坐标、速度等参数，并可控制飞行开始、暂停、结束。

​​​​​​​UI组件

线热力图

创建多个线矢量对象、指定不同颜色后，即可展现出线热力图的效果。

区域热力图

创建多个面矢量对象、指定不同风格样式后，即可展现出面热力图的效果。

雷达图

本示例展示了如何利用Plane对象和定时器配合来实现雷达扫描动画效果。

行政区板块图

本示例展示了如何结合Polygon对象和Buildings对象，展示出行政区突起的板块图效果

创建Yunli3D.Scene对象，指定相机位置、目标中心位置，即可在浏览器中展示一个三维空间场景。setClearColor API可指定任意颜色的场景背景色。

设置亮度

setBrightness API可调节三维空间场景的亮度，亮度调高或调低后，包括被背景色、场景中的三维对象都会变亮或变暗。

​​​​​​​摄像机

设置状态

三维场景中的相机位置和目标位置均可通过API进行动态设置，设置的API是setPosition和setTarget，传入的参数为三维场景的x、y、z三维坐标值。

获取状态

通过三维场景Scene对象的getPosition和getTarget API可获取当前的视点位置坐标、目标点位置坐标。

平滑移动

通过setPosition API可立即调整摄像机位置，如果需要实现缓慢移动至某位置，可附加设置duration参数，单位为毫秒。

显示范围设置

调用fitView方法，传入目标区域对象、角度值、动画时长后，可平滑移动至一个视角，屏幕将自适应显示目标区域对象。

​​​​​​​模型显示

OjMtl文件

3D引擎支持将obj格式的三维模型（mtl为贴图文件）展示在三维场景中。创建ObjMtl对象，传入模型文件url、目标位置、三个方向的旋转角度、三个方向的缩放比例，调用场景的add方法即可展示。

移除模型

调用场景对象的remove方法，可将已经展示在三维场景中的模型对象进行移除。

模型悬浮窗

三维场景中的三维模型对象，支持附加的信息窗体显示，可指定的参数有偏移量坐标、窗体布局、锚点位置。

更新模型

此示例展示了如何调节三维模型的位置，修改模型的显示比例、修改模型的旋转角度。

获取模型信息

调用三维模型对象的getBbox方法，可获取到模型在三维场景内的包围盒坐标值。

​​​​​​​覆盖物

点标记

创建Marker对象，指定图标url、三维空间坐标、图标宽高等属性，即可将图标展示在三维场景的指定位置上。

文本标记

创建Text和DOMText对象均可在三维场景中显示一个文本标签，支持设置文本内容、字体样式等属性。区别点是，Text对象不随视点变化而改变大小，而DOMText对象类似于实体模型，根据视点位置改变大小。

信息窗体

创建infoWindow对象，指定div布局、坐标等属性，即可将自定义的布局样式展示在三维场景中。

矢量图形

API提供了根据坐标位置信息绘制出各种矢量图形的方法，包括点、线、面，并支持各种颜色样式的自定义。

覆盖物悬浮窗

在同一位置创建Marker和InfoWindow对象可实现Marker的悬浮窗效果。

示例中的控制规则为：鼠标悬浮在地图上对应的图标时，展示悬浮窗的内容。

建筑物图层

创建Buildings对象，可将建筑物轮廓矢量数据转变为三维建筑物，展示在三维场景中。

移除覆盖物

调用场景对象的remove方法后，可清除三维场景的指定覆盖物对象。

清空场景

调用场景对象的clear方法后，可清除三维场景的全部对象，包括三维模型、覆盖物等。

​​​​​​​事件

点击模型

在三维场景中显示的模型支持点击回调，应用可在点击时进行自定义的响应处理。

点击覆盖物

在三维场景中显示的图标支持点击回调，应用可在点击时进行自定义的响应处理。

​​​​​​​标绘

绘制点

调用Draw方法，指定绘制图形类型为point，即可进入绘制点模式，在三维场景的实体上单击鼠标，即可在被点击位置绘制一个点。

绘制线

调用Draw方法，指定绘制图形类型为polyline，即可进入绘制线模式，在三维场景的实体上依次鼠标，双击结束后，即可完成一条折线的绘制。

绘制面

调用Draw方法，指定绘制图形类型为Polygon，即可进入绘制面模式，在三维场景的实体上依次鼠标，双击结束后，即可完成一个闭合面的绘制。

​​​​​​​可视化效果

发光点线面

矢量图形点、线、面均可设置enabledBloom参数，可实现辉光的效果。

发光围栏动画

创建Fencing对象后，指定围栏坐标、高度、围栏动画条数、颜色等参数后，可在三维场景中展示一个自下而上循环播放的围栏动画。

​​​​​​​地图图层数据管理

GIS引擎图层管理界面，支持各类图层的创建、数据导入、编辑、删除、预览操作。通过开发引擎的API接口，可以进行各图层的地图要素管理。

​​​​​​​矢量文件图层

通过导入shp文件创建的图层，图层数据只读，不可编辑。

​​​​​​​可编辑图层

用户创建的图层，可指定点、线、面类型，指定属性字段。也可以通过上传shp文件创建可编辑图层。该类型图层可通过API接口进行数据的增删查改、也可以进行字段的管理。

​​​​​​​栅格瓦片图层

将离线瓦片拷贝至服务器后，可发布为xyz瓦片图层。可进行预览，并可使用JS API在Web端作为底图展示。

​​​​​​​预置图层

系统已预置了天地图、高德地图等多种常用的互联网瓦片图层。可进行预览，并可使用JS API在Web端作为底图展示。

​​​​​​​第三方图层

可将Arcgis rest服务图层、featureservice图层注册，通过JS API进行图层展示或通过GIS数据API进行数据的查询。

提供矢量图层数据的增加、修改、删除、查询API。

增加矢量数据

调用增加地图要素API，传入图层代码、点线面坐标、图层属性字段值后，即可完成数据的增加。

修改矢量数据

调用修改地图要素API，传入图层代码、搜索条件、被修改的坐标或属性值，即可完成数据的修改。

删除矢量数据

调用删除地图要素API，传入图层代码、搜索条件，即可完成数据的删除。

查询矢量数据

调用查询地图要素API，传入图层代码、搜索条件，即可返回满足条件的数据坐标及属性值。

​​​​​​​字段管理

提供矢量图层各字段的新增、删除、修改和列表查询API。

新增字段

传入图层代码及多个字段的名称、字段类型、备注信息，即可完成字段的新增。

删除字段

传入图层代码、字段名称，即可完成字段的删除。

修改字段

传入图层代码、字段名称、字段新名称、备注信息，即可完成字段的修改。

查询字段

通过此API可以获取图层的字段信息，包括字段名，字段类型，字段备注。

​​​​​​​空间查询

提供按半径查询、按矩形或多边形查询的API，接口会返回满足条件的结果列表。其中按半径查询需传入中点位置及查询半径长度、按矩形或多边形查询需传入轮廓坐标值。

​​​​​​​综合查询

支持按多边形、按圆形、按属性条件查询GIS图层的属性信息

​​​​​​​坐标转换

坐标转换API，支持坐标点或空间数据在三种坐标系间互相转换：

gps:wgs84经纬度坐标

gcj02:国测局02坐标系

baidu:百度坐标系​​​​​

缓冲区分析

调用缓冲区分析API，传入点或线或面类型的坐标数据及缓冲半径，即可返回计算得出的缓冲区域坐标数据。结合空间查询API，可实现在缓冲区内查询数据的功能。

​​​​​​​地理编码

地理编码支持将一段标准结构的地址文本转换成经纬度坐标，并支持设置返回的坐标系类型；逆地理编码支持将一个经纬度坐标转换为一段地址描述。

​​​​​​​格网分析

格网分析工具，包括格网过滤点，格网聚合，查询格网内的点集。将大量点位数据划分格网后，格网过滤点API会将同一格网内的点数限制在固定范围内；格网聚合将把同一网格内的数据合并为一个点，并将合并的总数赋给该点；查询格网内的点集可查询到某格网内的完整原始点位数据。

​​​​​​​插值分析

该API提供插值分析服务，根据样本点，色阶等参数，在给定的空间范围内执行插值，返回png格式的插值图和图片对应的坐标范围。

​​​​​​​行政区划查询

提供省市区行政区划按名称、按编码、按点位坐标、按矩形范围查询等服务。各API均可设置是否返回区划的轮廓坐标信息。