服务介绍
服务文档
使用指南
常见问题
更新日志
云存储服务V4
云存储服务是一类Web API接口服务；也是LBS.云系列服务的基础；
用户可在云存储服务中存储并管理自定义的地理数据（位置点&区域面）；
用户可将云存储中管理的数据与多类地图服务打通（JS API、地图SDK等），实现自定义数据展示或解析功能。
功能介绍
稳定高性能的云端存储服务
无需部署服务器，用户可通过云存储服务，完成千万级位置数据存储。
完备的容灾机制，保障服务稳定与数据安全。
优异的服务性能，支持每秒万级并发读写。
多样化数据管理能力
支持位置点和区域面两种类型的地理数据存储管理。
通过接口功能，可对数据进行增删改查操作。
使用数据管理平台，可便捷的对数据进行可视化编辑。
地图多服务打通
用户可将云存储中管理的自定义地理数据，与JS API、地图SDK、Web API等服务
打通，实现自定义地理数据展示和解析的扩展应用。
特别注意：
1.云存储V4版和V3版使用完全不同的服务架构，存储环境也完全不同。使用V3版服务存储的数据不能通过V4版服务访问。
2.如需使用V4版服务，需使用V4版接口上传数据。同时，云存储V4版接口存储的数据，只能通过V4版数据管理平台管理（即将推出）
3.使用服务前请确认服务版本："V4"or"V3"(请求接口URL中有对应标识)
2.如需使用V4版服务，需使用V4版接口上传数据。同时，云存储V4版接口存储的数据，只能通过V4版数据管理平台管理（即将推出）
3.使用服务前请确认服务版本："V4"or"V3"(请求接口URL中有对应标识)
实体字段定义
位置数据表（geotable）实体字段定义
| 字段名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | geotable的id标识 | uint32 | geotable的唯一标识 |
| name |
位置数据表名称 |
string |
|
| user_id |
用户id |
uint64 |
|
| is_published |
是否发布到云检索；1（发布）、0（不发布） |
uint32 |
数据表创建完成后，仅允许将发布状态做正向修改（0→1），不允许做逆向修改（1→0） |
| create_time |
创建的时间 |
datetime |
|
| modify_time |
最后一次修改的时间 |
datetime |
|
自定义扩展列（column）实体字段定义
| 字段名 | 参数含义 | 类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|---|
| id |
唯一标识 | uint64 | 是 | 无 |
该id为创建列时自动生成 |
| key |
存储在geotable 的key标识，含义与“id”字段相同，该字段为用户创建时自定义设置 |
string(64) |
是 |
无 |
在同一geotable（位置数据表）内唯一正则: [a-zA-Z][0-9a-zA-Z_]* |
| name |
对key的描述（数据管理平台中，列名对应该字段） |
string(128) |
否 |
无 |
|
| type |
字段类型 1、2、3、4 |
int32 | 是 | 无 | 1:Int64 2:double 3:string 4:在线图片url（LBS图片存储） |
| is_search_field |
是否设置为云检索的排序筛选or检索字段； 1代表是,0代表否 |
uint32 |
是 |
|
设置后在云检索服务中可根据该字段的内容检索或排序筛选 若字段为int类型，则为排序筛选字段（做多设置15个）； |
| is_index_field |
是否将字段设置为云存储的索引字段； 1代表是，0代表否。 |
uint32 |
否 |
|
设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配）。最多设置3个。 |
| create_time |
创建时间 |
uint32 |
是 |
|
Unix时间戳 |
| modify_time |
修改时间 |
uint32 |
是 |
|
Unix时间戳 |
位置数据（poi）实体字段定义
| 字段名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id |
id | uint64 | 为唯一标识 |
| title |
名称 |
string(256) |
|
| tags |
分类标签 |
string(256) |
参见：POI行业分类 多个tag以空格分隔 |
| location |
坐标 |
array |
格式为：[经度,纬度]或[墨卡托坐标] |
| polygons |
多边形边界坐标点 |
string |
格式为：经度,纬度;经度,纬度;经度,纬度 单个多边形最多创建400个边界点，最大字符长度为10240。 |
| coord_type |
坐标类型 |
uint32 |
1（GPS经纬度坐标） 2（国测局加密经纬度坐标） 3（百度加密经纬度坐标，默认） 4（百度加密墨卡托坐标） |
| province |
省 |
string(32) |
|
| city |
市 |
string(32) |
|
| district |
区 |
string(64) |
|
| address |
地址 |
string(256) |
|
| geotable_id |
所属geotable id |
uint32 |
|
| create_time |
创建时间 |
uint32 |
Unix时间戳 |
| modify_time |
最后一次修改的时间 |
uint32 |
Unix时间戳 |
位置数据表（geotable）管理
创建表（create geotable）接口
http://api.map.baidu.com/geodata/v4/geotable/create //云存储V4除批量上传接口服务外，其余接口均支持POST和GET请求，后文不再赘述
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| name |
geotable的中文名称 |
string(45) |
必选 |
| is_published |
是否发布到检索 |
int32 |
必选 0：未自动发布到云检索， 1：自动发布到云检索； 注： 1）通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。 2）可通过数据管理平台设置，在表属性设置中将是否发送到检索一栏中选定为是即可。 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
| sn |
用户的权限签名 |
string(50) |
可选,若用户所用AK的校验方式为SN校验时该参数必须（SN生成算法） 若AK设置为SN校验，所有云存储接口均需拼写SN参数，为节省篇幅，后续接口不再单独说明。 |
返回参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 |
| id |
新增的数据表id |
string |
即geotable_id |
请求示例（截图来自chrome浏览器插件："POSTMAN"工具，下同）
返回结果示例
查询表（list geotable）接口
http://api.map.baidu.com/geodata/v4/geotable/list
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| name |
geotable的名称 |
string(45) |
可选。若未传该参数，则检索ak管理的所有的位置数据表（geotable） |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |
| size |
数据表个数 |
int32 |
| |
| geotables |
id |
geotable的id |
string |
|
| name |
geotable的名称 |
string |
| |
| is_published |
是否发布到云检索 |
int32 |
| |
| create_time |
创建时间 |
string |
| |
| modify_time |
修改时间 |
string |
| |
请求示例
返回结果示例
查询指定id表（detail geotable）接口
http://api.map.baidu.com/geodata/v4/geotable/detail
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
指定geotable的id |
int32 |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |
| geotables |
id |
geotable的id |
string |
|
| name |
geotable的名称 |
string |
| |
| is_published |
是否发布到云检索 |
int32 |
| |
| create_time |
创建时间 |
string |
| |
| modify_time |
修改时间 |
string |
| |
请求示例
返回结果示例
修改表（update geotable）接口
http://api.map.baidu.com/geodata/v4/geotable/update
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
指定geotable的id |
int32 |
必选 |
| is_published |
【云检索相关】 是否发布到云检索; "1"发布，"0"不发布 |
int32 |
可选 当数据表中有数据时，不允许该字段"1"→"0"，支持"0"→"1"（会触发批量操作，可通过job list接口查询进度） |
| name |
geotable的名称 |
string(45) |
可选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |
| id |
批量任务job_id |
int32 |
如果有批量任务（如修改数据表发布状态），会返回该id，便于查询任务状态 | |
请求示例
返回结果示例
删除表（delete geotable）接口
http://api.map.baidu.com/geodata/v4/geotable/delete
注意：当geotable里面没有位置数据时，才能删除geotable
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
指定geotable的id |
int32 |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |
请求示例
返回结果示例
数据列（column）管理
创建列（create column）接口
http://api.map.baidu.com/geodata/v4/column/create
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| name |
column的名称描述 |
string(45) |
必选 |
| key |
column存储的key标识，含义与返回结果中的列“id”字段相同，该字段为用户创建时自定义设置 |
string(45) |
必选 同一个geotable内的名字不能相同 |
| type |
存储的值的类型 |
uint32 |
必选 枚举值1：Int64, 2：double, 3：string, 4：在线图片url |
| is_search_field |
【云检索相关】 是否设置为云检索的排序筛选or检索字段； 1代表是，0代表否 |
uint32 |
必选 设置后在云检索服务中可根据该字段的内容检索或排序筛选。 若字段为int/double类型，则为排序筛选字段，最多设置15个； 若字段为string类型，则为检索字段，最多设置4个，单字段不超过512字节。 |
| is_index_field |
【云存储相关】 是否将字段设置为云存储的索引字段； 1代表是，0代表否。 |
uint32 |
必选 设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配，不区分int or string）。最多设置3个。 |
| geotable_id |
指定geotable的id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |
| id |
column的id |
uint32 |
自动生成，和请求中"key"含义相同 | |
请求示例
返回结果示例
查询列（list column）接口
http://api.map.baidu.com/geodata/v4/column/list
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| name |
geotable数据列中对key的描述内容 |
string(45) |
可选 |
| key |
geotable数据列的key标识 |
string(45) |
可选 |
| geotable_id |
指定geotable的id |
string(50) |
必选 若只传该字段，则检索该数据表中所有"列"信息 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| size |
返回数据条数 |
uint32 |
| |||
| columns |
id |
column的id |
string |
| ||
| geotable_id |
所属于的geotable_id |
string |
| |||
| name |
列的key描述字段 |
string |
| |||
| key |
列的标识字段 |
string |
| |||
| type |
存储的值的类型 |
uint32 |
| |||
| create_time |
列的创建时间 |
uint32 |
| |||
| modify_time |
列的修改时间 |
uint32 |
| |||
| is_search_field |
是否为云检索端检索或排序筛选字段 |
uint32 |
| |||
| is_index_field |
是否为云存储索引字段 |
uint32 |
| |||
请求示例
返回结果示例
查询指定id列（detail column）接口
http://api.map.baidu.com/geodata/v4/column/detail
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
column的id |
uint32 |
必选 |
| geotable_id |
数据表的id |
uint32 |
必选 |
| ak |
用户的访问权限key |
string |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| columns |
id |
column的id |
string |
| ||
| geotable_id |
所属于的geotable_id |
string |
| |||
| name |
列的key描述字段 |
string |
| |||
| key |
列的标识字段 |
string |
| |||
| type |
存储的值的类型 |
uint32 |
| |||
| create_time |
列的创建时间 |
uint32 |
| |||
| modify_time |
列的修改时间 |
uint32 |
| |||
| is_search_field |
是否为云检索端检索或排序筛选字段 |
uint32 |
| |||
| is_index_field |
是否为云存储索引字段 |
uint32 |
| |||
请求示例
返回结果示例
修改指定条件列（update column）接口
http://api.map.baidu.com/geodata/v4/column/update
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
column的id |
uint32 |
必选 |
| geotable_id |
数据表的id |
uint32 |
必选 |
| name |
geotable数据列中对key的描述内容 |
string(45) |
可选 前缀匹配 |
| is_search_field |
是否设置为云检索的排序筛选or检索字段； 1代表是，0代表否 |
uint32 |
可选 如果数据表中已经有数据，不允许修改此字段。 设置后在云检索服务中可根据该字段的内容检索或排序筛选。 若字段为int/double类型，则为排序筛选字段，最多设置15个； 若字段为string类型，则为检索字段，最多设置4个，单字段不超过512字节。 |
| is_index_field |
是否为云存储的索引字段； 1代表是，0代表否 |
uint32 |
可选 如果数据表中已经有数据，不允许修改此字段。 设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配，不区分int or string）。 最多设置3个。 |
| ak |
用户的访问权限key |
string |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
请求示例
返回结果示例
删除指定条件列（delete column）接口
http://api.map.baidu.com/geodata/v4/column/delete
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
column的id |
uint32 |
必选 |
| geotable_id |
数据表的id |
uint32 |
必选 |
| ak |
用户的访问权限key |
string |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
请求示例
返回结果示例
位置数据（poi）管理
创建数据（create poi）接口
http://api.map.baidu.com/geodata/v4/poi/create
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| title |
位置数据名称 |
string(256) |
可选。最多128个utf-8字符 |
| address |
位置数据地址 |
string(256) |
可选。最多128个utf-8字符 |
| tags |
位置数据类别 |
string(256) |
可选。最多200个tag，每个tag最长32个字符。 |
| latitude |
用户上传的纬度 |
double |
必选。非百度墨卡托坐标时，取值为[-90,90] |
| longitude |
用户上传的经度 |
double |
必选。非百度墨卡托坐标时，取值为[-180,180] |
| polygons |
多边形边界点坐标数据 |
double |
可选 若该字段传入数据，则判定为面状位置数据。 格式为：经度,纬度;经度,纬度;经度,纬度 单个多边形最多创建400个边界点，最大字符长度为10240。 |
| coord_type |
用户上传的坐标的类型：1、2、3、4 |
uint32 |
必选 1：GPS经纬度坐标 2：国测局加密经纬度坐标 3：百度加密经纬度坐标 4：百度加密墨卡托坐标 |
| geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
| {column key} |
用户在column定义的key/value对 |
用户自定义的类型（string、int、double） |
唯一索引字段必选，且需要保证唯一，否则会创建失败。最大长度2048字节。 |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| id |
新增的位置数据id |
string |
| |||
请求示例
返回结果示例
查询指定条件的数据（poi）列表接口
http://api.map.baidu.com/geodata/v4/poi/list
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| {index key} |
用户在column定义的key/value对 |
用户自定义的类型（string、int、double） |
可选。column需要设置了is_index_field=1。对于string，是前缀匹配，如需精确匹配请在字段值末尾加$。对于int或者double，则是范围查找，传递的格式为最小值,最大值。当无最小值或者最大值时，用-代替，同时，此字段最大长度不超过50，最小值与最大值都是整数 例：如加入一个命名为color数据类型为string的column，在检索是可设置为“color=red”的形式来检索color字段为red的POI。 如加入一个命名为number数据类型为int的column，在检索是可设置为“number=20,-”的形式来检索number字段值大于等于20的POI。 |
| title |
位置数据名称 |
string(256) |
可选。最多128个utf-8字符 |
| tags |
位置数据类别 |
string(256) |
可选。最多200个tag，每个tag最长32个字符，多个tag空格间隔。 |
| bounds | 查询的矩形区域 | string(100) | 可选。格式x1,y1;x2,y2分别代表矩形的左上角和右下角。 范围过大时服务易超时，返回数据为空。 建议经度跨度小于0.8，纬度跨度小于0.5。 |
| coord_type |
用户上传的坐标的类型：1、2、3、4 | uint32 | 必选 1：GPS经纬度坐标 2：国测局加密经纬度坐标 3：百度加密经纬度坐标 4：百度加密墨卡托坐标 |
| page_index | 分页索引 | uint32 | 可选。默认为0 |
| page_size |
分页数目 |
uint32 |
可选。默认为10，上限为200 |
| start_date |
创建日期 |
string(50) |
可选。格式：2017-06-01 |
| end_date |
修改日期 |
string(50) |
可选。格式：2017-06-01 |
| geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| size |
单页返回的数据条数 |
uint32 |
| |||
| pois |
poi结果列表 |
array |
| |||
| id |
新增的位置数据id |
string |
| |||
| geotable_id |
所属数据表id |
string |
| |||
| title |
poi名称 |
string |
| |||
| location |
百度系坐标 |
float | 格式为：[经度,纬度] | |||
| gcj_location |
国测局坐标 |
float |
格式为：[经度,纬度] | |||
| polygons |
边界点坐标 |
float |
格式为：[经度,纬度]。若该字段为空时不召回。 | |||
| address |
地址 |
string |
若该字段为空时不召回。 | |||
| tags |
标签 |
string |
| |||
| create_time |
用户创建日期 |
string |
| |||
| modify_time |
用户修改时间 |
string |
| |||
| province |
所在的省份 |
string |
| |||
| city |
所在的城市 |
string |
| |||
| district |
所在的区 |
string |
| |||
| {column key} |
用户在column定义的key/value对 |
用户自定义的类别 |
| |||
请求示例
返回结果示例
查询指定id的数据（poi）列表接口
http://api.map.baidu.com/geodata/v4/poi/detail
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
位置数据对应的id |
uint64 |
必选 |
| geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| poi |
poi结果列表 |
dict |
| |||
| id |
位置数据id |
string |
| |||
| geotable_id |
所属数据表id |
string |
| |||
| title |
位置数据名称 |
string |
| |||
| location |
百度系坐标 |
float | 格式为：[经度,纬度] | |||
| gcj_location |
国测局坐标 |
float |
格式为：[经度,纬度] | |||
| polygons |
边界点坐标 |
float |
格式为：[经度,纬度]。若该字段为空时不召回。 | |||
| address |
地址 |
string |
若该字段为空时不召回。 | |||
| tags |
标签 |
string |
| |||
| create_time |
用户创建日期 |
string |
| |||
| modify_time |
用户修改时间 |
string |
| |||
| province |
所在的省份 |
string |
| |||
| city |
所在的城市 |
string |
| |||
| district |
所在的区 |
string |
| |||
| {column key} |
用户在column定义的key/value对 |
用户自定义的类别 |
| |||
请求示例
返回结果示例
修改数据（update poi）列表接口
http://api.map.baidu.com/geodata/v4/poi/update
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
位置数据对应的id |
uint64 |
必选 |
| title |
位置数据名称 |
string(256) |
可选 |
| address |
地址 |
string(256) |
可选 |
| tags |
数据类别 |
string(256) |
可选 多个tag空格间隔 |
| latitude |
用户上传的纬度 |
double |
可选 |
| longitude |
用户上传的经度 |
double |
可选 |
| coord_type |
用户上传的坐标的类型 |
uint32 |
可选。默认3 1．GPS经纬度坐标 2．测局加密经纬度坐标 3．百度加密经纬度坐标 4．百度加密墨卡托坐标 |
| geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
| {column key} |
用户在column定义的key/value对 |
用户自定义的列类别 |
|
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
请求示例
返回结果示例
删除数据（delete poi）列表接口
http://api.map.baidu.com/geodata/v4/poi/delete
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
被删除的位置数据id |
uint64 |
可选。 如果设置了这个参数，其余删除条件会被忽略，只会根据id删除单条poi。此时此操作不是批量请求。 除该字段外，该接口其他字段均会触发批量任务，任务状态请通过job list接口查看 |
| ids |
id列表 |
以,分隔的id |
可选。最多1000个id，如果设置了批量删除is_total_del = 1并且没有设置id字段，则优先根据ids删除多条poi, 其它条件将被忽略. |
| {index key} |
用户在column定义的key/value对 |
用户自定义的列类别 |
可选。column需要设置了is_index_field=1。 字段类型为string，是精确匹配【例：price=high】； 字段类型为int或者double，是范围查找，传递的格式为：最小值,最大值。当无最小值或者最大值时，用-代替，同时，此字段最大长度不超过50，最小值与最大值都是整数【例：price=50,-】。 |
| title |
位置数据名称 |
string(256) |
可选。精确匹配 |
| tags |
数据类别 |
string(256) |
可选。精确匹配 |
| geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
| is_total_del |
标记为批量删除 |
int32 |
可选。 如需删除一条以上数据，在设定数据范围的条件时，还需要将该字段设为1。 注意：若仅设为1，而不设定数据范围的条件（如不指定ids、tag等），则默认为删除全表数据 |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| id |
批量任务的job id |
int |
如为批量删除，会返回该字段。job id可通过job list接口查看任务状态 | |||
请求示例
返回结果示例
批量上传数据（upload poi）列表接口
http://api.map.baidu.com/geodata/v4/poi/upload //仅支持POST接口
请求参数-接口
| 参数名 | 参数含义 | 类型 | 备注 |
| poi_list |
输入的位置数据文件内容 |
file |
必选。单次上传的数据表小于1000条数据。文件大小不超过1M。请使用GBK编码。 |
| geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
导入文件（poi_list对应的文件）的csv格式（自定义字段需与默认字段间隔一个空列）：
数据列（必选字段）-上传文件
| 参数名 | 参数含义 | 类型 | 备注 |
| title |
poi名称 |
string(45) |
必选 |
| latitude |
用户上传的纬度 |
double |
必选 |
| longitude |
用户上传的经度 |
double |
必选 |
| coord_type |
用户上传的坐标的类型 |
uint32 |
必选 1.GPS经纬度坐标 2.国测局加密经纬度坐标 3.百度加密经纬度坐标 4.百度加密墨卡托坐标 |
| {column key} |
用户在column定义的key/value对 |
用户自定义的类别 |
可选。 文件中，自定义字段需与前几个默认字段间隔一个空列。 |
| geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| id |
导入文件的job id |
string |
使用job list接口，可查看文件上传状态 | |||
请求示例
返回结果示例
批量操作任务（JOB）查询进度接口
批量操作任务查询（list job）接口
http://api.map.baidu.com/geodata/v4/job/list
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
| id |
批量任务的job id |
int32 |
必选。单次上传的数据表小于1000条数据 |
| page_size |
分页大小（单页召回的数据量） |
int32 |
可选。默认10，上限200 |
| page_index |
翻页 |
int32 |
可选。0为第一页 |
| geotable_id |
删除数据所在的数据表id |
string(50) |
可选。若未传geotable_id，则查询该ak账号下所有批量任务 |
| ak |
用户的访问权限key |
string(50) |
必选 申请ak |
返回参数（json格式）
| 参数名 |
参数含义 | 类型 | 备注 | |||
| status |
状态码 |
int32 |
0代表成功，其它取值见文档最后状态码说明 | |||
| message |
响应的信息 |
string(50) |
状态码描述，成功时返回“OK”，失败返回对应信息 | |||
| jobs |
job结果列表 |
array |
| |||
| id |
批量任务job id |
string |
| |||
| create_time |
用户创建日期 |
string |
| |||
| modify_time |
用户修改日期 |
string |
| |||
| type |
任务类型 |
string |
sync（发布至云检索）/delete（删除）/uplode（发布至云存储） | |||
| uplode_num |
导入成功的位置数据数量 |
uint32 |
| |||
| delete_num |
删除位置数据的数量 |
uint32 |
| |||
| status |
查询任务的状态 |
int32 |
0（成功）；1（运行）；2（失败） 注意与状态码“status”区分 | |||
请求示例
返回结果示例
状态码定义表
| 状态码 | 含义 | 备注 |
| 0 | 成功 | |
| 1 | 这是批量任务, 可通过job接口查询任务状态 |
|
| 11 | 未知错误 |
|
| 20 |
geotable不存在 |
|
| 21 |
geotable的数量达到上限 |
|
| 22 |
column的数量达到上限 |
|
| 23 |
is_search_field数量达到上限 |
|
| 24 |
is_index_field数量达到上限 |
|
| 25 |
geotable的name重复 |
|
| 26 |
column的key重复 |
|
| 27 |
bounds超过最大范围 |
|
| 28 |
此操作需要表中没有任何poi数据 |
|
| 30 |
参数错误|过滤条件有错误|坐标转换失败|content-type错误|http的method错误|http的头部错误 |
|
| 31 |
name: 参数不存在 key: 参数不存在 id: 参数不存在 type: 参数不存在 geotable_id: 参数不存在 longitude/latitude: 参数不存在|coord_type: 参数不存在 poi_list: 参数不存在 type: URL不能作为检索/索引字段 |
|
| 302 |
天配额超限，限制访问。配额超限，对此错误码不需要重试消耗配额和并发资源，如果想增加配额请联系我们 |
|
| 401 |
当前并发量已经超过约定并发配额，限制访问。并发控制超限，对此错误码不需要重试消耗配额和并发资源，请控制并发量或联系我们 |
|
使用方法
1申请百度账号
百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 点此申请
2申请成为百度开发者
登录百度账号后，请申请百度地图开放平台开发者，即可开始使用相关服务。 点此申请
3获取服务密钥（ak）
发送服务请求，需使用ak参数进行鉴权（必须）。发送服务请求前需先创建ak。 点此创建
4使用云存储服务，创建位置数据表
使用云地理编码解析自定义地理数据，首先需使用云存储服务，创建位置数据表，编辑自定义地址数据。创建数据表成功，获取位置数据表id（geotable_id）
5拼写请求URL，使用云存储相关服务
拼写请求URL，使用geotable_id，使用云存储相关接口服务。
编码说明
API请求中需要用到中文或一些特殊字符的参数，如query、region等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成UTF-8字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。
| 字符集合 | 字符 |
| URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
| URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。
附注：
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
坐标系说明
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
云存储V4服务默认输入输出坐标类型为百度坐标（BD09），同时可通过参数（"coord_type","ret_coordtype"）控制输入输出坐标类型。输入坐标支持以上三种坐标系，输出坐标支持-国测局坐标（GCJ02）和百度坐标（BD09）
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
服务使用限制
服务相关配额及并发请求限制请访问开发者权益页面查看。
服务常见问题
1、之前有通过云存储服务存储数据，为什么现在查询不到了？
在排除未进行过删除数据操作的前提下，请查看云存储服务的使用版本（请求中有明确标识）。
云存储V4版服务于2017年7月31日发布，之前使用的云存储服务为V3及以下版本。
V4版服务与之前版本服务数据不相通，使用历史版本云存储存储的数据，无法通过V4版云存储相关接口查询，反之亦然。
若有使用云存储V4版服务需求，请对历史版本服务数据进行迁移。若数据量过于庞大，可联系我们协助操作。
2、我存储在云存储服务中的数据，会被其他用户访问吗？
稳定性和数据安全是云存储服务的最基本要求。
所有存储在云存储服务中的数据都以数据表为单位进行独立存储，以保障数据安全，不被他人窃取。
每次对数据进行管理操作，均需同时传入数据表ID（geotabel id）和服务访问密钥（AK）进行融合鉴权。其他用户无权访问，请放心使用。
2013年7月25日
V2.0
2013年10月24日
V2.1
2013年11月7日
V2.2
2013年12月12日
V2.3
2014年1月20日
V3.0
2017年7月31日
V4.0
新增功能
PC、Android、iOS端的LBS.云DEMO。
服务优化
简化数据结构：将Databox、Databox_meta、POI、POI_EXT等参数修改为：geotable（表）、column（列）、POI（记录），建立更符合数据库概念的数据管理方式。
优化与更新批量操作：提高数据管理能力，在存储引擎提供一定能力的空间索引和文本索引，支持按条件批量的更新和删除操作，方便数据管理阶段的数据维护。
大幅度提升存储性能：支持单geotable亿数量级存储，每天百万次的读写操作，每秒千次的并发读写操作。
支持国外数据的存储，但不进行检索建库。
优化与更新批量操作：提高数据管理能力，在存储引擎提供一定能力的空间索引和文本索引，支持按条件批量的更新和删除操作，方便数据管理阶段的数据维护。
大幅度提升存储性能：支持单geotable亿数量级存储，每天百万次的读写操作，每秒千次的并发读写操作。
支持国外数据的存储，但不进行检索建库。
新增功能
修改：Location备注内容。
新增coord_type字段。
新增coord_type字段。
新增功能
支持唯一索引字段 ，对应字段名“is-unique-field”；更方便更新、删除以及查询。
优化批量上传接口，增加查看进度接口。
产品上线
LBS.云存储：在原有支持int、double和string类型数据存储基础上添加图片存储功能（需发送邮件申请）。
LBS.云检索：支持对属性值为离散数值类型的POI的筛选。
文档修改：
LBS.云检索：支持对属性值为离散数值类型的POI的筛选。
文档修改：
支持对属性值为离散数值类型的POI的筛选。
用户有自定义权限的字段进一步详细说明如何定义以及定义后效果。
有些参数的使用方法开发者不太清楚，给出详细的url 举例。
注：与LBS.云V2.0相比，LBS.云V3.0新增功能汇总如下：
支持对属性值为离散数值类型的POI的筛选。
在原有支持int、double和string类型数据存储基础上添加图片存储功能。
添加唯一索引扩展字段存储功能。
优化批量上传接口，增加查看进度接口。
支持将检索结果按多字段进行排序的功能。
支持唯一索引字段 。
产品上线
新增面数据管理功能。用户可通过服务存储并管理面状位置数据。
优化接口类型。对不常用或易用性较差的接口做部分删减或融合。接口整体更加精简。
优化服务架构，服务性能大幅提升。
新增容灾机制，数据安全保障能力大幅提升。
优化接口类型。对不常用或易用性较差的接口做部分删减或融合。接口整体更加精简。
优化服务架构，服务性能大幅提升。
新增容灾机制，数据安全保障能力大幅提升。