批量保存位置信息(API名称:address/batchSave)
功能介绍
批量保存位置,最大支持5个,行政区域编码存在更新,不存在新增。
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/address/batchSave | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| addressList | Array | 是 | 行政区域列表。 |
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| addressCode | String | 是 | 位置编码 |
| address | String | 是 | 位置名称 |
| detailedAddress | String | 否 | 位置详细地址 |
| parentCode | String | 否 | 父级位置编码 |
| description | String | 否 | 描述 |
| coordinateType | String | 否 | 定位系统类型(/UWB/GPS,分别表示不涉及/UWB/GPS) |
| longitude | String | 否 | 经度(与coordinateType=GPS配套传参) |
| latitude | String | 否 | 纬度(与coordinateType=GPS配套传参) |
| coordinate | String | 否 | 坐标位置(与coordinateType= UWB配套传参,值格式:x坐标, y坐标, z坐标。如"10,20,30"与coordinateType= UWB配套传参,值格式:x坐标, y坐标, z坐标。如"10,20,30") |
| udfExtend1 | String | 否 | 扩展属性1 |
| udfExtend2 | String | 否 | 扩展属性2 |
| udfExtend3 | String | 否 | 扩展属性3 |
| udfExtend4 | String | 否 | 扩展属性4 |
| udfExtend5 | Date | 否 | 扩展属性5(日期格式:yyyy-MM-dd) |
| udfExtend6 | Date | 否 | 扩展属性6(日期格式:yyyy-MM-dd) |
| udfExtend7 | String | 否 | 扩展属性7 |
| udfExtend8 | String | 否 | 扩展属性8 |
| udfExtend9 | String | 否 | 扩展属性9 |
| udfExtend10 | String | 否 | 扩展属性10 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| status | String | 状态,failed | success。 |
| msg | String | 消息。行政区域名称不能为空。 |
| data | Object | 响应结果内容data。 |
请求示例
{
"addressList": [
{
"addressCode": "hzjTest1",
"address": "hzjTest1",
"detailedAddress": "深布xxxxxxxxx4号",
"parentCode": 440300,
"description": "描述一下",
"coordinateType": "GPS",
"longitude": 114.114449,
"latitude": 22.604495,
"coordinate": "",
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
},
{
"addressCode": "hzjTest2",
"address": "hzjTest2",
"detailedAddress": "",
"parentCode": 440300,
"description": "描述两下",
"coordinateType": "UWB",
"longitude": null,
"latitude": null,
"coordinate": "10,20,30",
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
},
{
"addressCode": "hzjTest3",
"address": "hzjTest3",
"detailedAddress": "",
"parentCode": 440300,
"description": "描述三下",
"coordinateType": "",
"longitude": null,
"latitude": null,
"coordinate": "",
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
}
]
} 响应示例
{
"status": "success",
"msg": null,
"data": [
{
"addressCode": "hzjTest1",
"address": "hzjTest1",
"parentCode": "440300",
"description": "描述一下",
"detailedAddress": "深圳东xxxxxxxxxx4号",
"coordinateType": "GPS",
"longitude": "114.114449",
"latitude": "22.604495",
"coordinate": "",
"geoHash": "ws10sep8",
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20T00:00:00.000+08:00",
"udfExtend6": "2024-09-21T00:00:00.000+08:00",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10",
"addressId": 5913544,
"addressLevel": 4,
"parentId": 5026528,
"addressPath": "5026256.5026275.5026528",
"lastUpdatedBy": 5005466,
"entityName": "Address",
"affectedRows": 1
},
{
"addressCode": "hzjTest2",
"address": "hzjTest2",
"parentCode": "440300",
"description": "描述两下",
"detailedAddress": "",
"coordinateType": "UWB",
"longitude": null,
"latitude": null,
"coordinate": "10,20,30",
"geoHash": null,
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20T00:00:00.000+08:00",
"udfExtend6": "2024-09-21T00:00:00.000+08:00",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10",
"addressId": 5913545,
"addressLevel": 4,
"parentId": 5026528,
"addressPath": "5026256.5026275.5026528",
"lastUpdatedBy": 5005466,
"entityName": "Address",
"affectedRows": 1
},
{
"addressCode": "hzjTest3",
"address": "hzjTest3",
"parentCode": "440300",
"description": "描述三下",
"detailedAddress": "",
"coordinateType": "",
"longitude": null,
"latitude": null,
"coordinate": "",
"geoHash": null,
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-20T00:00:00.000+08:00",
"udfExtend6": "2024-09-21T00:00:00.000+08:00",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10",
"addressId": 5913546,
"addressLevel": 4,
"parentId": 5026528,
"addressPath": "5026256.5026275.5026528",
"lastUpdatedBy": 5005466,
"entityName": "Address",
"affectedRows": 1
}
],
"success": true,
"failed": false
}