REST 服务内容

由于 GIS 功能非常丰富，为了便于用户快速获取所需内容，SuperMap iServer 将 GIS 功能进行分类，并把每一类 GIS 功能封装为一套 REST 类型的 GIS 服务并开放完整的 REST API，使用时请参考：REST API。

REST 服务	功能描述
地图 REST 服务	与地图相关的功能，例如地图浏览、缩放、查询、对图层的操作等
数据 REST 服务	与数据相关的功能，例如对数据集、数据源的操作，编辑 GIS 数据等
数据目录 REST 服务	与数据注册、检索相关的功能，例如注册关系、时空、瓦片和二进制等数据，在数据库中创建和删除数据集等
空间分析 REST 服务	与分析相关的功能，例如数据集、几何对象的缓冲分析、叠加分析、表面分析等
交通网络分析 REST 服务	与交通网络分析相关的功能，例如旅行商分析、服务区分析、选址分区分析、最近设施查找分析、最佳路径分析等
交通换乘分析 REST 服务	与交通换乘分析相关的功能，例如公交换乘分析、公交站线查询等
三维 REST 服务	与三维相关的功能，例如对三维缓存数据的操作，三维场景的操作等
三维网络分析 REST 服务	与三维场景下网络分析相关的功能，如汇与源的计算、上游追踪、下游追踪、上游基础设施查找等
动态标绘 REST 服务	与动态标绘相关的内容，例如标号及图元的标绘、编辑，态势图文件操作等。
地址匹配 REST 服务	与地址匹配相关的功能，例如通过地址关键词、位置信息查询相关地点等
处理自动化 REST 服务	空间数据分析与处理相关的功能，例如矢量和栅格数据处理、空间深度学习、分布式分析等
分布式分析 REST 服务	与分布式分析相关的功能，例如基于 Spark 分布式集群的密度分析、点聚合分析、单对象空间查询等
机器学习 REST 服务	与机器学习相关的功能，例如分布式空间数据密度聚类分析、广义线性回归、二元分类、地物分类等
数据历史 REST 服务	与区块链空间数据历史追溯相关的功能，例如对区块链空间数据进行多用户编辑和历史追溯等
数据流 REST 服务	与数据实时传输相关的功能，例如服务器广播、客户端订阅等
流数据 REST 服务	与实时数据处理和分析相关的功能，例如对 JSON 格式的实时数据进行分析和处理等
数据科学 REST 服务	与数据科学分析相关的功能，例如在线创建、运行、监控 python 脚本，基于空间数据进行分布式分析、机器学习等
矢量瓦片 REST 服务	与基于 MVT 标准矢量瓦片出图相关的功能，例如获取指定瓦片、sprite 图集信息、Mapbox标准风格信息等
几何 REST 服务	与几何计算相关的功能，例如几何对象的距离、面积量算、坐标转换、缓冲区分析、叠加分析等
Web打印 REST 服务	与 WebMap 打印相关的功能，例如将在线地图打印成 GeoPDF 文档、对打印结果中的空间、文本信息二次编辑等
影像 REST 服务	与影像或栅格数据相关的功能，例如影像或栅格数据浏览、数据统计、影像查询与检索等

地图 REST 服务

地图 REST 服务提供 maps 资源及其子资源 map、layers，算法资源 area、distance 等，这些资源可以对地图和图层进行访问与操作，包括：

获取地图图片与地图信息。
获取地图图层信息与图层图片。
对图层进行创建、修改、获取或者删除操作。
获取鹰眼图片。
对地图进行查询并获取结果。
高亮几何地物。
对地图进行距离或者面积量算。
清除服务端缓存的地图图片。

数据 REST 服务

数据 REST 服务提供 data 资源及其子资源 datasources 和 featureResults，这些资源可以对空间数据进行访问与操作，包括：

获取数据源的信息，如数据源名称，数据源描述，引擎类型，投影信息，坐标单位，距离单位等。
修改数据源信息，包括数据源描述，坐标单位，距离单位。
获取数据源所包含的所有数据集的信息。
对数据集进行操作，包括创建、修改或者删除数据集。
对数据集中空间数据进行操作，包括获取、修改、添加、删除数据集中空间数据。
对数据集中的字段进行操作，包括获取，修改、添加、删除字段。
对数据集中字段的统计计算。如统计 WRLD30_ID 字段的平均值。
对数据集中的要素进行查询。

数据目录 REST 服务

数据目录 REST 服务提供 dataCatalog 资源及其子资源 relationship、sharefile、binary、spatiotemporal、sharefile 等，这些资源可以提供导入、导出关系、时空、瓦片和二进制等数据，获取数据库中数据集信息等能力，包括：

