
# 查询附近作业对象（API名称：findNearSite）
#### 功能介绍
查询附近作业对象
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
| [新增作业对象](https://support.huaweicloud.com/api-isdp/api_01_0266.html)  | 需要有作业对象才可进行查询                                                |
   
#### URL
| **请求方式** | **HTTPS地址**                                              | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/taskObject/findNearSite | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**            | **类型**        | **是否必填** | **描述**                                   |
|:---|:---|:---|:---|
| longitude         | string        | 是        | 经度                                       |
| latitude          | string        | 是        | 纬度                                       |
| distance          | integer       | 否        | 距离（米）， 最多50000, 不存默认10000                |
| siteName          | string        | 否        | 作业对象名称                                   |
| groupIdList       | array\[long\] | 否        | 作业对象分组id数组(最多支持200个id)                   |
| groupIncludeChild | boolean       | 否        | 是否包含下层分组的数据（为true时groupIdLis数组长度只能为1）    |
| signSiteParentId  | long          | 否        | 作业对象父节点id                                |
| page.start        | integer       | 否        | 分页起点                                     |
| page.count        | integer       | 否        | 一页显示数量                                   |
| orgId             | array\[long\] | 否        | 组织单元id数组(最多支持200个id)                     |
| orgIncludeChild   | boolean       | 否        | 是否包含下层组织单元的数据（为true时orgId数组长度只能为1）       |
| addressIds        | string        | 否        | 行政区域id路径，用英文逗号路径隔开，例如: 1000,1001,1002    |
| mode              | string        | 否        | 支持list和map,不传默认list，为map时排除超过distance的数据 |
| deviceId          | string        | 否        | 设备id                                     |
| customerId        | long          | 否        | 客户id                                     |
| supplierId        | long          | 否        | 供应商id                                    |
   
#### 响应参数
| **参数**       | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| stateCode    | String | 响应状态码： - 0-成功  - 其他-失败   |
| errorMessage | String | 响应描述                                                                                                                                                                                                                                                                                                                                                                                         |
| result       | Object | 响应结果内容data、分页数据                                                                                                                                                                                                                                                                                                                                                                              |
   
result出参：
| **参数** | **类型**         | **描述**     |
|:---|:---|:---|
| data   | List\<Object\> | 响应结果内容data |
   
data出参：
见[响应参数](https://support.huaweicloud.com/api-isdp/api_01_0263.html#api_01_0263__zh-cn_topic_0000001700451734_section473235733415)
#### 请求示例
```
{
  "longitude":"113.9866",
  "latitude": "22.6707",
  "distance":20000,
  "mode":"",
  "siteName":"",
  "groupIdList":[],
  "groupIncludeChild":"",
  "signSiteParentId":"",
  "orgId":null,
  "orgIncludeChild":"",
  "addressIds":"",
  "deviceId":"",
  "customerId":"",
  "supplierId":"",
  "page":{"count":15,"start":0}
}
```
#### 响应示例
```
{
"stateCode": "0",
"errorMessage": null,
"result": {
"data": [
{
"signSiteId": 99053449,
"customerName": "客户名称",
"tenantId": 51678,
"tenantName": null,
"projectNo": "166755315906451678;tstteste1107",
"projectName": "数据飞升1;没有行政区域",
"signSiteCode": "fsefwefwewew",
"signSiteName": "测试test315",
"signSiteSource": "1",
"signSiteType": "屋顶站",
"signSiteTypeCode": "3",
"signSiteLevel": null,
"signSiteParentId": null,
"longitude": "113.986606",
"latitude": "22.670707",
"country": "中国",
"province": null,
"city": null,
"signSiteAddress": "******",
"deleteFlag": 0,
"createdBy": 234159,
"creationDate": "2022-11-04T06:30:09.000+00:00",
"lastUpdatedBy": 234159,
"lastUpdateDate": "2023-03-15T02:02:53.000+00:00",
"creationTimestamp": 1667543409629,
"lastUpdateTimestamp": 1678845772720,
"appName": "basedata-server",
"entityName": "taskObject",
"countryId": 1024531,
"provinceId": null,
"cityId": null,
"createName": "155xxxx5678",
"lastUpdateName": "155xxxx5678",
"udfExtend1": "test",
"udfExtend2": "123",
"udfExtend3": "3",
"udfExtend4": "",
"udfExtend5": null,
"udfExtend6": "2023-03-29T16:00:00.000+00:00",
"udfExtend7": "自定义扩展属性7",
"udfExtend8": null,
"udfExtend9": null,
"udfExtend10": null,
"secret": "0",
"geoHash": "ws10cz4d",
"customerId": 275298,
"supplierId": 296511,
"supplierName": "供应商名称",
"ownerIds": "1208239",
"ownerNames": "131xxxx9888",
"ownerGroupId": null,
"ownerGroupName": null,
"orgId": 98995196,
"regionPath": "1024531",
"regionId": 1024531,
"orgPath": "-1.98995162.98995194.98995196",
"orgFlag": "0",
"positionSystem": "GPS",
"taskObjectGroupId": 6731,
"mappingOrgId": null,
"deviceId": null,
"deviceTypeId": null,
"coordinate": "12,123.24,2541",
"groupName": "通用",
"groupPath": "6731",
"distance": 1,
"childCount": 0,
"regionPathName": "中国",
"regionNamePathList": [
"中国"
],
"regionName": "中国"
}
],
"totalCount": 1
}
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。
