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

LBS.云服务

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

服务介绍

云存储V4版服务在原有“点数据”存储服务基础上,增加了对“面数据”存储管理的功能。 同时,针对存储服务的性能与“容灾”能力也进行了大幅提升。

特别注意:
云存储V4版和V3版使用完全不同的服务架构,存储环境也完全不同。使用V3版服务存储的数据不能通过V4版服务访问。如需使用V4版服务,需使用V4版接口上传数据。
同时,云存储V4版接口存储的数据,只能通过V4版数据管理平台管理(即将推出)

使用服务前请确认服务版本:"V4"or"V3"(请求接口URL中有对应标识)

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。


GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。


BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标


云存储 API默认输入坐标类型为百度坐标(BD09),同时可通过参数("coord_type")控制输入坐标类型,输入坐标支持以上三种坐标系。

云存储 API同时返回百度坐标(BD09)和国测局坐标(GCJ02)两类坐标点数据。


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

云存储字段定义方式

使用说明

1.请先了解名词意义: “位置数据表(geotable)”、 “自定义扩展列(column)”、“位置数据(poi)”概念的意义,更有助于开发。

2.云存储接口功能:支持单个geotable亿级数据及数百G大小的存储,每天支持百万量级读写,每秒支持万量级读写。

3.批量操作说明:

V2版本,引入“批量操作”概念。通过批量操作接口操作,您可实现对一个位置数据表(geotable)进行如下操作:

批量上传多条数据;

批量删除多条数据;

批量删除1个或者多个自定义扩展列(column);

批量更新数据(如字段、字段属性、字段对应的值等)等操作

4.云存储已全面支持http/https两种请求形式。后文介绍中以http请求为例。


“批量操作”接口原理及使用说明如下:

“批量操作”接口是采用异步服务形式,您可使用此接口对一个位置数据表(geotable)同时执行各种批量操作,服务将在并发数范围内同时处理多个请求任务,超出并发数的请求任务将以消息队列形式进入处理等待状态。
当您使用批量操作接口时,服务将先发送批量操作请求,若请求成功,系统将锁定对应的位置数据表(geotable),即用户可对此表进行可读操作,不能进行任何写操作,直到此次批量操作任务完成(即任务进度状态码Status = 3 完成时)自动解锁,恢复可写。同时,系统会返回状态码Status =21和此操作(Job id),Status值用于标识您的操作为批量操作, Job id用于查询此批量操作的任务进度。(Status = 0 表示非批量操作的普通操作)。

查询某个批量操作任务进度,即根据上述返回的Job id,使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值(1、2、3)确认批量操作的进度(新增操作,消息队列中等待处理;正在处理;完成)。


编码说明:

API请求中需要用到中文或一些特殊字符的参数,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成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保留字字符的字面意思,例如,检索关键字包含一个问号,此问号也必须进行编码。

附注:

(1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

(2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

(3) C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

(4) php中可以使用函数urlencode对特殊字符进行编码。

位置数据表(geotable)实体字段定义

字段名 含义 类型 备注
id id uint32 即geotable_id,为唯一标识
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 字段类型 int32 1:Int64, 2:double, 3:string, 4:在线图片url,LBS图片存储
is_search_field 是否设置为云检索的排序筛选or检索字段;
1代表是,0代表否
uint32 设置后在云检索服务中可根据该字段的内容检索或排序筛选

若字段为int类型,则为排序筛选字段;
若字段为string类型,则为检索字段

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)接口

请求url

http://api.map.baidu.com/geodata/v4/geotable/create 

云存储服务除批量上传外,所有接口post请求和get请求均支持,后文不再赘述

请求参数

参数名 参数含义 类型 备注
name geotable的中文名称 string(45) 必选
is_published 是否发布到检索 int32 必选
0:未自动发布到云检索,
1:自动发布到云检索;
注:1)通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。
2)可通过数据管理模块设置,在设置中将是否发送到检索一栏中选定为是即可。
ak 用户的访问权限key string(50) 必选
sn 用户的权限签名 string(50) 可选,若用户所用AK的校验方式为SN校验时该参数必须(SN生成算法

若AK设置为SN校验,所有云存储接口均需拼写SN参数,为节省篇幅,后续接口不再单独说明


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值见文档最后状态码说明
message 响应的信息 string(50) 状态码描述
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)接口

