处理自动化服务REST API使用入门 |
接下来以处理建模器使用入门中发布的自定义密度聚类工具为例提供了使用示范，以便您能快速理解如何通过REST API使用处理自动化服务。
查看TownCluster工具的描述，确定工具ID、需要设置的参数ID等内容，并在iServer中生成令牌（请参考：获取 Token ）。
图 TownCluster工具的描述
根据发布的工具ID（sps.WorkflowProcessFactory.models:towncluster）、工具的参数ID以及要设置的参数值、生成的令牌，构建异步执行处理自动化工具POST请求URI如下：
http://172.16.16.8:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/jobs?token=OCtW1D34XoGM2xmxSUWfoTrWNbNlgfuVoQi8w4Tqejfh_7apnBAe6pt4zPWw1ClHtC4_LHNomodhp2vHMN8G-A..
根据发布的工具的参数ID以及要设置的参数值，构建如下POST请求参数（由于发布模型时勾选了保留参数，在此可只设置需要调整的参数，其余的参数使用发布时保留的参数）：
{
"parameter": {
"densitycluster-savedFields":["County","NAME"],
"densitycluster-eps":"15.0 Kilometer",
"saveas-dataConnInfo":"--providerType=hbase --hbase.zookeepers=172.16.16.8:2181 --hbase.catalog=demo --dataset=Town_15km"
},
"environment ":[
{
"master":"spark://172.16.16.8:7077",
"appName":"Geoprocessing",
"settings":["spark.cores.max=8","spark.driver.host=192.168.17.43","spark.executor.memory=32g"]
}
]
}
对处理建模器中已发布的自定义密度聚类工具的URI执行POST请求，即可对该地区的城镇进行密度聚类分析。
返回JSON格式的任务状态信息如下：
{"jobID":"gp-20200902-162021-B96D5","status":"started"}
通过异步执行的POST请求，您在返回的状态信息中可以得到此次执行的处理自动化任务ID（gp-20200902-162021-B96D5），根据这个任务ID和处理自动化工具ID，您可以通过GET请求查看相关的任务信息和结果。
以下为该处理自动化任务信息的GET请求URI:
http://172.16.16.8:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/jobs/gp-20200902-162021-B96D5.rjson?token=OCtW1D34XoGM2xmxSUWfoTrWNbNlgfuVoQi8w4Tqejfh_7apnBAe6pt4zPWw1ClHtC4_LHNomodhp2vHMN8G-A..
得到的处理自动化任务信息如下：
{
"jobID": "gp-20200902-162021-B96D5",
"processID": "sps.WorkflowProcessFactory.models:towncluster",
"messages": {
"result": "{"saveas-isSuccessful":"--providerType=hbase --hbase.zookeepers=172.16.16.8:2181 --hbase.catalog=demo --dataset=Town_15km"}",
"processMethodStatus": {
"读取矢量数据": "FINISHED",
"密度聚类": "FINISHED",
"保存矢量数据": "FINISHED"
},
"parameter": "{"densitycluster-savedFields":["County","NAME"],"densitycluster-eps":"15.0 Kilometer","saveas-dataConnInfo":"--providerType=dsf --path=/home/dsfdata"}"
},
"processTitle": "TownCluster",
"state": {
"formatStartTime": "2020-09-02 16:20:21",
"errorStackTrace": null,
"success": true,
"startTime": 1599034821996,
"formatEndTime": "2020-09-02 16:20:22",
"endTime": 1599034822335,
"runState": "FINISHED",
"errorMsg": null,
"elapsedTime": 0
}
}
以下为该处理自动化任务结果的GET请求URI:
http://172.16.16.8:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/jobs/gp-20200902-162021-B96D5/results?token=OCtW1D34XoGM2xmxSUWfoTrWNbNlgfuVoQi8w4Tqejfh_7apnBAe6pt4zPWw1ClHtC4_LHNomodhp2vHMN8G-A..
得到的处理自动化任务结果如下:
{"saveas-isSuccessful":"--providerType=hbase --hbase.zookeepers=172.16.16.8:2181 --hbase.catalog=demo --dataset=Town_15km"}
http://172.16.16.8:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/execute?parameter={"densitycluster-savedFields":"['M_unite','place_name']","saveas-dataConnInfo":"--providerType=hbase --hbase.zookeepers=172.16.16.8:2181 --hbase.catalog=demo --dataset=Town_15km","densitycluster-eps":"15.0 Kilometer"}&environment=[{"type":"BDT_Spark_Environment","master":"spark://172.16.16.8:7077","appName":"Geoprocessing","settings":["spark.cores.max=8","spark.driver.host=192.168.17.43","spark.executor.memory=32g"]}]&token=OCtW1D34XoGM2xmxSUWfoTrWNbNlgfuVoQi8w4Tqejfh_7apnBAe6pt4zPWw1ClHtC4_LHNomodhp2vHMN8G-A..
对处理建模器中已发布的自定义密度聚类工具的URI执行GET请求，即可对该地区的城镇进行密度聚类分析。得到的处理自动化任务结果如下：
{"saveas-isSuccessful":"--providerType=dsf --path=/home/dsfdata"}
同步执行处理自动化工具的请求URI对格式要求较高，请避免在URI中使用多余的空格和换行，可将URI拷贝至浏览器中进行验证。若参数中的某些特殊字符需要进行编码，可使用编码工具进行处理。
相关 REST API 介绍请参考geoprocessing。