# 批量保存位置信息（API名称：address/batchSave） #### 功能介绍 批量保存位置，最大支持5个，行政区域编码存在更新，不存在新增。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 | 参数 | 类型 | 是否必填 | 描述 | |:---|:---|:---|:---| | addressList | Array | 是 | 行政区域列表。 | addressList字段说明： | 参数 | 类型 | 是否必填 | 描述 | |:---|:---|:---|:---| | 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 } ```