请求url

http://api.map.baidu.com/geodata/v4/geotable/list


请求参数

参数名 参数含义 类型 备注
name geotable的名字 string(45) 可选
ak 用户的访问权限key string(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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)接口

请求url

http://api.map.baidu.com/geodata/v4/geotable/detail


请求参数

参数名 参数含义 类型 备注
id 指定geotable的id int32 必选
ak 用户的访问权限key string(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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)接口

请求url

http://api.map.baidu.com/geodata/v4/geotable/update


请求参数

参数名 参数含义 类型 备注
id geotable主键 uint32 必选
is_published 是否发布到检索;
"1"发布,"0"不发布
int32 当数据表中有数据时,不允许该字段"1"→"0",支持"0"→"1"(会触发批量操作,可通过joblist接口查询进度)
name geotable的中文名称 string(45) 可选
ak 用户的访问权限key string(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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

删除表(geotable)接口

请求url

http://api.map.baidu.com/geodata/v4/geotable/delete

注意:当geotable里面没有位置数据时,才能删除geotable

请求参数

参数名 参数含义 类型 备注
id 位置数据表id,即geotable_id uint32 必选
ak 用户的访问权限key string(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述


请求示例

%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)接口

请求url

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) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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)接口

请求url

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 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
size 返回数据条数 uint32
columns id 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)详情接口

请求url

http://api.map.baidu.com/geodata/v4/column/detail

请求参数

参数名 参数含义 类型 备注
id 列的id uint32 必选
geotable_id 表的id uint32 必选
ak 用户的访问权限key string 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
column id 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

修改指定条件列(column)接口

请求url

http://api.map.baidu.com/geodata/v4/column/update


请求参数

参数名 参数含义 类型 备注
id 列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(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述


请求示例

%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-%E8%AF%B7%E6%B1%82.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

删除指定条件列(column)接口

请求url

http://api.map.baidu.com/geodata/v4/column/delete


请求参数

参数名 参数含义 类型 备注
id 列的id int32 必选
geotable_id 表的id int32 必选
ak 用户的访问权限key string(50) 必选

响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述


请求示例

%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)接口

请求url

http://api.map.baidu.com/geodata/v4/poi/create

请求参数

参数名 参数含义 类型 备注
title poi名称 string(256) 可选,最多128个utf-8字符
address 地址 string(256) 可选,最多128个utf-8字符
tags 类别 string(256) 可选,最多200个tag,每个tag最长32个字符。
latitude 用户上传的纬度,非百度墨卡托坐标时,取值为[-90,90] double 必选
longitude 用户上传的经度,非百度墨卡托坐标时,取值为[-180,180] double 必选
polygons 多边形边界点坐标数据 double 必选

格式为:经度,纬度;经度,纬度;经度,纬度 单个多边形最多创建400个边界点,最大字符长度为10240。

coord_type 用户上传的坐标的类型 uint32 必选
1:GPS经纬度坐标
2:国测局加密经纬度坐标
3:百度加密经纬度坐标
4:百度加密墨卡托坐标
geotable_id 创建数据的对应数据表id string(50) 必选
ak 用户的访问权限key string(50) 必选
{column key} 用户在column定义的key/value对 开发者自定义的类型(string、int、double) 唯一索引字段必选,且需要保证唯一,否则会创建失败。最大长度2048字节。


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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)列表接口

请求url

http://api.map.baidu.com/geodata/v4/poi/list


请求参数

参数名 参数含义 类型 备注
{index key} 用户在column定义的key/value对 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) 可选
tags 数据类型 string(256) 可选
bounds 查询的矩形区域 string(100) 格式x1,y1;x2,y2分别代表矩形的左上角和右下角,可选。
范围过大时服务易超时,返回数据为空。
建议经度跨度小于0.8,纬度跨度小于0.5。
coord_type 用户上传的坐标的类型 uint32 可选,默认值为3
1:GPS经纬度坐标
2:国测局加密经纬度坐标
3:百度加密经纬度坐标
4:百度加密墨卡托坐标
geotable_id 查询的数据表id string(50) 必选
page_index 分页索引 uint32 默认为0
page_size 分页数目 uint32 默认为10,上限为200
start_date 创建日期 string(50) 格式:2017-06-01
end_date 修改日期 string(50) 格式:2017-06-01
ak 用户的访问权限key string(50) 必选


