LBS云检索API接口规范.pdf

LBS.云v2.0 云检索API 接口说明文档 百度在线网络技术（北京）有限公司 2013 年07 月 24 日 北京 开发问题，请访问 一、LBS 云存储APIv2 （数据存储管理接口）接口说明 1 ．概念实体字段定义 1.1 位置数据表（geotable ）实体字段定义 1.2 自定义扩展列（column ）实体字段定义 1.3 位置数据（poi ）实体字段定义 2 ．位置数据表（geotablecolumn ）管理 2.1 创建表（create geotable ）接口 2.2 条件查询表（list geotable ）接口 2.3 查询指定id 表信息（deatail 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 ）接口（支持批量条件删除） 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 ）接口 4. 批量操作任务（JOB ）查询进度接口 4.1 批量操作任务查询（list job ）接口 4.2 根据id 查询批量任务（detail job ）接口 5. 返回码定义值表 使用说明： 1. 请先了解名词意义： “位置数据表（geotable ）”、 “自定义扩展列（column ）”、“位置数据 （poi ）”概念的意义，更有劣于开发。 2. 云存储接口功能：支持单个geotable 亿级数据及数百G 大小的存储，每天支持百万量级读写，每秒支 持万量级读写。 3. 批量操作说明： V2 版本，引入“批量操作”概念。通过批量操作接口操作，您可实现对一个位置数据表（geotable ） 进行如下操作：  批量上传多条数据；  批量删除多条数据； 1 /map/lbs-cloud.htm 开发问题，请访问  批量删除1 个或者多个自定义扩展列（column ）；  批量更新数据（如字段、字段属性、字段对应的值等）等操作 “批量操作”接口原理及使用说明如下：  “批量操作”接口是采用异步服务形式，您可使用此接口对一个位置数据表（geotable ）同时执 行各种批量操作，服务将在幵发数范围内同时处理多个请求任务，超出幵发数的请求任务将以 消息队列形式进入处理等待状态。  当您使用批量操作接口时，服务将先发送批量操作请求，若请求成功，系统将锁定对应的位置数 据表（geotable ），即用户可对此表进行可读操作，丌能进行任何写操作，直到此次批量操作 任务完成（即任务进度状态码Status = 3 完成时）自劢解锁，恢复可写。同时，系统会返回状 态码Status =21 和此操作（Job id ），Status 值用于标识您的操作为批量操作， Job id 用于 查询此批量操作的任务进度。（Status = 0 表示非批量操作的普通操作）。  查询某个批量操作任务进度，即根据上述返回的Job id ，使用批量操作任务查询进度接口进行查 询。根据返回的任务进度状态码值（1、2、3 ）确认批量操作的进度（新增操作，消息队列中等 待处理；正在处理；完成）。 1． 云存储字段定义方式 1.1 位置数据表（geotable ）实体字段定义 geotable 字段定义 字段名称