云存储API 最后更新时间: 2021年05月08日

key

客户唯一标识

用户申请，由高德地图API后台自动分配

string(32)

必填

无

name

表的名称

支持任意中英文字符、数字、下划线

string(50)

必填

无

sig

数字签名

数字签名获取和使用方法

string(280)

可选，选择数字签名认证的用户必填

无

status

返回状态

取值规则：

1：成功；

0：失败，未知原因；

-11：失败，已存在相同名称表

-21：失败，已创建表达到最大数据

必须

info

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明。

必须

tableid

生成的数据表的唯一标识（该参数是发起数据存储API以及检索API的必填参数）

该参数，您还通过登录云图数据管理台，手工创建地图获得， 获取table id方法说明

必须

key

客户唯一标识

用户申请，由高德地图API后台自动分配

必填

无

tableid

数据表唯一标识

获取tableid方法说明

必填

无

loctype

定位方式

设置是以请求中的经纬度参数（_location）还是地址参数（_address）

来计算最终的坐标值。

可选值：

1：经纬度；格式示例：104.394729,31.125698

2：地址；标准格式示例：北京市朝阳区望京阜通东大街6号院3号楼

可选

1

data

新增的数据

创建的数据

规则：json

必填

无

_name

数据名称

类型：string

必填

无

_location

坐标

类型：string

支持点数据

规则：经度,纬度，经纬度支持到小数点后6位               格式示例：104.394729,31.125698

当loctype=1时，必填

无

coordtype

坐标类型

类型：string

可选值：

1: gps

2: autonavi

3: baidu

您可输入coordtype=1,或者autonavi

可选

autonavi

_address

地址

类型：string

当loctype=2时，必填

无

<customfield1>

用户自定义字段1

无

<customfield…>

用户自定义字段…

无

sig

数字签名

数字签名获取和使用方法

选择数字签名认证的用户必填

无

status

返回状态

取值规则：1：成功；0：失败

必须

info

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明

必须

_id

成功创建的数据id

必须

key

客户唯一标识

用户申请，由高德地图API后台自动分配

必填

无

tableid

数据表唯一标识

获取table id方法说明

必填

无

file

新增的数据文件

规则：

文件格式：csv文件的二进制流，使用UTF8、GBK编码，字段总数不超过40个；

数据量不超过10000条且文件大小不超过10M；

3）字段命名规则：以英文字母开头，仅由英文字母、数字、下划线组成，总长度不超过20位；

必填

无

_name

文件中代表”名称”的字段

必填

无

loctype

定位方式

设置是以文件中的经纬度字段还是地址字段来计算最终的坐标。

可选值：

1：经纬度；格式示例：104.394729,31.125698

2：地址

可选

1

_address

文件中代表”地址”的字段

当loctype=2时，必填

无

longitude

文件中代表”经度”（格式示例：104.394729）的字段

当loctype=1时，必填

无

latitude

文件中代表”纬度”（格式示例：31.125698）的字段

当loctype=1时，必填

无

coordtype

坐标类型

类型：string

可选值：

1: gps

2: autonavi

3: baidu

您可输入coordtype=1,或者autonavi

可选，

仅当定位方式loctype=1时，该字段有效

autonavi

sig

数字签名

数字签名获取和使用方法

选择数字签名认证的用户必填

无

status

返回状态。

值为0或1。

1：成功；

0：失败

必须

info

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明

必须

batchid

本次批处理任务的唯一标识。

若批量处理任务创建成功，则返回该任务的唯一标识batchid。

用户使用批量处理进度查询接口可查询该batchid对应的任务处理进度和结果。

每个batchid的有效期为：处理结束后1小时内。

可选

key

客户唯一标识

用户申请，由高德地图API后台自动分配

必填

无

tableid

数据表唯一标识

获取table id方法说明

必填

无

loctype

定位方式

设置是以请求中的经纬度参数（_location）还是地址参数（_address）来计算最终的坐标值。

可选值：

1：经纬度；格式示例：104.394729,31.125698

2：地址

可选

1

data

新增的数据

1. 格式：json

2. 更新规则：

