批量保存位置信息（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
}