3.2.3 响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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)详情接口

请求url

http://api.map.baidu.com/geodata/v4/poi/detail


请求参数

参数名 参数含义 类型 备注
id 数据对应的id uint64 必选
geotable_id 数据表id int32 必选
ak 用户的访问权限key string(50) 必选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
poi poi结果列表 dict
id 数据id string
geotable_id geotable_id string
title 位置数据名称 string
location 百度系坐标 float 格式为:[经度,纬度]
gcj_location 国测局坐标 float 格式为:[经度,纬度]
create_time 用户创建日期 string
address 地址 string
city 城市 string
province 所在的省份 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

修改数据(poi)接口

请求url

http://api.map.baidu.com/geodata/v4/poi/update


请求参数

参数名 参数含义 类型 备注
id 位置数据的id uint64 必选
title 位置数据名称 string(256)
address 地址
tags 数据类别
latitude 用户上传的纬度 double
longitude 用户上传的经度 double
coord_type 用户上传的坐标的类型 uint32 可选,默认3
1.GPS经纬度坐标
2.测局加密经纬度坐标
3.百度加密经纬度坐标
4.百度加密墨卡托坐标
geotable_id 对应的位置数据表id string(50) 必选
ak 用户的访问权限key string(50) 必选
{column key} 用户在column定义的key/value对 用户自定义的的列类别


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述


请求响应示例

%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

删除数据(poi)接口(支持批量)

请求url

http://api.map.baidu.com/geodata/v4/poi/delete


请求参数

参数名 参数含义 类型 备注
id 被删除的id uint64 如果设置了这个参数,其它的删除条件会被忽略,只会根据id删除单条poi。此时此操作不是批量请求。

除该字段外,该接口其他字段均会触发批量任务,任务状态请通过joblist接口查看

ids id列表 以,分隔的id 最多1000个id, 如果设置了批量删除is_total_del = 1并且没有设置id字段,则优先根据ids删除多条poi, 其它条件将被忽略.
{index key} 用户在column定义的key/value对 column需要设置了is_index_field=1。对于string,是精确匹配;对于int或者double,则是范围查找,传递的格式为:最小值,最大值。当无最小值或者最大值时,用-代替,同时,此字段最大长度不超过50,最小值与最大值都是整数.
title 名称 string(256) 可选,精确匹配
tags 标签 string(256) 可选,精确匹配
geotable_id 指定的位置数据表id string(50) 必选
ak 用户的访问权限key string(50) 必选
is_total_del 标记为批量删除 int32 如需删除一条以上数据,在设定数据范围的条件时,还需要将该字段设为1。 注意:若仅设为1,而不设定数据范围的条件(如不指定ids、tag等),则默认为删除全表数据


3.5.3 响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
id 批量任务的job id string


请求响应示例

%E5%88%A0%E9%99%A4POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png

批量上传数据(post pois csv file)接口

注意:该接口每日限调用100次。若对数据的实时性要求较高,建议通过“创建数据(create poi)接口”实现。


请求url

http://api.map.baidu.com/geodata/v4/poi/upload // 该接口仅支持POST请求


请求参数

参数名 参数含义 类型 备注
geotable_id 导入的geotable的标识 uint32 必选
poi_list 输入的位置数据列表名称 file 必选,单次上传的数据表小于1000条数据
ak 用户的访问权限key string(50) 必选


导入文件(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对 用户自定义的类类别 可选
address 地址 string(256) 可选
polygons 多边形边界坐标 double 可选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
id 导入job的id string 用以查询这个job的导入状态


请求示例

%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)接口

请求url

http://api.map.baidu.com/geodata/v4/job/list


请求参数

参数名 参数含义 类型 备注
id 批量任务的job id int32
page_size 分页大小(单页召回的数据量) int32 默认10,上限200
page_index 翻页 int32 0为第一页
ak 用户的访问权限key string(50) 必选
geotable_id 查询的位置数据表id int(32) 可选


响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 状态码描述
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(失败)


请求示例

%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:当前并发量已经超过约定并发配额,限制访问。并发控制超限,对此错误码不需要重试消耗配额和并发资源,请控制并发量或联系我们



控制服务错误码:

请参见附录