目录
坐标系说明
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，为唯一标识 |
| user_id | 用户id | uint64 | |
| geotype | 数据类型 | uint32 | 1（点）、3（面） |
| create_time | 创建的时间 | datetime | |
| modify_time | 最后一次修改的时间 | datetime |
自定义扩展列（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/index.php?title=lbscloud/api/geosearch最多只能设置15个 | |
| sortfilter_id | 排序筛选字段id | uint32 | 否 | 1-15,在同一geotable内不能重复. | |
| is_search_field | 是否设置为检索时的文本检索字段 | uint32 | 是 | 1代表是，0代表否。设置后可根据对该字段的内容要求进行检索 只能针对String类型的字段,最大 设置大小不超过2048,最多不超过4个 | |
| is_index_field | 是否将字段设置为索引字段。 | uint32 | 否 | 1代表是，0代表否。设置后可实现方便快速查询。最多设置3个 注：is_index_field=1 时才能在根据该列属性值检索到数据，设置后对应功能： http://developer.baidu.com/map/index.php?title=lbscloud/api/geodata | |
| is_unique_field | 是否将字段设置为唯一索引字段。 | uint32 | 否 | 1代表是，0代表否。设置后方便更新，删除，查询。最多设置1个 | |
| create_time | 创建时间 | uint32 | 是 | Unix时间戳 | |
| modify_time | 修改时间 | uint32 | 是 | Unix时间戳 |
位置数据（poi）实体字段定义
| 字段名 | 含义 | 类型 | 备注 |
|---|---|---|---|
| id | id | uint64 | 为唯一标识 |
| title | 名称 | string(256) | |
| tags | 分类标签 | string(256) | 参见：POI行业分类 多个tag以空格分隔 |
| location | 坐标 | array | 格式为：[经度,纬度]或[墨卡托坐标] |
| 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/v3/geotable/create //POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| name | geotable的中文名称 | string(45) | 必选 |
| geotype | geotable持有数据的类型 | int32 | 必选 1：点；2：线；3：面。默认为1（当前不支持“线”） |
| is_published | 是否发布到检索 | int32 | 必选 0：未自动发布到云检索， 1：自动发布到云检索； 注：1）通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。 2）可通过数据管理模块设置，在设置中将是否发送到检索一栏中选定为是即可。 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| timestamp | 时间戳 | uint32 | 可选，配合sn使用，增加时间戳安全验证 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| id | 新增的数据的id | string |
请求响应示例（截图来自chrome浏览器插件："POSTMAN"工具，下同）
查询表（list geotable）接口
请求url
http://api.map.baidu.com/geodata/v3/geotable/list // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| name | geotable的名字 | string(45) | 可选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 | |
|---|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 | |
| message | 响应的信息 | string(50) | 状态码描述 | |
| size | 数据个数 | int32 | ||
| geotables | geotable列表 | array | ||
| id | geotable的主键 | string | ||
| geotype | geo类型 | |||
| name | geotable的中文名称 | string | ||
| is_published | 是否发布到检索 | int32 | ||
| create_time | 创建日期 | string | ||
| modify_time | 最近一次修改时间 | string | ||
请求响应示例
查询指定id表（detail geotable）接口
请求url
http://api.map.baidu.com/geodata/v3/geotable/detail // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 指定geotable的id | int32 | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 | |
|---|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 | |
| message | 响应的信息 | string(50) | 状态码描述 | |
| geotable | geotable列表 | array | ||
| id | geotable的主键 | string | ||
| geotype | geo类型 | |||
| name | geotable的中文名称 | string | ||
| is_published | 是否发布到检索 | int32 | ||
| create_time | 创建日期 | string | ||
| modify_time | 最近一次修改时间 | string | ||
请求响应示例
修改表（update geotable）接口
请求url
http://api.map.baidu.com/geodata/v3/geotable/update // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | geotable主键 | uint32 | 必选 |
| is_published | 是否发布到检索 | int32 | 会引起批量操作 |
| name | geotable的中文名称 | string(45) | 可选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
请求响应示例
删除表（geotable）接口
请求url
http://api.map.baidu.com/geodata/v3/geotable/delete // POST请求 //注：当geotable里面没有有效数据时，才能删除geotable
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 表主键 | uint32 | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
请求响应示例
数据列（column）管理
创建列（create column）接口
请求url
http://api.map.baidu.com/geodata/v3/column/create // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| name | column的属性中文名称 | string(45) | 必选 |
| key | column存储的属性key | string(45) | 必选，同一个geotable内的名字不能相同 |
| type | 存储的值的类型 | uint32 | 必选，枚举值1:Int64, 2:double, 3:string, 4:在线图片url |
| max_length | 最大长度 | uint32 | 最大值2048，最小值为1。当type为string该字段有效，此时该字段必填。此值代表utf8的汉字个数，不是字节个数 |
| default_value | 默认值 | string(45) | 设置默认值 |
| is_sortfilter_field | 是否检索引擎的数值排序筛选字段 | uint32 | 必选 1代表是，0代表否。设置后，在请求 LBS云检索时可针对该字段进行排序。该字段只能为int或double类型，最多设置15个 |
| is_search_field | 是否检索引擎的文本检索字段 | uint32 | 必选 1代表支持，0为不支持。只有type为string时可以设置检索字段，只能用于字符串类型的列且最大长度不能超过512个字节 |
| is_index_field | 是否存储引擎的索引字段 | uint32 | 必选 用于存储接口查询:1代表支持，0为不支持 注：is_index_field=1 时才能在根据该列属性值检索时检索到数据 |
| is_unique_field | 是否云存储唯一索引字段，方便更新，删除，查询 | uint32 | 可选，1代表是，0代表否。设置后将在数据创建和更新时进行该字段唯一性检查，并可以以此字段为条件进行数据的更新、删除和查询。最多设置1个 |
| geotable_id | 所属于的geotable_id | string(50) | |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| id | 新增的数据id | uint32 |
请求响应示例
查询列（list column）接口
请求url
http://api.map.baidu.com/geodata/v3/column/list // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| name | geotable meta的属性中文名称 | string(45) | 可选 |
| key | geotable meta存储的属性key | string(45) | 可选 |
| geotable_id | 所属于的geotable_id | string(50) | 必选 |
| ak | 用户的访问权限key | string | 必选 |
| sn | 用户的权限签名 | string | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 | |
|---|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 | |
| message | 响应的信息 | string(50) | 状态码描述 | |
| size | 返回数据条数 | uint32 | ||
| columns | id | id | string | |
| geotable_id | 所属于的geotable_id | string | ||
| name | 中文名称 | string | ||
| key | 存储的属性key | string | ||
| type | 存储的值的类型 | uint32 | ||
| max_length | 列的最大长度 | uint32 | ||
| default_value | 列的默认值 | string(32) | ||
| create_time | 列的创建时间 | uint32 | ||
| modify_time | 列的修改时间 | uint32 | ||
| is_sortfilter_field | 是否检索端排序字段 | uint32 | ||
| is_search_field | 是否检索端文本检索字段 | uint32 | ||
| is_index_field | 是否存储管理索引字段 | uint32 | ||
| is_unique_field | 是否存储管理唯一索引字段 | uint32 | ||
请求响应示例
查询指定id列（detail column）详情接口
请求url
http://api.map.baidu.com/geodata/v3/column/detail // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 列的id | uint32 | 必选 |
| geotable_id | 表的id | uint32 | 必选 |
| ak | 用户的访问权限key | string | 必选 |
| sn | 用户的权限签名 | string | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 | |
|---|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 | |
| message | 响应的信息 | string(50) | 状态码描述 | |
| column | id | id | string | |
| geotable_id | 所属于的geotable_id | string | ||
| name | 中文名称 | string | ||
| key | 存储的属性key | string | ||
| type | 存储的值的类型 | uint32 | ||
| max_length | 列的最大长度 | uint32 | ||
| default_value | 列的默认值 | string(32) | ||
| create_time | 列的创建时间 | uint32 | ||
| modify_time | 列的修改时间 | uint32 | ||
| is_sortfilter_field | 是否是 LBS云检索排序字段 | uint32 | ||
| is_search_field | 是否是 LBS云检索文本检索字段 | uint32 | ||
| is_index_field | 是否是云存储索引字段 | uint32 | ||
| is_unique_field | 是否是云存储唯一索引字段 | uint32 | ||
请求响应示例
修改指定条件列（column）接口
请求url
http://api.map.baidu.com/geodata/v3/column/update // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 列主键 | uint32 | 必选 |
| geotable_id | 所属表主键 | uint32 | 必选 |
| name | 属性中文名称 | string(45) | 可选 |
| default_value | 默认值 | string | 可选 |
| max_length | 文本最大长度 | int32 | 字符串最大长度，只能改大，不能改小 |
| is_sortfilter_field | 是否检索引擎的数值排序字段 | uint32 | 1代表是，0代表否，如果poi表中已经有数据，并且发布到了 LBS云检索，修改此字段，会引起批量操作 |
| is_search_field | 是否检索引擎的文本检索字段 | uint32 | 1代表是，0代表否，如果poi表中已经有数据，并且发布到了 LBS云检索，修改此字段，会引起批量操作 |
| is_index_field | 是否存储引擎的索引字段 | uint32 | 1代表是，0代表否 |
| is_unique_field | 是否存储索引的唯一索引字段 | uint32 | 1代表是，0代表否。设置后将在数据创建和更新时进行该字段唯一性检查，并可以以此字段为条件进行数据的更新、删除和查询。最多设置1个 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
请求响应示例
删除指定条件列（column）接口
请求url
http://api.map.baidu.com/geodata/v3/column/delete // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 必选 | ||
| geotable_id | 必选 | ||
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
请求响应示例
位置数据（poi）管理
创建数据（create poi）接口
请求url
http://api.map.baidu.com/geodata/v3/poi/create // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| title | poi名称 | string(256) | 可选 |
| address | 地址 | string(256) | 可选 |
| tags | tags | string(256) | 可选 |
| latitude | 用户上传的纬度 | double | 必选 |
| longitude | 用户上传的经度 | double | 必选 |
| coord_type | 用户上传的坐标的类型 | uint32 | 必选 1：GPS经纬度坐标 2：国测局加密经纬度坐标 3：百度加密经纬度坐标 4：百度加密墨卡托坐标 |
| geotable_id | 记录关联的geotable的标识 | string(50) | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| {column key} | 用户在column定义的key/value对 | 开发者自定义的类型（string、int、double） | 唯一索引字段必选，且需要保证唯一，否则会创建失败 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| id | 新增的数据的id | string |
请求响应示例
查询指定条件的数据（poi）列表接口
请求url
http://api.map.baidu.com/geodata/v3/poi/list // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| {index key} | 用户在column定义的key/value对 | column需要设置了is_index_field=1。对于string，是前缀匹配，如需精确匹配请在末尾加$。对于int或者double，则是范围查找，传递的格式为最小值,最大值。当无最小值或者最大值时，用-代替，同时，此字段最大长度不超过50，最小值与最大值都是整数 例：如加入一个命名为color数据类型为string的column，在检索是可设置为“color=red”的形式来检索color字段为red的POI | |
| title | 记录（数据）名称 | string(256) | 可选 |
| tags | 记录的标签（用于检索筛选） | string(256) | 可选 |
| bounds | 查询的矩形区域 | string(100) | 格式x1,y1;x2,y2分别代表矩形的左上角和右下角，可选 |
| geotable_id | geotable_id | string(50) | 必选 |
| page_index | 分页索引 | uint32 | 默认为0 |
| page_size | 分页数目 | uint32 | 默认为10，上限为200 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
3.2.3 响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| size | 返回数据条数 | uint32 | |
| total | 全部的数据条数 | uint32 | |
| pois | poi结果列表 | array | |
| id | 数据id | string | |
| geotable_id | geotable_id | string | |
| title | poi名称 | string | |
| location | 百度系坐标 | float | 格式为：[经度,纬度] |
| gcj_location | 国测局坐标 | float | 格式为：[经度,纬度] |
| address | 地址 | string | |
| tags | 标签 | string | |
| create_time | 用户创建日期 | string | |
| modify_time | 用户修改时间 | string | |
| province | 所在的省份 | string | |
| district | 所在的区 | string | |
| {column key} | 用户在column定义的key/value对 | 用户自定义的类类别 |
请求响应示例
查询指定id的数据（poi）详情接口
请求url
http://api.map.baidu.com/geodata/v3/poi/detail // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | poi主键 | uint64 | 必选 |
| geotable_id | 表主键 | int32 | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| poi | poi结果列表 | dict | |
| id | 数据id | string | 当不存在唯一索引字段时必选，存在唯一索引字段时可选 |
| geotable_id | geotable_id | string | |
| {自定义唯一索引key} | Value | 自定义类型 | 若自定义索引字段和id共存时，将优先根据id进行查询 |
| title | poi名称 | string | |
| location | 百度系坐标 | float | 格式为：[经度,纬度] |
| gcj_location | 国测局坐标 | float | 格式为：[经度,纬度] |
| create_time | 用户创建日期 | string | |
| address | 地址 | string | |
| city | 城市 | string | |
| province | 所在的省份 | string | |
| district | 所在区域 | string | |
| {column key} | 用户在column定义的key/value对 | 自定义类型 |
请求响应示例
修改数据（poi）接口
请求url
http://api.map.baidu.com/geodata/v3/poi/update // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | poi的id | uint64 | 当不存在唯一索引字段时必须，存在唯一索引字段可选 |
| 自定义唯一索引key | Value | 用户自定义类型 | 可选，若自定义索引字段和id共存时，将以id为准，且自定义索引key将被新的value |
| title | poi名称 | string(256) | |
| address | 地址 | ||
| tags | tags | ||
| latitude | 用户上传的纬度 | double | |
| longitude | 用户上传的经度 | double | |
| coord_type | 用户上传的坐标的类型 | uint32 | 必选 1．GPS经纬度坐标 2．测局加密经纬度坐标 3．百度加密经纬度坐标 4．百度加密墨卡托坐标 |
| geotable_id | 记录关联的geotable的标识 | string(50) | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| {column key} | 用户在column定义的key/value对 | 用户自定义的的列类别 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
请求响应示例
删除数据（poi）接口（支持批量）
请求url
http://api.map.baidu.com/geodata/v3/poi/delete // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 被删除的id | uint64 | 如果设置了这个参数，其它的删除条件会被忽略，只会根据id删除单条poi。此时此操作不是批量请求。 |
| 自定义唯一索引key | Value | 用户自定义类型 | 可选，若自定义索引字段和id共存时，优先选择根据id删除poi。 |
| 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) | 可选 |
| bounds | 查询的矩形区域 | string(100) | 格式x1,y1;x2,y2分别代表矩形的左上角和右下角 |
| geotable_id | geotable_id | string(50) | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| {column key} | 用户在column定义的key/value对 | ||
| is_total_del | 标记为批量删除 | int32 | 如需删除一条以上数据，在设定数据范围的条件时，还需要将该字段设为1。 注意：若仅设为1，而不设定数据范围的条件（如不指定ids、tag等），则默认为删除全表数据 |
3.5.3 响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| id | job id | string |
请求响应示例
批量上传数据（post pois csv file）接口
注意：该接口每日限调用25次。若对数据的实时性要求较高，建议通过“创建数据（create poi）接口”实现。
请求url
http://api.map.baidu.com/geodata/v3/poi/upload // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| geotable_id | 导入的geotable的标识 | uint32 | 必选 |
| poi_list | 输入的poi列表名称 | file | 必选，小于8M |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| timestamp | 时间戳 | uint32 | 必选，配合sn使用，增加时间戳安全验证 |
导入文件（poi_list）的CSV格式：
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| title | poi名称 | string(45) | 必选 |
| latitude | 用户上传的纬度 | double | 必选 |
| longitude | 用户上传的经度 | double | 必选 |
| coord_type | 用户上传的坐标的类型 | uint32 | 1.GPS经纬度坐标 2.国测局加密经纬度坐标 3.百度加密经纬度坐标 4.百度加密墨卡托坐标 |
| {column key} | 用户在column定义的key/value对 | 用户自定义的类类别 | 可选 |
| address | 地址 | string（256） | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| job_id | 导入job的id | string | 用以查询这个job后续的导入情况调用job/listimportdata接口详情见下 |
请求响应示例
附：批量导入示例文件（data.csv ）
批量上传进度查询接口（支持进度查询和上传失败的poi）
请求url
http://api.map.baidu.com/geodata/v3/job/listimportdata // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| geotable_id | 导入的geotable的标识 | uint32 | 必选 |
| job_id | 导入接口返回的job_id | string（50） | 必选 |
| status | Poi导入的状态 | uint32 | 默认为0，0为全部，1为失败，2为成功，已经废弃。 |
| page_index | 分页索引 | uint32 | 默认为0 |
| page_size | 分页数目 | uint32 | 默认为10，上限为100 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
| timestamp | 时间戳 | uint32 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| total | 导入poi总数目 | int32 | |
| size | 当前返回个数 | int32 | |
| process_status | 导入进度状态 | int32 | 0为进行中，1为完成 |
| process_total | 导入总数 | int32 | |
| process_failed | 导入失败总数 | int32 | |
| process_success | 导入成功总数 | ||
| datas | Array[ poi=>array(),//导入的poi信息 msg=>导入状态信息 ] | Array | |
| Header | 导入的header信息 | Array | |
| time | 导入总时间单位s | int32 |
批量操作任务（JOB）查询进度接口
批量操作接口原理及使用说明
通过“批量操作”接口，可实现对一个位置数据表（geotable）进行各种批量操作，包括：上传多条数据，删除多条数据，删除多个自定义扩展列（column），更新数据（如字段、字段属性、字段对应的值等）等。
“批量操作”接口采用异步形式，服务将在并发数范围内同时处理多个请求任务，超出并发数的请求任务将以消息队列形式进入处理等待状态。
当您使用批量操作接口时，服务将先发送批量操作请求，若请求成功，系统将锁定对应的位置数据表（geotable），即用户可对此表进行可读操作，不能进行任何写操作，直到此次批量操作任务完成（即任务进度状态码Status = 3 完成时）自动解锁，恢复可写。同时，系统会返回状态码Status =21（表示批量操作）和此操作的Job id（用于查询此批量操作的任务进度）。
查询某个批量操作任务进度，即根据上述返回的Job id，使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值确认批量操作的进度（1为等待处理，2为正在处理，3为完成）。
注意：“批量上传”功能每日限调用25次。
批量操作任务查询（list job）接口
请求url
http://api.map.baidu.com/geodata/v3/job/list // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| type | job类型 | int32(<10) | |
| status | job状态 | int32(<10) | 1为等待处理，2为正在处理，3为完成。 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| jobs | job结果列表 | array | |
| id | 数据id | string | |
| create_time | 用户创建日期 | string | |
| modify_time | string | ||
| error | 错误码 | int32 | |
| poi_fail | 导入失败的 | uint32 | |
| poi_size | 导入总数的 | uint32 | 可能为0 |
| poi_success | 导入成功的 | uint32 | |
| status | 状态 | int32 | |
| type | 类型 | int32 |
请求响应示例
根据id查询批量任务（detail job）接口
请求url
http://api.map.baidu.com/geodata/v3/job/detail // GET请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | id | uint64 | 必选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 状态码描述 |
| job | job结果列表 | dict | |
| id | 数据id | string | |
| create_time | 用户创建日期 | string | |
| modify_time | 用户修改时间 | string | |
| error | 错误码 | string | |
| poi_fail | 导入失败的 | uint32 | |
| poi_size | 导入总数的 | uint32 | 可能为0 |
| poi_success | 导入成功的 | uint32 | |
| status | 状态 | int | |
| type | 类型 | int |
请求响应示例
返回码定义值表
0: 成功
1: 服务器内部错误
2: 参数错误
3: http method错误
21: 此操作为批量操作
22: 同步到检索失败
31: 服务端加锁失败
32: 服务端释放锁失败
1001: 表的name重复
1002: 表的数量达到了最大值
1003: 表中存在poi数据，不允许删除
2001: 列的key重复
2002: 列的key是保留字段
2003: 列的数量达到了最大值
2004: 唯一索引只能创建一个
2005: 更新为唯一索引失败，原poi数据中有重复
2011: 排序筛选字段只能用于整数或小数类型的列
2012: 排序筛选的列已经达到了最大值
2021: 检索字段只能用于字符串类型的列且最大长度不能超过512个字节
2022: 检索的列已经达到了最大值
2031: 索引的列已经达到了最大值
2041: 指定的列不存在
2042: 修改max_length必须比原值大
3001: 更新坐标必须包含经纬度和类型
3002: 唯一索引字段存在重复
3031: 上传的文件太大
控制服务错误码：