浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

LBS.云服务

LBS.云是百度地图针对LBS开发者推出的平台级服务,结合已有的地图API和SDK服务,通过开放服务端存储和计算能力,提供海量位置数据(点、面数据)的实时存储、检索、展示一体化解决方案。

服务介绍
服务文档
使用指南
常见问题
更新日志
云存储服务V4

云存储服务是一类Web API接口服务;也是LBS.云系列服务的基础;
用户可在云存储服务中存储并管理自定义的地理数据(位置点&区域面);
用户可将云存储中管理的数据与多类地图服务打通(JS API、地图SDK等),实现自定义数据展示或解析功能。

功能介绍
稳定高性能的云端存储服务

无需部署服务器,用户可通过云存储服务,完成千万级位置数据存储。
完备的容灾机制,保障服务稳定与数据安全。
优异的服务性能,支持每秒万级并发读写。

geodata1.png

多样化数据管理能力

支持位置点和区域面两种类型的地理数据存储管理。
通过接口功能,可对数据进行增删改查操作。
使用数据管理平台,可便捷的对数据进行可视化编辑。

geodata2.png

地图多服务打通

用户可将云存储中管理的自定义地理数据,与JS API、地图SDK、Web API等服务
打通,实现自定义地理数据展示和解析的扩展应用。

geodata3.png


特别注意:
1.云存储V4版和V3版使用完全不同的服务架构,存储环境也完全不同。使用V3版服务存储的数据不能通过V4版服务访问。
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个);
若字段为string类型,则为检索字段(最多设置4个)

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"工具,下同)
%E5%88%9B%E5%BB%BA%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E5%88%9B%E5%BB%BA%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
查询表(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


请求示例
%E6%9F%A5%E8%AF%A2%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
查询指定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


请求示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E8%A1%A8-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E8%A1%A8-%E7%BB%93%E6%9E%9C.png

修改表(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,便于查询任务状态

请求示例
%E4%BF%AE%E6%94%B9%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E4%BF%AE%E6%94%B9%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

删除表(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”,失败返回对应信息

请求示例
%E5%88%A0%E9%99%A4%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E5%88%A0%E9%99%A4%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
数据列(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个。
ak
用户的访问权限key
string(50)
必选  申请ak
返回参数(json格式)
参数名
参数含义 类型 备注
status
状态码
int32
0代表成功,其它取值见文档最后状态码说明            
message
响应的信息
string(50)
状态码描述,成功时返回“OK”,失败返回对应信息
id
column的id
uint32
自动生成,和请求中"key"含义相同

请求示例
%E5%88%9B%E5%BB%BA%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E5%88%9B%E5%BB%BA%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
查询列(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


请求示例
%E6%9F%A5%E8%AF%A2%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
查询指定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


请求示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
修改指定条件列(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”,失败返回对应信息

请求示例
column_update_request.png
返回结果示例
%E4%BF%AE%E6%94%B9%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
删除指定条件列(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”,失败返回对应信息

请求示例
%E5%88%A0%E9%99%A4%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E5%88%A0%E9%99%A4%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
位置数据(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


请求示例
%E5%88%9B%E5%BB%BA%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E5%88%9B%E5%BB%BA%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

查询指定条件的数据(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对
用户自定义的类类别


请求示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

查询指定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对
用户自定义的类类别


请求示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E7%9A%84POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E7%9A%84POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

修改数据(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”,失败返回对应信息

请求示例
%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%821.png
返回结果示例
%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

删除数据(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
string
如为批量删除,会返回该字段。job id可通过job list接口查看任务状态

请求示例
%E5%88%A0%E9%99%A4POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

批量上传数据(upload poi)列表接口
http://api.map.baidu.com/geodata/v4/poi/upload  //仅支持POST接口
注意:该接口每日限调用100次。批量上传视数据量大小,完整上传耗时不同。若对数据的实时性要求较高,建议通过“创建数据(create poi)接口”实现。
请求参数-接口
参数名 参数含义 类型 备注
poi_list
输入的位置数据列表名称
file
必选。单次上传的数据表小于1000条数据。文件大小不超过1M。请使用GBK编码。
geotable_id
删除数据所在的数据表id
string(50)
必选
ak
用户的访问权限key
string(50)
必选  申请ak

导入文件(poi_list对应的文件)的csv格式(自定义字段需与默认字段间隔一个空列):
%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%A0%BC%E5%BC%8F.jpeg

数据列(必选字段)-上传文件

参数名 参数含义 类型 备注
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接口,可查看文件上传状态

请求示例
%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png

批量操作任务(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”区分

请求示例
%E6%89%B9%E9%87%8F%E6%93%8D%E4%BD%9C%E4%BB%BB%E5%8A%A1%E6%9F%A5%E8%AF%A2%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png
返回结果示例
%E6%89%B9%E9%87%8F%E6%93%8D%E4%BD%9C%E4%BB%BB%E5%8A%A1%E6%9F%A5%E8%AF%A2%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png
状态码定义表
状态码 含义 备注
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)

注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

服务配额

每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数(即配额)是有限的。

每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数(即并发量)是有限的。

若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。


配额及默认并发量说明如下

分类 未认证 个人认证 企业认证
日配额(次) 100,000 300,000 3,000,000
分钟并发数(次/分钟) 6,000 12,000 30,000
服务常见问题
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亿数量级存储,每天百万次的读写操作,每秒千次的并发读写操作。
支持国外数据的存储,但不进行检索建库。
新增功能
修改:Location备注内容。
新增coord_type字段。
新增功能
支持唯一索引字段 ,对应字段名“is-unique-field”;更方便更新、删除以及查询。

优化批量上传接口,增加查看进度接口。

产品上线
LBS.云存储:在原有支持int、double和string类型数据存储基础上添加图片存储功能(需发送邮件申请)。
LBS.云检索:支持对属性值为离散数值类型的POI的筛选。
文档修改:

支持对属性值为离散数值类型的POI的筛选。
用户有自定义权限的字段进一步详细说明如何定义以及定义后效果。
有些参数的使用方法开发者不太清楚,给出详细的url 举例。
注:与LBS.云V2.0相比,LBS.云V3.0新增功能汇总如下:

支持对属性值为离散数值类型的POI的筛选。
在原有支持int、double和string类型数据存储基础上添加图片存储功能。
添加唯一索引扩展字段存储功能。
优化批量上传接口,增加查看进度接口。
支持将检索结果按多字段进行排序的功能。
支持唯一索引字段 。

产品上线
新增面数据管理功能。用户可通过服务存储并管理面状位置数据。
优化接口类型。对不常用或易用性较差的接口做部分删减或融合。接口整体更加精简。
优化服务架构,服务性能大幅提升。
新增容灾机制,数据安全保障能力大幅提升。