1）更新字段值：只更新请求中上传的字段值，未上传的字段保留原值，且系统字段中_id,_createtime,_updatetime三个字段不能被更新。

data={"_id":"3","_location":"113.484733,37.837432"}，则本次请求仅更新_location字段值，其他字段如_name，_address等其他用户自定义字段将保持原值。

2）清空字段值：赋值null实现，仅能对用户自定义字段值进行清空操作，云图系统字段（_id,_name,_address,_location,_createtime,_updatetime)不能执行清空。

data={"_id":"3","Ctype":null}  //Ctype字段为用户的自定义字段

必填

无

_id

数据id

类型：string

必填

无

_name

数据名称

类型：string

可选

无

_location

坐标

类型：string

支持点数据

规则：经度,纬度，经纬度支持到小数点后6位

格式示例：104.394729,31.125698

可选

无

coordtype

坐标类型

类型：string

可选值：

1: gps

2: autonavi

3: baidu

您可输入coordtype=1,或者autonavi

可选

autonavi

_address

地址

类型：string

可选

无

<customfield1>

用户自定义字段1

无

<customfield…>

用户自定义字段…

无

sig

数字签名

数字签名获取和使用方法

选择数字签名认证的用户必填

无

status

返回状态

值为0或1

1：成功；

0：失败

必填

info

返回的状态信息

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明

必填

key

客户唯一标识

用户申请，由高德地图API后台自动分配

必填

无

tableid

数据表唯一标识

获取table id方法说明

必填

无

ids

删除的数据_id

一次请求限制1-50条数据，多个_id用逗号隔开

必填

无

sig

数字签名

数字签名获取和使用方法

选择数字签名认证的用户必填

无

status

返回状态

值为0或1

1：成功；

0：失败

必填

info

返回的状态信息

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明

必填

success

删除成功数目

非负整数

必填

fail

删除失败数目

非负整数

必填

key

客户唯一标识

用户申请，由高德地图API后台自动分配

必填

无

tableid

数据表唯一标识

获取table id方法说明

必填

无

batchid

批量处理任务唯一标识

必填

无

sig

数字签名

数字签名获取和使用方法

选择数字签名认证的用户必填

无

status

返回状态

值为0或1

1：成功；

0：失败

必填

info

返回的状态信息

status = 1，info返回“ok”，详细信息请参考本页最下方的错误码说明

必填

progress

处理进度

取值范围[0,100]

可选

imported

已导入的数据数目

非负整数

可选

locaccurate

定位准确数目

取值范围：非负整数

-  当loctype=1时，只要用户传入合规的经纬度，系统都将认为是准确定位。

-  当loctype=2时，当系统能够根据传入地址精确定位坐标到以下4类结果上时，系统认为是准确定位：

可选

locinaccurate

定位可能偏差数目

取值范围：非负整数

当loctype=2，即用地址进行定位时，会因为地址不够精确或系统地址库缺失，造成系统计算出的坐标可能不在用户所期望的位置，系统将此情形认为“定位可能偏差”。如，当地址为“XX省”或“XX省XX市XX区XX街道”等范围较大的区域时。

此参数主要作为提醒使用，并不影响该条数据的任何操作。

可选

locfail

定位失败数目

取值范围：非负整数

可选

0（请求失败）

info值枚举如下：

table id不存在

_id不存在

服务器维护中

参数缺失或格式非法

账号未激活或已被冻结

UNKNOWN_ERROR:code （code =  -101~-404之间，表示云图服务内部错误；code = -41，表示Key和table id不在同一高德用户账户下，无权访问）

SERVICE_NOT_EXIST （表示：请求的服务不存在）

IN VALID_USER_KEY（表示：key无效）

USER_VISIT_TOO_FREQUENTLY （表示：用户访问过于频繁，服务不响应）

NOT_SUPPORT_HTTPS （表示：不支持HTTPS请求）

INVALID_USER_IP （表示：用户IP无效）

INVALID_USER_SIGNATURE （表示：该服务响应错误）

INVALID_USER_SCode （表示：用户安全码未通过）

未知错误 （以上错误之外的未定义的错误）