获取时空数据的数据集列表、数据集信息、字段列表、字段信息。
导入切片缓存数据。
获取切片缓存数据的数据包列表、数据包信息。
获取关系型数据的数据集列表、数据集信息、字段列表、字段信息。
获取关系型数据的数据包列表、数据包信息。
导入、导出关系型数据。
获取二进制数据的数据包列表、数据包信息。
从 iServer datastore 上传、获取二进制数据。
获取所有注册到 iServer 的数据集的数据集信息、字段列表、字段信息。

空间分析 REST 服务

空间分析 REST 服务，提供 spatialAnalyst 资源及其子资源 datasets、geometry 等，这些资源可以分别提供对于数据集、几何对象的空间分析服务，包括：

对数据集进行缓冲区分析。
对数据集进行叠加分析。
对数据集进行提取等值线、等值面的表面分析。
对数据集进行邻近分析，如生成泰森多边形。
对数据集进行的差值分析、空间关系分析、线性分析等服务。
对几何对象进行缓冲区分析。
对几何对象进行叠加分析。
对几何对象进行提取等值线、等值面的表面分析。
对几何对象进行邻近分析，如生成泰森多边形。

交通网络分析 REST 服务

交通网络分析 REST 服务通过 networkanalyst 资源及其 networkDataName、edgeweightnames 等子资源，提供了最近设施查找分析、选址分区分析、旅行商分析、多旅行商分析（物流配送）、最佳路径分析、服务区分析。

以最佳路径分析为例，最佳路经分析解决的问题是，在网络数据集中，给定 N 个点（N 大于等于2），找出按照给定点的次序依次经过这 N 个点的阻抗最小的路经。“阻抗最小”有多种理解，如时间最短、费用最低、风景最好、路况最佳、过桥最少、收费站最少、经过乡村最多等。在 iClient for Ajax 最佳路径分析范例中，在地图上选择起点与终点，即可得到两点之间的最佳路径。

交通换乘分析 REST 服务

交通换乘分析 REST 服务通过 trafficTransferAnalyst 资源及其 transferNetwork 等子资源，提供了公交换乘分析、公交站点查询功能。

交通换乘分析支持按照指定的公交站点和公交换乘策略进行换乘分析，返回相应的换乘方案，以及指定的某条换乘路线的详细信息。其中，支持的换乘策略包括时间最短、距离最短、最少换乘、少步行等。此外，交通换乘分析还支持通过关键字查询站点信息，这样客户端可以先查询站点，再根据合适的站点进行换乘分析。

三维 REST 服务

三维 REST 服务提供 3D 资源及其子资源 scenes、datas 等，这些资源可以分别提供三维场景和三维数据的操作，包括：

获取三维场景的信息。
获取三维场景中图层列表。
获取三维场景中某一个三维图层的表述，包括三维图层的名称、类型、对应三维数据的路径、所用数据在三维数据中的缓存层号。
获取三维数据。
获取三维模型缓存数据的索引文件。
获取三维数据的配置文件。
获取三维缓存数据里某一块缓存文件的版本。
获取三维数据中的一块缓存文件。

三维网络分析 REST 服务

三维网络分析 REST 服务通过3DNetworkDataName 及其子资源 sinks、sources、traceDownResult、traceUpResult 等，提供了三维场景中的网络分析功能，具体包括：

汇查找
源查找
上游追踪
下游追踪
上游基础设施查找

动态标绘 REST 服务

动态标绘 REST 服务通过 graphicObject、smlInfos 等资源，提供了标号库信息查询功能和态势图访问与操作，包括：

获取标号库 ID 信息。
通过指定 ID 获取标号库。
获取标号库中的具体标号信息。
获取服务器中的态势图文件列表。
对服务器中的态势图文件进行保存、加载、删除操作。
下载态势图文件。

地址匹配 REST 服务

地址匹配 REST 服务通过 address 资源及其 geocoding、geodecoding 等子资源，提供了地址的正向匹配和反向匹配功能，即通过地点名称关键词（如“中学“）查找地址位置，或根据位置坐标查询地点。

处理自动化 REST 服务

处理自动化 REST 服务提供 geoprocessing 资源及其子资源 list、tool 等，这些资源可以提供与空间数据分析与处理相关的功能，例如矢量和栅格数据处理、空间深度学习、分布式分析等能力，包括：

