两点通视分析(lineOfSight)

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

dataset

object (数据集连接对象)

必需

地形栅格源数据集，具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

layerid

string

可选

图层id，通过地图服务配置方式发布下可用，优先级最高

datasourceName

string

数据源名称

可选

datasourceID

string

可选

数据源ID ，和datasourceName功能相同，用于确定数据源。二选一，优先级高于datasourceName。

datasetName

string

数据集名称

可选

datasetID

string

可选

每个数据集对应一个唯一标识ID，可替换数据源名称+数据集名称，确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高，规则参考数据服务中的id规则。

geometry

string

可选

Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection类型的GeoJson对象具体参见 “geojson 对象” geojson 对象

viewPoint

object

必需

观察点，类型为geojson 点对象，可选择支持z，如果没有z值，默认为栅格位置的高程值，具体参见 “geojson 点对象” geojson 点对象可选择支持z，如果没有z值，默认为栅格位置的高程值

targetPoint

object

必需

目标点，类型为geojson 点对象，可选择支持z，如果没有z值，默认为栅格位置的高程值，具体参见 “geojson 点对象” geojson 点对象可选择支持z，如果没有z值，默认为栅格位置的高程值

offsetA

number

观测点附加高程

可选

offsetB

number

目标点附加高程

可选

geoSRS

string

可选

viewPoint和targetPoint点的空间参考,可选，默认使用地形数据集的空间参考

outSRS

string

可选

输出目标的空间参考，可选，默认使用地形数据集空间参考

aysn

boolean

可选

是否异步执行，如果异步执行，直接返回任务id，通过任务状态查询返回结果。默认同步。

outGeometry

boolean

可选

返回结果是否输出几何信息（通视线、不通视线和障碍点），默认不输出

示例

{
      "dataset": {
          "datasourceName": "地形分析",
          "datasetName": "dem84.tif"
      },
      "data":
      [
          {
      		"viewPoint":
          	{
          		"type": "Point",
          		"coordinates": [101.6745411,36.5119804,2449.207]
      		},
      		"targetPoint":
  			{
          		"type": "Point",
               	"coordinates": [101.6692602973,36.5180437853,2600]
          	},
      		"offsetA":5,
      		"offsetB":10
          },
          {
      		"viewPoint":
          	{
          		"type": "Point",
          		"coordinates": [102.6745411,37.5119804,1449.207]
      		},
      		"targetPoint":
  			{
          		"type": "Point",
               	"coordinates": [102.6692602973,37.5180437853,1600]
          	},
      		"offsetA":5,
      		"offsetB":10
          }
  	],
      "geoSRS":"EPSG:4326",
      "outSRS":"EPSG:4326"
  }

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/rest/services//spatialanalysis/lineOfSight' \
--header 'Content-Type: application/json' \
--data-raw '{
      "dataset": {
          "datasourceName": "地形分析",
          "datasetName": "dem84.tif"
      },
      "data":
      [
          {
      		"viewPoint":
          	{
          		"type": "Point",
          		"coordinates": [101.6745411,36.5119804,2449.207]
      		},
      		"targetPoint":
  			{
          		"type": "Point",
               	"coordinates": [101.6692602973,36.5180437853,2600]
          	},
      		"offsetA":5,
      		"offsetB":10
          },
          {
      		"viewPoint":
          	{
          		"type": "Point",
          		"coordinates": [102.6745411,37.5119804,1449.207]
      		},
      		"targetPoint":
  			{
          		"type": "Point",
               	"coordinates": [102.6692602973,37.5180437853,1600]
          	},
      		"offsetA":5,
      		"offsetB":10
          }
  	],
      "geoSRS":"EPSG:4326",
      "outSRS":"EPSG:4326"
  }'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
    "resultcode": "success",
    "time":0.343,
    "result":
    [
    	{
    		"visible":true,//观察点与目标点是否通视。
    		"lineVisible":{geojson 对象},//不通视线对象
    		"lineInvisible":{geojson 对象},//不通视线对象,visible为false时，有效
            "barrierInfo":{geojosn 点对象}//障碍点信息，第一个障碍物的位置。
        },
        {
    		"visible":true,//观察点与目标点是否通视。
    		"lineVisible":{geojson 对象},//不通视线对象
    		"lineInvisible":{geojson 对象},//不通视线对象,visible为false时，有效
            "barrierInfo":{geojosn 点对象}//障碍点信息，第一个障碍物的位置。
        }
    ]
}