百度地图LBS云存储APIv30接口说明文档.docx

1、XX地图LBS云存储APIv30接口说明文档LBS.云v3.0云存储API接口说明文档XX在线网络技术（北京）有限公司2013年11月 07日 北京法律说明版权所有XX在线网络技术有限公司。本文档包含的所有内容除特别声明之外，版权均属于XX在线网络技术有限公司所有，XX可在不作任何申明的情况下对本文档内容进行修改。本文档中所使用的商标所有权属于该商标的所有者。文件说明文件标识：Baidu_LBSYun_3.0当前版本：2014_01_V3.0作 者：Baidu_Map_PM创建日期：2013-04-11最新更新：2014-1-9更新 2013-10-27添加参数，修改参数备注说明2013-11

2、-07支持唯一索引字段；优化批量上传接口，增加查看进度接口2013-12-09自定义配置参数的数据类型以及备注说明部分的细化更新2014-01-09添加支持图片存储功能，对自定义字段进行近一步的详细说明XX在线网络技术有限公司邮箱：*地址：北京市海淀区上地信息路9号甲奎科科技大厦邮编：100085XX地图LBS开放平台： XX地图API网址：XX地图API论坛：一、LBS云存储API v3（数据存储管理接口）接口说明1 概念实体字段定义1.1 位置数据表（geotable）实体字段定义1.2 自定义扩展列（column）实体字段定义1.3 位置数据（poi）实体字段定义2位置数据表（geota

3、ble&column）管理2.1 创建表（create geotable）接口 2.2 条件查询表（listgeotable）接口 2.3 查询指定id表信息（detail geotable）接口 2.4 修改表（update geotable）接口 2.5 删除表（delete geotable）接口 2.6 创建列（create column）接口 2.7 条件查询列（list column）接口 2.8 查询指定id列（detail column）详情接口 2.9 修改指定条件列（update column）接口（支持批量条件修改） 2.10 删除指定条件列（delete column）

4、接口（支持批量条件删除） 3. 位置数据（poi）管理3.1 创建数据（create poi）接口3.2 条件查询数据（list poi）列表接口3.3 查询指定id的数据（detail poi）详情接口3.4 修改数据（update poi）接口3.5 删除单个数据（delete poi）接口（支持批量）3.6 批量上传数据（post pois csv file）接口3.7 批量上传进度查询接口（支持查询成功，失败poi）4. 批量操作任务（JOB）查询进度接口4.1 批量操作任务查询（list job）接口4.2 根据id查询批量任务（detail job）接口5. 返回码定义值表使用说明

5、：1.请先了解名词意义： “位置数据表（geotable）”、 “自定义扩展列（column）”、“位置数据（poi）”概念的意义，更有助于开发。2.云存储接口功能：支持单个geotable亿级数据及数百G大小的存储，每天支持百万量级读写，每秒支持万量级读写。3.批量操作说明：V2版本，引入“批量操作”概念。通过批量操作接口操作，您可实现对一个位置数据表（geotable）进行如下操作：批量上传多条数据；批量删除多条数据；批量删除1个或者多个自定义扩展列（column）；批量更新数据（如字段、字段属性、字段对应的值等）等操作“批量操作”接口原理及使用说明如下：“批量操作”接口是采用异步服务形式

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

7、示非批量操作的普通操作）。查询某个批量操作任务进度，即根据上述返回的Job id，使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值（1、2、3）确认批量操作的进度（新增操作，消息队列中等待处理；正在处理；完成）。1 云存储字段定义方式1.1 位置数据表（geotable）实体字段定义geotable 字段定义字段名称字段含义类型备注idid,记录的唯一标识uint32namegeotable的中文名称string(45)geotypegeotable包含的数据类型，包含点、线、面三种类型uint321：点；2：线；3：面。默认为1（当前只支持点）。modify_time记录最后

8、一次被修改的时间datetimecreate_time记录被创建的时间datetimeuser_id创建此记录的用户标识uint641.2 自定义扩展列（column）实体字段定义字段名含义类型是否必须默认值备注id唯一标识UInt64是无key存储在geotable的key标识String(64)是无在同一geotable内唯一正则:a-zA-Z0-9a-zA-Z_*name对key的描述String(128)否无type字段类型UInt32是无1：Int64, 2:double, 3,string;4：在线图片url，LBS图片存储max_length最大长度UInt32否无1,针对Str