获取大数据栅格分析工具、大数据栅格管理工具等处理自动化工具列表以及用户自定义工具列表。
获取处理自动化工具的描述信息，如名称、描述、输入参数、环境参数和输出结果等。
获取处理自动化工具相关的任务列表、任务信息及任务的执行情况信息。
获取处理自动化任务的执行结果。
取消处理自动化任务。

分布式分析 REST 服务

分布式分析 REST 服务提供 processingJobs 资源及其子资源 dataProcessingJobs 和spatialanalystJobs 等，这些资源可以提供与分布式分析相关的功能，例如基于 Spark 分布式集群的密度分析、点聚合分析、单对象空间查询等能力，包括：

获取分布式数据处理作业以及分布式空间分析作业列表。
获取构建区域格网、拷贝数据、创建空间索引等作业的执行情况、详细配置信息。
对数据集执行 OD 分析、轨迹重建、要素连接、点聚合分析、缓冲区分析、密度分析、单对象空间查询等分析。
获取执行 OD 分析、轨迹重建、要素连接、点聚合分析、缓冲区分析、密度分析、单对象空间查询等作业的执行情况、详细配置信息。

机器学习 REST 服务

机器学习 REST 服务通过 machineLearning 资源及其 objectDetection、objectDetection 等子资源，提供了对空间数据进行机器学习的能力，能够执行分析、让用户进行交互操作或访问分析后的结果。支持决策树回归训练、决策树分类预测、场景分类、目标分类等20余种API算子。

数据历史 REST 服务

数据历史 REST 服务提供 dataHistory 资源及其子资源 datasources 等，这些资源可以对空间区块链数据进行历史追溯等功能，包括：

获取区块链空间数据的资源名称、访问路径、类型等信息。
获取数据源的数据源信息、数据集列表、数据集信息、字段列表、字段信息、要素信息等。
获取单个要素的要素历史信息。包括此要素的全部历史记录、历史记录标记时间等。

数据流 REST 服务

数据流 REST 服务通过 dataflow 资源及其 broadcast、subcribe 等子资源，提供了获取数据流服务，并通过数据流服务向客户端广播数据的能力。此外，客户端订阅数据流服务后可自动接收服务器广播的数据，通过 Websocket 协议与服务器进行数据传输。

流数据 REST 服务

流数据 REST 服务实现实时数据的分析与处理功能，包括对CSV、GeoJSON格式的实时数据进行分析和处理，数据接入协议包含WebSocket协议、TCP协议、HTTP协议以及Kafka专用通讯协议等。

数据科学 REST 服务

数据科学 REST 服务是面向数据科学家、数据分析师等角色所打造的在线交互式python开发环境，可以在线创建、运行、监控python脚本，基于空间数据进行分布式分析、机器学习等工作。

矢量瓦片 REST 服务

矢量瓦片 REST 服务提供 vectorTile 资源及其子资源 map 等，这些资源可以提供基于 MVT 标准矢量瓦片进行的出图，可在客户端实现地图的快速浏览、交互功能，包括：

获取 MVT 矢量瓦片地图列表，包括地图的名称、URI、资源类型等。
获取指定位置的瓦片。
获取地图的 Mapbox 标准风格信息。
获取当前地图中的 sprite 图集信息。
获取地图的 Mapbox 标准的字体源数据。

几何 REST 服务

几何 REST 服务提供 geometry 资源及其子资源 area、distance 等，这些资源可以提供几何对象的距离、面积量算、坐标转换、缓冲区分析、叠加分析等：

根据参数量算地图上的具体面积。
根据参数量算距离。
根据给定条件对点数组或一组几何对象进行投影坐标系转换。
根据给定条件对几何对象进行缓冲区分析。
根据给定条件对几何对象进行叠加分析。

Web 打印 REST 服务

Web 打印 REST 服务提供 webPrinting 资源及其子资源 v1、layoutTemplates、webPritingJobs 等，这些资源可以提供将在线地图打印成 GeoPDF 文档等能力，包括：

获取 Web 打印服务所有可用的模板列表信息。
获取当前已经完成和正在执行的 Web 打印任务列表。
获取 Web 打印任务的信息、状态和结果地址。
获取 Web 打印输出文档的数据流。

影像 REST 服务

影像 REST 服务提供 image 资源及其子资源 coolections、search 等，这些资源可以提供对影像或栅格数据的浏览、统计、查询与检索，包括：

获取影像集合列表、影像集合。
获取影像集合中的图里信息、统计信息、指定的瓦片或指定瓦片的信息。
查询指定条件的影像集合。
对影像集合进行操作，如获取、修改、添加或删除指定影像。