“lbscloud

2014年6月4日 (三) 15:35的版本

云存储字段定义方式

位置数据表（geotable）实体字段定义

使用说明

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

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

3.批量操作说明：

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

批量上传多条数据；批量删除多条数据；批量删除1个或者多个自定义扩展列（column）；批量更新数据（如字段、字段属性、字段对应的值等）等操作
“批量操作”接口原理及使用说明如下：

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

geotable 字段说明
字段名称	字段含义	类型	备注
id	id，记录唯一的标识
geotype	geotable包含的数据类型，包含点、线、面三种类型	uint32	1：点；2：线；3：面。默认为1（当前只支持点）
modify_time	记录最后一次被修改的时间	datetime
create_time	记录被创建的时间	datetime
user_id	创建此记录的用户标识	uint64

自定义扩展列（column）实体字段定义

字段名	含义	类型	是否必须	默认值	备注
id	唯一标识	uint64	是	无
key	存储在geotable 的key标识	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图片存储
max_length	最大长度	int32	否	无	1,针对String是必须 2,最大值不超过2048
default_value	默认值	string(32)	否	无	1,如果此列被设置成排序筛选字段,则default_value必须进行设置.否则默认为0
is_sortfilter_field	是否将字段设置为云检索时的排序筛选字段	uint32	是		1代表是，0代表否。设置后效果详见 http://developer.baidu.com/map/lbs-geosearch.htm#.search.nearby 最多只能设置15个
sortfilter_id	排序筛选字段id	uint32	否		1-15,在同一geotable内不能重复.
is_search_field	是否设置为检索时的文本检索字段	uint32	是		1代表是，0代表否。设置后可根据对该字段的内容要求进行检索只能针对String类型的字段,最大设置大小不超过2048,最多不超过4个
is_index_field	是否将字段设置为索引字段。	uint32	否		1代表是，0代表否。设置后可实现方便快速查询。最多设置2个注：is_index_field=1 时才能在根据该列属性值检索到数据，设置后对应功能： http://developer.baidu.com/map/lbs-geodata.htm#.column.manage3.2
is_unique_field	是否将字段设置为唯一索引字段。	uint32	否		1代表是，0代表否。设置后方便更新，删除，查询。最多设置1个
create_time	创建时间	uint32	是		Unix时间戳
modify_time	修改时间	uint32	是		Unix时间戳

位置数据（poi）实体字段定义

字段名	含义	类型	是否必须	默认值	备注
id	唯一标识	uint64	是	无
location	坐标	array	是	无	格式为：[经度,纬度]或者[对应的墨卡托投影]
province	省名称	string(32)	否	无
city_id	市id	uint32	是	无
city	市名	string(32)	是	无
district	区名	string(64)	否
title	名称	string(256)	否
address	地址	string(256)	否
coord_type	用户上传的坐标的类型	uint32	否	3	可选，1.GPS经纬度坐标 2.国测局加密经纬度坐标 3.百度加密经纬度坐标 4.百度加密墨卡托坐标
tags	标签	string(256)	否		以空格分隔
geotable_id	表主键	uint32	是
create_time	创建时间	uint32	是		Unix时间戳
modify_time	修改时间	uint32	是		Unix时间戳

位置数据表（geotable&column）管理

2.1 创建表（create geotable）接口

2.1.1 请求url

http://api.map.baidu.com/geodata/v3/geotable/create  //POST请求

2.1.2 请求参数

参数名	参数含义	类型	备注
name	geotable的中文名称	string(45)	必选
geotype	geotable持有数据的类型	int32	必选 1：点poi 2：线poi 3：面poi，默认为1
is_published	是否发布到检索	int32	必选	0：未自动发布到云检索， 1：自动发布到云检索；策略提示：注：1）通过URL方式创建表时只有is_published=1时在云检索时表内的数据才能被检索到。 2）可通过数据管理模块设置，如图所示，在设置中将是否发送到检索一栏中选定为是即可。
timestamp	时间戳	uint32	可选
ak	用户的访问权限key	string(50)	必选
sn	用户的权限签名	string(50)	可选

2.1.3 响应参数（json格式）

参数名	参数含义	类型	备注
status	状态码	int32	必须。0代表成功，其它取值含义另行说明
message	响应的信息	string(50)	对status的英文描述
id	新增的数据的id	string	必选

2.1.4 请求响应示例（截图来自chrome浏览器插件："POSTMAN"工具，下同）

@@ 第54行： / 第54行： @@
 |
 |}
-===1.2 自定义扩展列（column）实体字段定义===
+===自定义扩展列（column）实体字段定义===
 {|
 !width="100"|字段名

文档全面上新