9、ing是必须2,最大值不超过2048default_value默认值String(32)否无1,如果此列被设置成排序筛选字段,则default_value必须进行设置.否则默认为0is_sortfilter_field是否将字段设置为云检索时的排序筛选字段UInt32是1代表是，0代表否。设置后效果详见最多只能设置15个只有int或者double类型可以设置sortfilter_id排序筛选字段idUInt32否1-15,在同一geotable内不能重复.is_search_field是否设置为检索时的文本检索字段UInt32是1代表是，0代表否。设置后可根据对该字段的内容要求进行检索只能针对

10、String类型的字段,最大设置大小不超过2048,最多不超过4个is_index_field是否将字段设置为索引字段。UInt32否1代表是，0代表否。设置后可实现方便快速查询。最多设置2个注：is_index_field=1 时才能在根据该列属性值检索到数据设置后对应功能： is_unique_field是否将字段设置为唯一索引字段。UInt32否1代表是，0代表否。设置后方便更新，删除，查询最多设置1个create_time创建时间UInt32是Unix时间戳modify_time修改时间UInt32是Unix时间戳1.3 位置数据（poi）实体字段定义字段名含义类型是否必须默认值备注i

11、d唯一标识UInt64是无location坐标Array是无格式为：经度,纬度或者对应的墨卡托投影province省名称String(32)否无city_id市idUInt32是无city市名String(32)是无district区名String(64)否title名称String(256)否address地址String(256)否coord_type 用户上传的坐标的类型UInt32否3可选，1.GPS经纬度坐标2.国测局加密经纬度坐标3.XX加密经纬度坐标4.XX加密墨卡托坐标tags标签String(256)否以空格分隔geotable_id表主键UInt32是create_time

12、创建时间UInt32是Unix时间戳modify_time修改时间UInt32是Unix时间戳2位置数据表（geotable&column）管理2.1 创建表（create geotable）接口2.1.1 请求urlPOST请求2.1.2请求参数参数名参数含义类型备注nameGeotable的中文名称String(45)必选geotypeGeotable持有数据的类型Int32必选1：点poi2：线poi3：面poi，默认为1is_published是否发布到检索Int32必选0：未自动发布到云检索，1：自动发布到云检索；策略提示：注：1）通过URL方式创建表时只有is_published=

13、1时 在云检索时表内的数据才能被检索到2）通过数据管理模块时：。timestamp时间戳UInt32可选ak用户的访问权限keyString(50)必选sn用户的权限签名String(50)可选2.1.3响应参数（json格式）参数名参数含义类型备注status状态码Int32必须。0代表成功，其它取值含义另行说明message响应的信息String(50)必须对status的英文描述id新增的数据的idString必须2.1.4请求响应示例（截图来自chrome浏览器插件：“POSTMAN”工具，下同）2.2 查询表（list geotable）接口2.2.1 请求url GET请求2.2.

14、2 请求参数参数名参数含义类型备注namegeotable的名字String(45)可选ak用户的访问权限keyString(50)必选sn用户的权限签名String(50)可选2.2.3 响应参数（json格式）参数名参数含义类型备注status状态码Int32必须0代表成功，其它取值含义另行说明message响应的信息String(50)必须对status的英文描述size数据个数Int32geotablesGeotable列表ArrayidGeotable的主键StringGeotypeGeo类型NameGeotable的中文名称StringIs_published是否发布到检索Int3

15、2Create_time创建日期StringModify_time最近一次修改时间String2.2.4请求响应示例2.3 查询指定id表（detail geotable）接口2.3.1 请求urlGET请求2.3.2 请求参数参数名参数含义类型备注id指定geotable的idInt32必选ak用户的访问权限keyString(50)必选sn用户的权限签名String(50)可选2.3.3 响应参数（json格式）参数名参数含义类型备注Status状态码Int32必须。0代表成功，其它取值含义另行说明Message响应的信息String(50)对status的英文描述GeotableGeot

16、ableDictidGeotable的主键StringGeotypeGeo类型NameGeotable的中文名称StringIs_published是否发布到检索Int32Create_time创建日期StringModify_time最近一次修改时间String2.3.4请求响应示例2.4 修改表（update geotable）接口2.4.1 请求urlPOST请求2.4.2 请求参数参数名参数含义类型备注idgeotable主键UInt32必选is_published是否发布到检索int32会引起批量操作nameGeotable的中文名称String(45)可选ak用户的访问权限keyS

