通过iServer REST API使用分布式分析服务

发送反馈

iServer 分布式分析服务目前已支持出图作业，空间分析作业等。所有功能均提供 REST API，可通过执行 POST 请求来创建处理任务。系统管理员也可以在 iServer 中通过访问  processingJobs 资源页面来创建空间分析作业，进而发布 GIS 服务。下面将介绍如何通过 REST API 资源页面创建空间处理任务以及如何构建 REST请求。

注：默认ADMIN角色的用户才可创建分布式分析作业。如果其他角色的用户想要访问并使用该服务，请参见分布式分析服务的安全配置。

  1. 通过 REST API 资源页面创建空间处理任务

创建分析任务步骤如下：

  1. 分布式分析服务启用成功后，进入 iServer 服务资源页面，如http://supermapiserver:8090/iserver/services。
  2. 进入“distributedanalyst/rest”服务资源，依次点击进入“jobs”、"spatialanalyst"资源页面。目前空间分析作业支持密度分析、点聚合分析、单对象叠加分析等功能。根据您的需求，点击进入需要执行的空间分析资源页面。
  3. 单击右上角“创建分析任务”。
  4. 依次填入空间分析任务配置，带“*”号为必填信息。
  5. 填写完成后，单击“创建分析任务”。页面将自动跳转至正在执行的任务，并显示配置信息，待任务执行完成后，还会显示自动发布的服务地址。

相关 REST API 介绍请参考 processingJobs。

  1. 构建REST请求

      通过REST API请求资源创建空间处理任务时，可支持多种数据格式的输入输出，具体如下：

输入：input：【以下不做特殊说明的均为必填参数】支持以下两种输入形式：

  1.  datasetName：数据集名称。具体包括：通过数据目录服务导入的数据、注册到 iServer 的数据以及 iServer DataStore 中存储的数据集。
  1. 输入数据集信息。 当输入数据集文件路径及信息时，需使用此方式。 支持输入以下四种格式文件：
    1. csv文件：输入 csv 数据源时，需指定文件路径。该路径下应有与csv文件对应的.meta文件，才可进行分布式分析服务。
      • filePath：csv 所在路径。例如"filePath":"E:\iserver\\ProcessingData\\newyork_taxi_2013-01_14k.csv"
    2. udb 文件：

  1.  空间数据库

  1. 存于hdfs的索引文件

输出：output：【选填参数】分析结果的输出。支持输出以下格式：

  1. 本地udb文件。默认输出。默认路径为：【SuperMap iServer 安装目录】/webapps/iserver/processingResultData/Analyst/{id}
    • outputPath：分析结果工作空间输出路径。支持相对路径，以【SuperMap iServer 安装目录】/webapps为相对目录
    • datasourcePath：结果数据源的存放路径。支持相对路径，以【SuperMap iServer 安装目录】/webapps为相对目录
    • type：指定为udb
  1. 数据库（现支持 PostgreSQL、PostGIS、MongoDB）