没有match的答案？试试对话大模型
（→返回码定义值表） |
（→修改指定条件列（column）接口（批量条件修改）） |
||
| 第894行： | 第894行： | ||
http://developer.baidu.com/map/static/img/geodata-8.jpg | http://developer.baidu.com/map/static/img/geodata-8.jpg | ||
| − | === | + | ===修改指定条件列（column）接口=== |
'''请求url''' | '''请求url''' | ||
2015年3月12日 (四) 10:36的版本
云存储字段定义方式
使用说明
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）实体字段定义
| geotable 字段说明 | |||
|---|---|---|---|
| 字段名称 | 字段含义 | 类型 | 备注 |
| id | id，记录唯一的标识 | uint32 | |
| 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/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代表否。设置后可实现方便快速查询。最多设置2个 注：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 | 唯一标识 | 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）管理
创建表（create geotable）接口
请求url
http://api.map.baidu.com/geodata/v3/geotable/create //POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| name | geotable的中文名称 | string(45) | 必选 |
| geotype | geotable持有数据的类型 | int32 | 必选 1：点poi 2：线poi 3：面poi，默认为1 |
| is_published | 是否发布到检索 | int32 | 必选 0：未自动发布到云检索， 1：自动发布到云检索； 策略提示： 注：1）通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。 |
| timestamp | 时间戳 | uint32 | 可选 |
| ak | 用户的访问权限key | string(50) | 必选 |
| sn | 用户的权限签名 | string(50) | 可选 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述 |
| 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) | 必须
对status的英文描述 | |
| 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) | 对status的英文描述 | |
| 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) | 对status的英文描述。 |
请求响应示例
删除表（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) | 对status的英文描述。 |
请求响应示例
创建列（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，针对string有效，并且string时必填。此值代表utf8的汉字个数，不是字节个数 |
| default_value | 默认值 | string(45) | 设置默认值 |
| is_sortfilter_field | 是否检索引擎的数值排序筛选字段 | uint32 | 必选
1代表是，0代表否。设置后效果详见 LBS云检索最多只能设置15个,只有int或者double类型可以设置 |
| is_search_field | 是否检索引擎的文本检索字段 | uint32 | 必选
1,代表支持，0为不支持。只有string可以设置检索字段只能用于字符串类型的列且最大长度不能超过512个字节 |
| is_index_field | 是否存储引擎的索引字段 | uint32 | 必选
用于存储接口查询:1,代表支持，0为不支持。 注：is_index_field=1 时才能在根据该列属性值检索时检索到数据。 |
| is_unique_field | 是否云存储唯一索引字段，方便更新，删除，查询 | uint32 | 可选 用于更新，删除，查询：1代表支持 ，0为不支持 |
| geotable_id | 所属于的geotable_id | string(50) | |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
| 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) | 对status的英文描述 | |
| 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) | 对status的英文描述 | |
| 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 | 是否检索端排序字段 | uint32 | ||
| is_search_field | 是否检索端文本检索字段 | 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代表否。可能会引起批量操作 |
| is_search_field | 是否检索引擎的文本检索字段 | uint32 | 1代表是，0代表否。会引起批量操作 |
| is_index_field | 是否存储引擎的索引字段 | uint32 | 1代表是，0代表否 |
| is_unique_field | 是否存储索引的唯一索引字段 | uint32 | 1代表是，0代表否 |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
请求响应示例
删除指定条件列（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) | 对status的英文描述。 |
请求响应示例
位置数据（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) | 必选，加密后的id 。 |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
| {column key} | 用户在column定义的key/value对 | 开发者自定义的类型（string、int、double） | 唯一索引字段需要保证唯一，否则会创建失败 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
| 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，最大为9 |
| page_size | 分页数目 | uint32 | 默认为10，上限为200 |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
3.2.3 响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
| size | 返回数据条数 | uint32 | 必须 |
| total | 全部的数据条数 | uint32 | 必须，最多返回2000个结果。如果想更多的结果，需要变更查询条件。 |
| pois | poi结果列表 | array | |
| id | 数据id | string | 必选 |
| geotable_id | geotable_id | string | 必选 |
| title | poi名称 | string | 必选 |
| 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) | 对status的英文描述。 |
| poi | poi结果列表 | dict | |
| id | 数据id | string | 当不存在唯一索引字段时必选，存在唯一索引字段时可选 |
| geotable_id | geotable_id | string | 必选 |
| 自定义唯一索引key | Value | 自定义类型 | 可选，若自定义索引字段和id共存时，将以id为准 |
| title | poi名称 | string | 必选 |
| 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) | 必选，加密后的id |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
| {column key} | 用户在column定义的key/value对 | 用户自定义的的列类别 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
请求响应示例
删除单个数据（poi）接口（支持批量）
请求url
http://api.map.baidu.com/geodata/v3/poi/delete // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | 被删除的id | uint64 | 如果传了这个参数，此其它的删除条件会被忽略，此时此操作不是批量请求。只会最多删除一个poi |
| 自定义唯一索引key | Value | 用户自定义类型 | 可选，若自定义索引字段和id共存时，将以id为准，且自定义索引key将被新的value |
| ids | id列表 | 以,分隔的id | 最多1000个id,如果有这个条件,其它条件将被忽略. |
| {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；如果不是批量删除，则不用传这个参数 |
3.5.3 响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
| id | job id | string |
请求响应示例
批量上传数据（post pois csv file）接口
请求url
http://api.map.baidu.com/geodata/v3/poi/upload // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| geotable_id | 导入的geotable的标识 | uint32 | 必须 |
| poi_list | 输入的poi列表名称 | file | 必须，小于10M |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
| timestamp | 时间戳 | uint32 |
导入文件（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) | 对status的英文描述。 |
| job_id | 导入job的id，可以用这个job_id查询这个job后续的导入情况调用job/listimportdata接口详情见下 | string | 必须 |
请求响应示例
附：批量导入示例文件（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 全部 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) | 对status的英文描述。 |
| 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）查询进度接口
批量操作任务查询（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) | 对status的英文描述。 |
| 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 // POST请求
请求参数
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| id | id | uint64 | 必须 |
| ak | 用户的访问权限key | string(50) | 必选。 |
| sn | 用户的权限签名 | string(50) | 可选。 |
响应参数（json格式）
| 参数名 | 参数含义 | 类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int32 | 必须。0代表成功，其它取值含义另行说明 |
| message | 响应的信息 | string(50) | 对status的英文描述。 |
| 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: 上传的文件太大
控制服务错误码：
请参见附录。