17、tring(50)必选sn用户的权限签名String(50)可选2.4.3 响应参数（json格式）参数名参数含义类型备注status状态码Int32必须。0代表成功，其它取值含义另行说明message响应的信息String(50)对status的英文描述2.4.4请求响应示例2.5 删除表（geotable）接口2.5.1 请求urlPOST请求注：当geotable里面没有有效数据时，才能删除geotable2.5.2 请求参数参数名参数含义类型备注id表主键UInt32必选ak用户的访问权限keyString(50)必选sn用户的权限签名String(50)可选2.5.3 响应参数（js

18、on格式）参数名参数含义类型备注status状态码Int32必须。0代表成功，其它取值含义另行说明message响应的信息String(50)对status的英文描述2.5.4请求响应示例2.6 创建列（create column）接口2.6.1 请求url POST请求2.6.2 请求参数参数名参数含义类型备注nameColumn的属性中文名称String(45)必选keycolumn存储的属性keyString(45)必选，同一个geotable内的名字不能相同type存储的值的类型UInt32必选，枚举值1：Int64, 2:double, 3,string，4，在线图片urlmax_l

19、ength最大长度UInt32必选最大值2048，最小值为1，针对string有效，并且string时必填。此值代表utf8的汉字个数，不是字节个数default_value默认值String(45)设置默认值is_sortfilter_field是否检索引擎的数值排序筛选字段UInt32必选，1代表是，0代表否。设置后效果详见最多只能设置15个只有int或者double类型可以设置is_search_field是否检索引擎的文本检索字段UInt32必选，1,代表支持，0为不支持。只有string可以设置检索字段只能用于字符串类型的列且最大长度不能超过512个字节Is_index_field是

20、否存储引擎的索引字段UInt32必选，用于存储接口查询1,代表支持，0为不支持。注：is_index_field=1 时才能在根据该列属性值检索时检索到数据。设置后可用功能： is_unique_field是否云存储唯一索引字段UInt32可选用于更新，删除，查询：1代表支持 ，0为不支持geotable_id所属于的geotable_idString(50)必选ak用户的访问权限keyString(50)必选sn用户的权限签名String(50)可选2.6.3 响应参数（json格式）参数名参数含义类型备注status状态码Int32必须。0代表成功，其它取值含义另行说明message响应的

21、信息String(50)对status的英文描述id新增的数据idUInt32必选。2.6.4请求响应示例2.7 查询列（list column）接口2.7.1 请求url GET请求2.7.2 请求参数参数名参数含义类型备注nameGeotable meta的属性中文名称String(45)可选keyGeotable meta存储的属性keyString(45)可选geotable_id所属于的geotable_idString(50)必选ak用户的访问权限keyString必选sn用户的权限签名String可选2.7.3 响应参数（json格式）参数名参数含义类型备注status状态码In

22、t32必须。0代表成功，其它取值含义另行说明message响应的信息String(50)对status的英文描述size返回数据条数UInt32必选columns数据ArrayIdidString必选Geotable_id所属于的geotable_idString必选name中文名称String必选key存储的属性keyString必选type存储的值的类型UInt32必选max_length列的最大长度Uint32default_value列的默认値String（32）create_time列的创建时间UInt32modify_time列的修改时间UInt32Is_sortfilter_fi

23、eld是否检索端排序字段UInt32Is_search_field是否检索端文本检索字段UInt32Is_index_field是否存储管理索引字段UInt32is_unique_field是否存储管理唯一索引字段UInt322.7.4请求响应示例2.8 查询指定id列（detail column）详情接口2.8.1 请求url GET请求2.8.2 请求参数参数名参数含义类型备注id列的idUInt32必选geotable_id表的idUInt32必选ak用户的访问权限keyString必选sn用户的权限签名String可选2.8.3响应参数（json格式）参数名参数含义类型备注status状态码Int32必须。0代表成功，其它取值含义另行说明message响应的信息String(50)对status的英文描述column数据DictididString必选geotable_id所属于的geotable_idString必选name中文名称String必选key存储的属性keyString必选type存储的值的类型UInt32必选max_length列的最大长度UInt32default_value列的默认値String(32)create_time列的创建时间UInt32modify_time列的修改时间UInt32is_