{{cloud-sidebar}}
<div class="labels"><div class="interiorNav"><div class="interiorLI">服务介绍</div><div class="interiorLI">服务文档</div><div class="interiorLI">使用指南</div><div class="interiorLI">常见问题</div><div class="interiorLI">更新日志</div></div></div><div class="contents"><div class="navRemark"><div class="handpointto">内容（服务介绍）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">云存储服务V4</div></div><div class="serve-explain-text">
云存储服务是一类Web API接口服务；也是LBS.云系列服务的基础；<br/>用户可在云存储服务中存储并管理自定义的地理数据（位置点&区域面）；<br/>用户可将云存储中管理的数据与多类地图服务打通（JS API、地图SDK等），实现自定义数据展示或解析功能。
</div><div class="bluetitle"><div class="services-title-text">功能介绍</div></div><div class="serveintor-min"><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">稳定高性能的云端存储服务</div>
无需部署服务器，用户可通过云存储服务，完成千万级位置数据存储。<br/>完备的容灾机制，保障服务稳定与数据安全。<br/>优异的服务性能，支持每秒万级并发读写。
</div><div class="serveintorright">

</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">多样化数据管理能力</div>
支持位置点和区域面两种类型的地理数据存储管理。<br/>通过接口功能，可对数据进行增删改查操作。<br/>使用数据管理平台，可便捷的对数据进行可视化编辑。
</div><div class="serveintorright">

</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">地图多服务打通</div>
用户可将云存储中管理的自定义地理数据，与JS API、地图SDK、Web API等服务<br/>打通，实现自定义地理数据展示和解析的扩展应用。
</div><div class="serveintorright">

</div></div></div></div><div class="navRemark"><div class="handpointto">内容（服务文档）<br/></div></div><div class="txtstyle2"><div class="separate-title"><br/>特别注意：</div><div class="serve-explain-text">1.云存储V4版和V3版使用完全不同的服务架构，存储环境也完全不同。使用V3版服务存储的数据不能通过V4版服务访问。<br/>2.如需使用V4版服务，需使用V4版接口上传数据。同时，云存储V4版接口存储的数据，只能通过V4版数据管理平台管理（即将推出）<br/>3.使用服务前请确认服务版本："V4"or"V3"(请求接口URL中有对应标识)</div><div class="bluetitle"><div class="services-title-text service-page-anchor">实体字段定义</div></div><div class="separate-title">位置数据表（geotable）实体字段定义</div>
{|
|-
! width="80" | 字段名
! width="80" style="width: 337px;" | 参数含义
! width="80" style="width: 51px;" | 类型
! width="180" style="width: 207px;" | 备注
|-
| id
| style="width: 319px;" | geotable的id标识
| style="width: 33px;" | uint32
| style="width: 189px;" | geotable的唯一标识
|-
| name<br/>
| style="width: 319px;" | 位置数据表名称<br/>
| style="width: 33px;" | string<br/>
| style="width: 189px;" | <br/>
|-
| user_id<br/>
| style="width: 319px;" | 用户id<br/>
| style="width: 33px;" | uint64<br/>
| style="width: 189px;" | <br/>
|-
| is_published<br/>
| style="width: 319px;" | 是否发布到云检索；1（发布）、0（不发布）<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 数据表创建完成后，仅允许将发布状态做正向修改（0→1），不允许做逆向修改（1→0）<br/>
|-
| create_time<br/>
| style="width: 319px;" | 创建的时间<br/>
| style="width: 33px;" | datetime<br/>
| style="width: 189px;" | <br/>
|-
| modify_time<br/>
| style="width: 319px;" | 最后一次修改的时间<br/>
| style="width: 33px;" | datetime<br/>
| style="width: 189px;" | <br/>
|}
<div class="separate-title">自定义扩展列（column）实体字段定义</div>
{|
|-
! width="80" | 字段名
! width="80" style="width: 337px;" | 参数含义
! width="80" style="width: 51px;" | 类型
! width="180" style="width: 207px;" | 是否必须
! width="180" style="width: 207px;" | 默认值
! width="180" style="width: 207px;" | 备注
|-
| id<br/>
| style="width: 319px;" | 唯一标识
| style="width: 33px;" | uint64
| style="width: 189px;" | 是
| style="width: 189px;" | 无<br/>
| style="width: 189px;" | 该id为创建列时自动生成<br/>
|-
| key<br/>
| style="width: 319px;" | 存储在geotable<br/>的key标识，含义与“id”字段相同，该字段为用户创建时自定义设置<br/>
| style="width: 33px;" | string(64)<br/>
| style="width: 189px;" | 是<br/>
| style="width: 189px;" | 无<br/>
| style="width: 189px;" | 在同一geotable（位置数据表）内唯一正则:<br/>[a-zA-Z][0-9a-zA-Z_]*<br/>
|-
| name<br/>
| style="width: 319px;" | 对key的描述（数据管理平台中，列名对应该字段）<br/>
| style="width: 33px;" | string(128)<br/>
| style="width: 189px;" | 否<br/>
| style="width: 189px;" | 无<br/>
| style="width: 189px;" | <br/>
|-
| type<br/>
| style="width: 319px;" | 
字段类型

1、2、3、4

| style="width: 33px;" | int32
| style="width: 189px;" | 是
| style="width: 189px;" | 无
| style="width: 189px;" | 1:Int64<br/>2:double<br/>3:string<br/>4:在线图片url（LBS图片存储）<br/>
|-
| is_search_field<br/>
| style="width: 319px;" | 是否设置为云检索的排序筛选or检索字段；<br/>1代表是,0代表否<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 是<br/>
| style="width: 189px;" | <br/>
| style="width: 189px;" | 设置后在云检索服务中可根据该字段的内容检索或排序筛选<br/>
若字段为int类型，则为排序筛选字段（做多设置15个）；<br/>若字段为string类型，则为检索字段（最多设置4个）

|-
| is_index_field<br/>
| style="width: 319px;" | 是否将字段设置为云存储的索引字段；<br/>1代表是，0代表否。<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 否<br/>
| style="width: 189px;" | <br/>
| style="width: 189px;" | 设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配）。最多设置3个。<br/>
|-
| create_time<br/>
| style="width: 319px;" | 创建时间<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 是<br/>
| style="width: 189px;" | <br/>
| style="width: 189px;" | Unix时间戳<br/>
|-
| modify_time<br/>
| style="width: 319px;" | 修改时间<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 是<br/>
| style="width: 189px;" | <br/>
| style="width: 189px;" | Unix时间戳<br/>
|}
<div class="separate-title">位置数据（poi）实体字段定义</div>
{|
|-
! width="80" | 字段名
! width="80" style="width: 337px;" | 参数含义
! width="80" style="width: 51px;" | 类型
! width="180" style="width: 207px;" | 备注
|-
| id<br/>
| style="width: 319px;" | id
| style="width: 33px;" | uint64
| style="width: 189px;" | 为唯一标识
|-
| title<br/>
| style="width: 319px;" | 名称<br/>
| style="width: 33px;" | string(256)<br/>
| style="width: 189px;" | <br/>
|-
| tags<br/>
| style="width: 319px;" | 分类标签<br/>
| style="width: 33px;" | string(256)<br/>
| style="width: 189px;" | 参见：POI行业分类<br/>多个tag以空格分隔<br/>
|-
| location<br/>
| style="width: 319px;" | 坐标<br/>
| style="width: 33px;" | array<br/>
| style="width: 189px;" | 格式为：[经度,纬度]或[墨卡托坐标]<br/>
|-
| polygons<br/>
| style="width: 319px;" | 多边形边界坐标点<br/>
| style="width: 33px;" | string<br/>
| style="width: 189px;" | 格式为：经度,纬度;经度,纬度;经度,纬度 <br/>单个多边形最多创建400个边界点，最大字符长度为10240。<br/>
|-
| coord_type<br/>
| style="width: 319px;" | 坐标类型<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | 1（GPS经纬度坐标）<br/>2（国测局加密经纬度坐标）<br/>3（百度加密经纬度坐标，默认）<br/>4（百度加密墨卡托坐标）<br/>
|-
| province<br/>
| style="width: 319px;" | 省<br/>
| style="width: 33px;" | string(32)<br/>
| style="width: 189px;" | <br/>
|-
| city<br/>
| style="width: 319px;" | 市<br/>
| style="width: 33px;" | string(32)<br/>
| style="width: 189px;" | <br/>
|-
| district<br/>
| style="width: 319px;" | 区<br/>
| style="width: 33px;" | string(64)<br/>
| style="width: 189px;" | <br/>
|-
| address<br/>
| style="width: 319px;" | 地址<br/>
| style="width: 33px;" | string(256)<br/>
| style="width: 189px;" | <br/>
|-
| geotable_id<br/>
| style="width: 319px;" | 所属geotable id<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | <br/>
|-
| create_time<br/>
| style="width: 319px;" | 创建时间<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | Unix时间戳<br/>
|-
| modify_time<br/>
| style="width: 319px;" | 最后一次修改的时间<br/>
| style="width: 33px;" | uint32<br/>
| style="width: 189px;" | Unix时间戳<br/>
|}
<div class="bluetitle"><div class="services-title-text">位置数据表（geotable）管理</div></div><div class="bluetitle"><div class="services-title-text service-page-anchor">创建表（create geotable）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/geotable/create  
//云存储V4除批量上传接口服务外，其余接口均支持POST和GET请求，后文不再赘述</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | name<br/>
| style="width: 134px;" | geotable的中文名称<br/>
| style="width: 57px;" | string(45)<br/>
| style="width: 604px;" | 必选<br/>
|-
| style="width: 77px;" | is_published<br/>
| style="width: 134px;" | 是否发布到检索<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 必选 <br/>0：未自动发布到云检索，<br/>1：自动发布到云检索；<br/>注：<br/>1）通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。<br/>2）可通过数据管理平台设置，在表属性设置中将是否发送到检索一栏中选定为是即可。<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 134px;" | 用户的访问权限key<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 必选 申请ak<br/>
|-
| style="width: 77px;" | sn<br/>
| style="width: 134px;" | 用户的权限签名<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 可选,若用户所用AK的校验方式为SN校验时该参数必须（SN生成算法）<br/>若AK设置为SN校验，所有云存储接口均需拼写SN参数，为节省篇幅，后续接口不再单独说明。<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | status<br/>
| style="width: 134px;" | 状态码<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 77px;" | message<br/>
| style="width: 134px;" | 响应的信息<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 77px;" | id<br/>
| style="width: 134px;" | 新增的数据表id<br/>
| style="width: 57px;" | string<br/>
| style="width: 604px;" | 即geotable_id<br/>
|}
<br/><div class="separate-title">请求示例（截图来自chrome浏览器插件："POSTMAN"工具，下同）</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">查询表（list geotable）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/geotable/list</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | name<br/>
| style="width: 134px;" | geotable的名称<br/>
| style="width: 57px;" | string(45)<br/>
| style="width: 604px;" | 可选。若未传该参数，则检索ak管理的所有的位置数据表（geotable）<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 134px;" | 用户的访问权限key<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 必选 申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="2" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="2" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | size<br/>
| style="width: 162px;" | 数据表个数<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 56px;" rowspan="5" colspan="1" | geotables<br/>
| style="width: 79px;" | id<br/>
| style="width: 162px;" | geotable的id<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | name<br/>
| style="width: 162px;" | geotable的名称<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | is_published<br/>
| style="width: 162px;" | 是否发布到云检索<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | create_time<br/>
| style="width: 162px;" | 创建时间<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | modify_time<br/>
| style="width: 162px;" | 修改时间<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">查询指定id表（detail geotable）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/geotable/detail</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 134px;" | 指定geotable的id<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 必选<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 134px;" | 用户的访问权限key<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="2" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="2" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 56px;" rowspan="5" colspan="1" | geotables<br/>
| style="width: 79px;" | id<br/>
| style="width: 162px;" | geotable的id<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | name<br/>
| style="width: 162px;" | geotable的名称<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | is_published<br/>
| style="width: 162px;" | 是否发布到云检索<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | create_time<br/>
| style="width: 162px;" | 创建时间<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 79px;" | modify_time<br/>
| style="width: 162px;" | 修改时间<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="bluetitle"><div class="services-title-text service-page-anchor">修改表（update geotable）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/geotable/update</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 134px;" | 指定geotable的id<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 必选<br/>
|-
| style="width: 77px;" | is_published<br/>
| style="width: 134px;" | 【云检索相关】<br/>是否发布到云检索;<br/>"1"发布，"0"不发布<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 可选<br/>当数据表中有数据时，不允许该字段"1"→"0"，支持"0"→"1"（会触发批量操作，可通过job list接口查询进度）<br/>
|-
| style="width: 77px;" | name<br/>
| style="width: 134px;" | geotable的名称<br/>
| style="width: 57px;" | string(45)<br/>
| style="width: 604px;" | 可选<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 134px;" | 用户的访问权限key<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="2" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="2" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" colspan="2" | id<br/>
| style="width: 162px;" | 批量任务job_id<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 如果有批量任务（如修改数据表发布状态），会返回该id，便于查询任务状态<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="bluetitle"><div class="services-title-text service-page-anchor">删除表（delete geotable）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/geotable/delete</pre>
</div></div><div class="separate-title"><span style="color:#FF0000;">注意：当geotable里面没有位置数据时，才能删除geotable</span></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 134px; text-align: center;" | 参数含义
| style="width: 57px; text-align: center;" | 类型
| style="width: 604px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 134px;" | 指定geotable的id<br/>
| style="width: 57px;" | int32<br/>
| style="width: 604px;" | 必选<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 134px;" | 用户的访问权限key<br/>
| style="width: 57px;" | string(50)<br/>
| style="width: 604px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="2" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="2" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><div class="bluetitle"><div class="services-title-text">数据列（column）管理</div></div><br/><div class="bluetitle"><div class="services-title-text service-page-anchor">创建列（create column）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/column/create</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 227px; text-align: center;" | 参数含义
| style="width: 64px; text-align: center;" | 类型
| style="width: 486px; text-align: center;" | 备注
|-
| style="width: 77px;" | name<br/>
| style="width: 227px;" | column的名称描述<br/>
| style="width: 64px;" | string(45)<br/>
| style="width: 486px;" | 必选<br/>
|-
| style="width: 77px;" | key<br/>
| style="width: 227px;" | column存储的key标识，含义与返回结果中的列“id”字段相同，该字段为用户创建时自定义设置<br/>
| style="width: 64px;" | string(45)<br/>
| style="width: 486px;" | 必选<br/>同一个geotable内的名字不能相同<br/>
|-
| style="width: 77px;" | type<br/>
| style="width: 227px;" | 存储的值的类型<br/>
| style="width: 64px;" | uint32<br/>
| style="width: 486px;" | 必选<br/>枚举值1：Int64, 2：double, 3：string, 4：在线图片url<br/>
|-
| style="width: 77px;" | is_search_field<br/>
| style="width: 227px;" | 【云检索相关】<br/>是否设置为云检索的排序筛选or检索字段；<br/>1代表是，0代表否
| style="width: 64px;" | uint32<br/>
| style="width: 486px;" | 必选<br/>设置后在云检索服务中可根据该字段的内容检索或排序筛选。<br/>若字段为int/double类型，则为排序筛选字段，最多设置15个；<br/>若字段为string类型，则为检索字段，最多设置4个，单字段不超过512字节。
|-
| style="width: 77px;" | is_index_field<br/>
| style="width: 227px;" | 【云存储相关】<br/>是否将字段设置为云存储的索引字段；<br/>1代表是，0代表否。
| style="width: 64px;" | uint32<br/>
| style="width: 486px;" | 必选<br/>设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配，不区分int or string）。最多设置3个。
|-
| style="width: 77px;" | ak<br/>
| style="width: 227px;" | 用户的访问权限key<br/>
| style="width: 64px;" | string(50)<br/>
| style="width: 486px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="2" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="2" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="2" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" colspan="2" | id<br/>
| style="width: 162px;" | column的id<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | 自动生成，和请求中"key"含义相同<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">查询列（list column）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/column/list</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 314px; text-align: center;" | 参数含义
| style="width: 118px; text-align: center;" | 类型
| style="width: 363px; text-align: center;" | 备注
|-
| style="width: 77px;" | name<br/>
| style="width: 314px;" | geotable数据列中对key的描述内容<br/>
| style="width: 118px;" | string(45)<br/>
| style="width: 363px;" | 可选<br/>
|-
| style="width: 77px;" | key<br/>
| style="width: 314px;" | geotable数据列的key标识<br/>
| style="width: 118px;" | string(45)<br/>
| style="width: 363px;" | 可选<br/>
|-
| style="width: 77px;" | geotable_id<br/>
| style="width: 314px;" | 指定geotable的id<br/>
| style="width: 118px;" | string(50)<br/>
| style="width: 363px;" | 必选<br/>若只传该字段，则检索该数据表中所有"列"信息<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 314px;" | 用户的访问权限key<br/>
| style="width: 118px;" | string(50)<br/>
| style="width: 363px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="4" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明     <br/>
|-
| style="width: 166px;" rowspan="1" colspan="4" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" colspan="4" rowspan="1" | size<br/>
| style="width: 166px;" rowspan="1" | 返回数据条数<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" colspan="3" rowspan="9" | columns<br/>
| style="width: 166px;" | id<br/>
| style="width: 162px;" | column的id<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | geotable_id<br/>
| style="width: 162px;" | 所属于的geotable_id<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | name<br/>
| style="width: 162px;" | 列的key描述字段<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | key<br/>
| style="width: 162px;" | 列的标识字段<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | type<br/>
| style="width: 162px;" | 存储的值的类型<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | create_time<br/>
| style="width: 162px;" | 列的创建时间<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | modify_time<br/>
| style="width: 162px;" | 列的修改时间<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | is_search_field<br/>
| style="width: 162px;" | 是否为云检索端检索或排序筛选字段<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | is_index_field<br/>
| style="width: 162px;" | 是否为云存储索引字段<br/>
| style="width: 128px;" | uint32<br/>
| style="width: 535px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">查询指定id列（detail column）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/column/detail</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 314px; text-align: center;" | 参数含义
| style="width: 118px; text-align: center;" | 类型
| style="width: 363px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 314px;" | column的id<br/>
| style="width: 118px;" | uint32<br/>
| style="width: 363px;" | 必选<br/>
|-
| style="width: 77px;" | geotable_id<br/>
| style="width: 314px;" | 数据表的id<br/>
| style="width: 118px;" | uint32<br/>
| style="width: 363px;" | 必选<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 314px;" | 用户的访问权限key<br/>
| style="width: 118px;" | string<br/>
| style="width: 363px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 164px; text-align: center;" | 参数含义
| style="width: 40px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="4" | status<br/>
| style="width: 164px;" | 状态码<br/>
| style="width: 40px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明        <br/>
|-
| style="width: 166px;" rowspan="1" colspan="4" | message<br/>
| style="width: 164px;" | 响应的信息<br/>
| style="width: 40px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" colspan="3" rowspan="9" | columns<br/>
| style="width: 166px;" | id<br/>
| style="width: 164px;" | column的id<br/>
| style="width: 40px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | geotable_id<br/>
| style="width: 164px;" | 所属于的geotable_id<br/>
| style="width: 40px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | name<br/>
| style="width: 164px;" | 列的key描述字段<br/>
| style="width: 40px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | key<br/>
| style="width: 164px;" | 列的标识字段<br/>
| style="width: 40px;" | string<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | type<br/>
| style="width: 164px;" | 存储的值的类型<br/>
| style="width: 40px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | create_time<br/>
| style="width: 164px;" | 列的创建时间<br/>
| style="width: 40px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | modify_time<br/>
| style="width: 164px;" | 列的修改时间<br/>
| style="width: 40px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | is_search_field<br/>
| style="width: 164px;" | 是否为云检索端检索或排序筛选字段<br/>
| style="width: 40px;" | uint32<br/>
| style="width: 535px;" | <br/>
|-
| style="width: 166px;" | is_index_field<br/>
| style="width: 164px;" | 是否为云存储索引字段<br/>
| style="width: 40px;" | uint32<br/>
| style="width: 535px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">修改指定条件列（update column）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/column/update</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 314px; text-align: center;" | 参数含义
| style="width: 71px; text-align: center;" | 类型
| style="width: 401px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 314px;" | column的id<br/>
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 77px;" | geotable_id<br/>
| style="width: 314px;" | 数据表的id<br/>
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 77px;" | name<br/>
| style="width: 314px;" | geotable数据列中对key的描述内容<br/>
| style="width: 71px;" | string(45)<br/>
| style="width: 401px;" | 可选<br/>前缀匹配<br/>
|-
| style="width: 77px;" | is_search_field<br/>
| style="width: 314px;" | 是否设置为云检索的排序筛选or检索字段；<br/>1代表是，0代表否
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 可选<br/>如果数据表中已经有数据，不允许修改此字段。<br/>设置后在云检索服务中可根据该字段的内容检索或排序筛选。<br/>若字段为int/double类型，则为排序筛选字段，最多设置15个；<br/>若字段为string类型，则为检索字段，最多设置4个，单字段不超过512字节。
|-
| style="width: 77px;" | is_index_field<br/>
| style="width: 314px;" | 是否为云存储的索引字段；<br/>1代表是，0代表否
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 可选<br/>如果数据表中已经有数据，不允许修改此字段。<br/>设置后可使用云存储相关检索接口，对该字段数据进行检索（前缀匹配，不区分int or string）。 最多设置3个。
|-
| style="width: 77px;" | ak<br/>
| style="width: 314px;" | 用户的访问权限key<br/>
| style="width: 71px;" | string<br/>
| style="width: 401px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="4" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="4" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><div class="bluetitle"><div class="services-title-text service-page-anchor">删除指定条件列（delete column）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/column/delete</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 77px;" | 参数名
| style="width: 314px; text-align: center;" | 参数含义
| style="width: 71px; text-align: center;" | 类型
| style="width: 401px; text-align: center;" | 备注
|-
| style="width: 77px;" | id<br/>
| style="width: 314px;" | column的id<br/>
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 77px;" | geotable_id<br/>
| style="width: 314px;" | 数据表的id<br/>
| style="width: 71px;" | uint32<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 77px;" | ak<br/>
| style="width: 314px;" | 用户的访问权限key<br/>
| style="width: 71px;" | string<br/>
| style="width: 401px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="4" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明            <br/>
|-
| style="width: 166px;" rowspan="1" colspan="4" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><div class="bluetitle"><div class="services-title-text">位置数据（poi）管理</div></div><div class="bluetitle"><div class="services-title-text service-page-anchor">创建数据（create poi）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/create</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 109px; text-align: center;" | 类型
| style="width: 401px; text-align: center;" | 备注
|-
| style="width: 124px;" | title<br/>
| style="width: 236px;" | 位置数据名称<br/>
| style="width: 109px;" | string(256)<br/>
| style="width: 401px;" | 可选。最多128个utf-8字符<br/>
|-
| style="width: 124px;" | address<br/>
| style="width: 236px;" | 位置数据地址<br/>
| style="width: 109px;" | string(256)<br/>
| style="width: 401px;" | 可选。最多128个utf-8字符<br/>
|-
| style="width: 124px;" | tags<br/>
| style="width: 236px;" | 位置数据类别<br/>
| style="width: 109px;" | string(256)<br/>
| style="width: 401px;" | 可选。最多200个tag，每个tag最长32个字符。<br/>
|-
| style="width: 124px;" | latitude<br/>
| style="width: 236px;" | 用户上传的纬度<br/>
| style="width: 109px;" | double<br/>
| style="width: 401px;" | 必选。非百度墨卡托坐标时，取值为[-90,90]<br/>
|-
| style="width: 124px;" | longitude<br/>
| style="width: 236px;" | 用户上传的经度<br/>
| style="width: 109px;" | double<br/>
| style="width: 401px;" | 必选。非百度墨卡托坐标时，取值为[-180,180]<br/>
|-
| style="width: 124px;" | polygons<br/>
| style="width: 236px;" | 多边形边界点坐标数据<br/>
| style="width: 109px;" | double<br/>
| style="width: 401px;" | 可选<br/>若该字段传入数据，则判定为面状位置数据。<br/>格式为：经度,纬度;经度,纬度;经度,纬度<br/>单个多边形最多创建400个边界点，最大字符长度为10240。
|-
| style="width: 124px;" | coord_type<br/>
| style="width: 236px;" | 用户上传的坐标的类型：1、2、3、4<br/>
| style="width: 109px;" | uint32<br/>
| style="width: 401px;" | 必选<br/>1：GPS经纬度坐标<br/>2：国测局加密经纬度坐标<br/>3：百度加密经纬度坐标<br/>4：百度加密墨卡托坐标<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 创建数据的对应数据表id<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选  申请ak<br/>
|-
| style="width: 124px;" | {column key}<br/>
| style="width: 236px;" | 用户在column定义的key/value对<br/>
| style="width: 109px;" | 用户自定义的类型（string、int、double）<br/>
| style="width: 401px;" | 唯一索引字段必选，且需要保证唯一，否则会创建失败。最大长度2048字节。<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 166px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 162px; text-align: center;" | 参数含义
| style="width: 128px; text-align: center;" | 类型
| style="width: 535px; text-align: center;" | 备注
|-
| style="width: 166px;" rowspan="1" colspan="4" | status<br/>
| style="width: 162px;" | 状态码<br/>
| style="width: 128px;" | int32<br/>
| style="width: 535px;" | 0代表成功，其它取值见文档最后状态码说明           <br/>
|-
| style="width: 166px;" rowspan="1" colspan="4" | message<br/>
| style="width: 162px;" | 响应的信息<br/>
| style="width: 128px;" | string(50)<br/>
| style="width: 535px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 166px;" colspan="4" | id<br/>
| style="width: 162px;" | 新增的位置数据id<br/>
| style="width: 128px;" | string<br/>
| style="width: 535px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="separate-title service-page-anchor">查询指定条件的数据（poi）列表接口</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/list</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 109px; text-align: center;" | 类型
| style="width: 401px; text-align: center;" | 备注
|-
| style="width: 124px;" | {index key}<br/>
| style="width: 236px;" | 用户在column定义的key/value对<br/>
| style="width: 109px;" | 用户自定义的类型（string、int、double）<br/>
| style="width: 401px;" | 可选。column需要设置了is_index_field=1。对于string，是前缀匹配，如需精确匹配请在字段值末尾加$。对于int或者double，则是范围查找，传递的格式为最小值,最大值。当无最小值或者最大值时，用-代替，同时，此字段最大长度不超过50，最小值与最大值都是整数<br/>例：如加入一个命名为color数据类型为string的column，在检索是可设置为“color=red”的形式来检索color字段为red的POI。<br/>如加入一个命名为number数据类型为int的column，在检索是可设置为“number=20,-”的形式来检索number字段值大于等于20的POI。<br/>
|-
| style="width: 124px;" | title<br/>
| style="width: 236px;" | 位置数据名称<br/>
| style="width: 109px;" | string(256)<br/>
| style="width: 401px;" | 可选。最多128个utf-8字符<br/>
|-
| style="width: 124px;" | tags<br/>
| style="width: 236px;" | 位置数据类别<br/>
| style="width: 109px;" | string(256)<br/>
| style="width: 401px;" | 可选。最多200个tag，每个tag最长32个字符，多个tag空格间隔。<br/>
|-
| style="width: 124px;" | bounds
| style="width: 236px;" | 查询的矩形区域
| style="width: 109px;" | string(100)
| style="width: 401px;" | 可选。格式x1,y1;x2,y2分别代表矩形的左上角和右下角。<br/>范围过大时服务易超时，返回数据为空。<br/>建议经度跨度小于0.8，纬度跨度小于0.5。
|-
| style="width: 124px;" | coord_type<br/>
| style="width: 236px;" | 用户上传的坐标的类型：1、2、3、4
| style="width: 109px;" | uint32
| style="width: 401px;" | 必选<br/>1：GPS经纬度坐标<br/>2：国测局加密经纬度坐标<br/>3：百度加密经纬度坐标<br/>4：百度加密墨卡托坐标
|-
| style="width: 124px;" | page_index
| style="width: 236px;" | 分页索引
| style="width: 109px;" | uint32
| style="width: 401px;" | 可选。默认为0<br/>
|-
| style="width: 124px;" | page_size<br/>
| style="width: 236px;" | 分页数目<br/>
| style="width: 109px;" | uint32<br/>
| style="width: 401px;" | 可选。默认为10，上限为200<br/>
|-
| style="width: 124px;" | start_date<br/>
| style="width: 236px;" | 创建日期<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 可选。格式：2017-06-01<br/>
|-
| style="width: 124px;" | end_date<br/>
| style="width: 236px;" | 修改日期<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 可选。格式：2017-06-01<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 创建数据的对应数据表id<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 129px; text-align: center;" | 类型
| style="width: 399px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 129px;" | int32<br/>
| style="width: 399px;" | 0代表成功，其它取值见文档最后状态码说明     <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 129px;" | string(50)<br/>
| style="width: 399px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 120px;" colspan="4" | size<br/>
| style="width: 228px;" | 单页返回的数据条数<br/>
| style="width: 129px;" | uint32<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | pois<br/>
| style="width: 228px;" | poi结果列表<br/>
| style="width: 129px;" | array<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | id<br/>
| style="width: 228px;" | 新增的位置数据id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | geotable_id<br/>
| style="width: 228px;" | 所属数据表id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | title<br/>
| style="width: 228px;" | poi名称<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | location<br/>
| style="width: 228px;" | 百度系坐标<br/>
| style="width: 129px;" | float
| style="width: 399px;" | 格式为：[经度,纬度]<br/>
|-
| style="width: 120px;" colspan="4" | gcj_location<br/>
| style="width: 228px;" | 国测局坐标<br/>
| style="width: 129px;" | float<br/>
| style="width: 399px;" | 格式为：[经度,纬度]<br/>
|-
| style="width: 120px;" colspan="4" | polygons<br/>
| style="width: 228px;" | 边界点坐标<br/>
| style="width: 129px;" | float<br/>
| style="width: 399px;" | 格式为：[经度,纬度]。若该字段为空时不召回。<br/>
|-
| style="width: 120px;" colspan="4" | address<br/>
| style="width: 228px;" | 地址<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | 若该字段为空时不召回。<br/>
|-
| style="width: 120px;" colspan="4" | tags<br/>
| style="width: 228px;" | 标签<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | create_time<br/>
| style="width: 228px;" | 用户创建日期<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | modify_time<br/>
| style="width: 228px;" | 用户修改时间<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | province<br/>
| style="width: 228px;" | 所在的省份<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | city<br/>
| style="width: 228px;" | 所在的城市<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | district<br/>
| style="width: 228px;" | 所在的区<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | {column key}<br/>
| style="width: 228px;" | 用户在column定义的key/value对<br/>
| style="width: 129px;" | 用户自定义的类类别<br/>
| style="width: 399px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="separate-title service-page-anchor">查询指定id的数据（poi）列表接口</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/detail</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 109px; text-align: center;" | 类型
| style="width: 401px; text-align: center;" | 备注
|-
| style="width: 124px;" | id<br/>
| style="width: 236px;" | 位置数据对应的id<br/>
| style="width: 109px;" | uint64<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 创建数据的对应数据表id<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 109px;" | string(50)<br/>
| style="width: 401px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 129px; text-align: center;" | 类型
| style="width: 399px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 129px;" | int32<br/>
| style="width: 399px;" | 0代表成功，其它取值见文档最后状态码说明     <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 129px;" | string(50)<br/>
| style="width: 399px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 120px;" colspan="4" | poi<br/>
| style="width: 228px;" | poi结果列表<br/>
| style="width: 129px;" | dict<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | id<br/>
| style="width: 228px;" | 位置数据id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | geotable_id<br/>
| style="width: 228px;" | 所属数据表id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | title<br/>
| style="width: 228px;" | 位置数据名称<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | location<br/>
| style="width: 228px;" | 百度系坐标<br/>
| style="width: 129px;" | float
| style="width: 399px;" | 格式为：[经度,纬度]<br/>
|-
| style="width: 120px;" colspan="4" | gcj_location<br/>
| style="width: 228px;" | 国测局坐标<br/>
| style="width: 129px;" | float<br/>
| style="width: 399px;" | 格式为：[经度,纬度]<br/>
|-
| style="width: 120px;" colspan="4" | polygons<br/>
| style="width: 228px;" | 边界点坐标<br/>
| style="width: 129px;" | float<br/>
| style="width: 399px;" | 格式为：[经度,纬度]。若该字段为空时不召回。<br/>
|-
| style="width: 120px;" colspan="4" | address<br/>
| style="width: 228px;" | 地址<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | 若该字段为空时不召回。<br/>
|-
| style="width: 120px;" colspan="4" | tags<br/>
| style="width: 228px;" | 标签<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | create_time<br/>
| style="width: 228px;" | 用户创建日期<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | modify_time<br/>
| style="width: 228px;" | 用户修改时间<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | province<br/>
| style="width: 228px;" | 所在的省份<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | city<br/>
| style="width: 228px;" | 所在的城市<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | district<br/>
| style="width: 228px;" | 所在的区<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | <br/>
|-
| style="width: 120px;" colspan="4" | {column key}<br/>
| style="width: 228px;" | 用户在column定义的key/value对<br/>
| style="width: 129px;" | 用户自定义的类类别<br/>
| style="width: 399px;" | <br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="separate-title service-page-anchor">修改数据（update poi）列表接口</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/update</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 167px; text-align: center;" | 类型
| style="width: 346px; text-align: center;" | 备注
|-
| style="width: 124px;" | id<br/>
| style="width: 236px;" | 位置数据对应的id<br/>
| style="width: 167px;" | uint64<br/>
| style="width: 346px;" | 必选<br/>
|-
| style="width: 124px;" | title<br/>
| style="width: 236px;" | 位置数据名称<br/>
| style="width: 167px;" | string(256)<br/>
| style="width: 346px;" | 可选
|-
| style="width: 124px;" | address<br/>
| style="width: 236px;" | 地址<br/>
| style="width: 167px;" | string(256)<br/>
| style="width: 346px;" | 可选<br/>
|-
| style="width: 124px;" | tags<br/>
| style="width: 236px;" | 数据类别<br/>
| style="width: 167px;" | string(256)<br/>
| style="width: 346px;" | 可选<br/>多个tag空格间隔<br/>
|-
| style="width: 124px;" | latitude<br/>
| style="width: 236px;" | 用户上传的纬度<br/>
| style="width: 167px;" | double<br/>
| style="width: 346px;" | 可选<br/>
|-
| style="width: 124px;" | longitude<br/>
| style="width: 236px;" | 用户上传的经度<br/>
| style="width: 167px;" | double<br/>
| style="width: 346px;" | 可选<br/>
|-
| style="width: 124px;" | coord_type<br/>
| style="width: 236px;" | 用户上传的坐标的类型<br/>
| style="width: 167px;" | uint32<br/>
| style="width: 346px;" | 可选。默认3<br/>1．GPS经纬度坐标<br/>2．测局加密经纬度坐标<br/>3．百度加密经纬度坐标<br/>4．百度加密墨卡托坐标<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 创建数据的对应数据表id<br/>
| style="width: 167px;" | string(50)<br/>
| style="width: 346px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 167px;" | string(50)<br/>
| style="width: 346px;" | 必选  申请ak<br/>
|-
| style="width: 124px;" | {column key}<br/>
| style="width: 236px;" | 用户在column定义的key/value对<br/>
| style="width: 167px;" | 用户自定义的的列类别<br/>
| style="width: 346px;" | <br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 129px; text-align: center;" | 类型
| style="width: 399px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 129px;" | int32<br/>
| style="width: 399px;" | 0代表成功，其它取值见文档最后状态码说明    <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 129px;" | string(50)<br/>
| style="width: 399px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="separate-title service-page-anchor">删除数据（delete poi）列表接口</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/delete</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 149px; text-align: center;" | 类型
| style="width: 364px; text-align: center;" | 备注
|-
| style="width: 124px;" | id<br/>
| style="width: 236px;" | 被删除的位置数据id<br/>
| style="width: 149px;" | uint64<br/>
| style="width: 364px;" | 可选。<br/>如果设置了这个参数，其余删除条件会被忽略，只会根据id删除单条poi。此时此操作不是批量请求。<br/>除该字段外，该接口其他字段均会触发批量任务，任务状态请通过job list接口查看<br/><br/>
|-
| style="width: 124px;" | ids<br/>
| style="width: 236px;" | id列表<br/>
| style="width: 149px;" | 以,分隔的id<br/>
| style="width: 364px;" | 可选。最多1000个id，如果设置了批量删除is_total_del = 1并且没有设置id字段，则优先根据ids删除多条poi, 其它条件将被忽略.<br/>
|-
| style="width: 124px;" | {index key}<br/>
| style="width: 236px;" | 用户在column定义的key/value对<br/>
| style="width: 149px;" | 用户自定义的的列类别<br/>
| style="width: 364px;" | 可选。column需要设置了is_index_field=1。<br/>字段类型为string，是精确匹配【例：price=high】；<br/>字段类型为int或者double，是范围查找，传递的格式为：最小值,最大值。当无最小值或者最大值时，用-代替，同时，此字段最大长度不超过50，最小值与最大值都是整数【例：price=50,-】。<br/>
|-
| style="width: 124px;" | title<br/>
| style="width: 236px;" | 位置数据名称<br/>
| style="width: 149px;" | string(256)<br/>
| style="width: 364px;" | 可选。精确匹配
|-
| style="width: 124px;" | tags<br/>
| style="width: 236px;" | 数据类别<br/>
| style="width: 149px;" | string(256)<br/>
| style="width: 364px;" | 可选。精确匹配<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 删除数据所在的数据表id<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选  申请ak<br/>
|-
| style="width: 124px;" | is_total_del<br/>
| style="width: 236px;" | 标记为批量删除<br/>
| style="width: 149px;" | int32<br/>
| style="width: 364px;" | 可选。<br/>如需删除一条以上数据，在设定数据范围的条件时，还需要将该字段设为1。 <br/><span style="color:#FF0000;">注意：若仅设为1，而不设定数据范围的条件（如不指定ids、tag等），则默认为删除全表数据</span><br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 129px; text-align: center;" | 类型
| style="width: 399px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 129px;" | int32<br/>
| style="width: 399px;" | 0代表成功，其它取值见文档最后状态码说明     <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 129px;" | string(50)<br/>
| style="width: 399px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 120px;" colspan="4" | id<br/>
| style="width: 228px;" | 批量任务的job id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | 如为批量删除，会返回该字段。job id可通过job list接口查看任务状态
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="separate-title service-page-anchor">批量上传数据（upload poi）列表接口</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/poi/upload  //仅支持POST接口</pre>
</div></div> 注意：该接口每日限调用100次。批量上传视数据量大小，完整上传耗时不同。若对数据的实时性要求较高，建议通过“创建数据（create poi）接口”实现。<br/><div class="separate-title">请求参数-接口</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 149px; text-align: center;" | 类型
| style="width: 364px; text-align: center;" | 备注
|-
| style="width: 124px;" | poi_list<br/>
| style="width: 236px;" | 输入的位置数据列表名称<br/>
| style="width: 149px;" | <span style="color:#FF0000;">file</span><br/>
| style="width: 364px;" | 必选。单次上传的数据表小于1000条数据<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 删除数据所在的数据表id<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选  申请ak<br/>
|}

导入文件（poi_list对应的文件）的csv格式（自定义字段需与默认字段间隔一个空列）：<br/><br/><br/>数据列（必选字段）-上传文件

{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 149px; text-align: center;" | 类型
| style="width: 364px; text-align: center;" | 备注
|-
| style="width: 124px;" | title<br/>
| style="width: 236px;" | poi名称<br/>
| style="width: 149px;" | string(45)<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | latitude<br/>
| style="width: 236px;" | 用户上传的纬度<br/>
| style="width: 149px;" | double<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | longitude<br/>
| style="width: 236px;" | 用户上传的经度<br/>
| style="width: 149px;" | double<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | coord_type<br/>
| style="width: 236px;" | 用户上传的坐标的类型<br/>
| style="width: 149px;" | uint32<br/>
| style="width: 364px;" | 必选<br/>1.GPS经纬度坐标<br/>2.国测局加密经纬度坐标<br/>3.百度加密经纬度坐标<br/>4.百度加密墨卡托坐标<br/>
|-
| style="width: 124px;" | {column key}<br/>
| style="width: 236px;" | 用户在column定义的key/value对<br/>
| style="width: 149px;" | 用户自定义的类类别<br/>
| style="width: 364px;" | 可选。<br/>文件中，自定义字段需与前几个默认字段间隔一个空列。<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 删除数据所在的数据表id<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选  申请ak
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 129px; text-align: center;" | 类型
| style="width: 399px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 129px;" | int32<br/>
| style="width: 399px;" | 0代表成功，其它取值见文档最后状态码说明   <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 129px;" | string(50)<br/>
| style="width: 399px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 120px;" colspan="4" | id<br/>
| style="width: 228px;" | 导入文件的job id<br/>
| style="width: 129px;" | string<br/>
| style="width: 399px;" | 使用job list接口，可查看文件上传状态
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><br/><div class="bluetitle"><div class="services-title-text">批量操作任务（JOB）查询进度接口</div></div><div class="bluetitle"><div class="services-title-text service-page-anchor">批量操作任务查询（list job）接口</div></div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geodata/v4/job/list</pre>
</div></div><div class="separate-title">请求参数</div>
{|
|-
| style="text-align: center; width: 124px;" | 参数名
| style="width: 236px; text-align: center;" | 参数含义
| style="width: 149px; text-align: center;" | 类型
| style="width: 364px; text-align: center;" | 备注
|-
| style="width: 124px;" | id<br/>
| style="width: 236px;" | 批量任务的job id<br/>
| style="width: 149px;" | int32<br/>
| style="width: 364px;" | 必选。单次上传的数据表小于1000条数据<br/>
|-
| style="width: 124px;" | page_size<br/>
| style="width: 236px;" | 分页大小（单页召回的数据量）<br/>
| style="width: 149px;" | int32<br/>
| style="width: 364px;" | 可选。默认10，上限200<br/>
|-
| style="width: 124px;" | page_index<br/>
| style="width: 236px;" | 翻页<br/>
| style="width: 149px;" | int32<br/>
| style="width: 364px;" | 可选。0为第一页<br/>
|-
| style="width: 124px;" | geotable_id<br/>
| style="width: 236px;" | 删除数据所在的数据表id<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 可选。若未传geotable_id，则查询该ak账号下所有批量任务<br/>
|-
| style="width: 124px;" | ak<br/>
| style="width: 236px;" | 用户的访问权限key<br/>
| style="width: 149px;" | string(50)<br/>
| style="width: 364px;" | 必选  申请ak<br/>
|}
<div class="separate-title">返回参数（json格式）</div>
{|
|-
| style="text-align: center; width: 120px;" rowspan="1" colspan="4" | 参数名<br/>
| style="width: 228px; text-align: center;" | 参数含义
| style="width: 99px; text-align: center;" | 类型
| style="width: 429px; text-align: center;" | 备注
|-
| style="width: 120px;" rowspan="1" colspan="4" | status<br/>
| style="width: 228px;" | 状态码<br/>
| style="width: 99px;" | int32<br/>
| style="width: 429px;" | 0代表成功，其它取值见文档最后状态码说明   <br/>
|-
| style="width: 120px;" rowspan="1" colspan="4" | message<br/>
| style="width: 228px;" | 响应的信息<br/>
| style="width: 99px;" | string(50)<br/>
| style="width: 429px;" | 状态码描述，成功时返回“OK”，失败返回对应信息<br/>
|-
| style="width: 120px;" colspan="4" | jobs<br/>
| style="width: 228px;" | job结果列表<br/>
| style="width: 99px;" | array<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | id<br/>
| style="width: 228px;" | 批量任务job id<br/>
| style="width: 99px;" | string<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | create_time<br/>
| style="width: 228px;" | 用户创建日期<br/>
| style="width: 99px;" | string<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | modify_time<br/>
| style="width: 228px;" | 用户修改日期<br/>
| style="width: 99px;" | string<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | type<br/>
| style="width: 228px;" | 任务类型<br/>
| style="width: 99px;" | string<br/>
| style="width: 429px;" | sync（发布至云检索）/delete（删除）/uplode（发布至云存储）<br/>
|-
| style="width: 120px;" colspan="4" | uplode_num<br/>
| style="width: 228px;" | 导入成功的位置数据数量<br/>
| style="width: 99px;" | uint32<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | delete_num<br/>
| style="width: 228px;" | 删除位置数据的数量<br/>
| style="width: 99px;" | uint32<br/>
| style="width: 429px;" | <br/>
|-
| style="width: 120px;" colspan="4" | status<br/>
| style="width: 228px;" | 查询任务的状态<br/>
| style="width: 99px;" | int32<br/>
| style="width: 429px;" | 0（成功）；1（运行）；2（失败） 注意与状态码“status”区分
|}
<br/><div class="separate-title">请求示例</div><div class="separate-title">返回结果示例</div><br/><div class="bluetitle"><div class="services-title-text service-page-anchor">状态码定义表</div></div>
{|
|-
| style="width: 94px;" | 状态码
| style="width: 453px;" | 含义
| style="width: 292px;" | 备注
|-
| style="width: 94px;" | 0
| style="width: 453px;" | 成功
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 1
| style="width: 453px;" | 这是批量任务, 可通过job接口查询任务状态<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 11
| style="width: 453px;" | 未知错误<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 20<br/>
| style="width: 453px;" | geotable不存在<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 21<br/>
| style="width: 453px;" | geotable的数量达到上限<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 22<br/>
| style="width: 453px;" | column的数量达到上限<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 23<br/>
| style="width: 453px;" | is_search_field数量达到上限<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 24<br/>
| style="width: 453px;" | is_index_field数量达到上限<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 25<br/>
| style="width: 453px;" | geotable的name重复<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 26<br/>
| style="width: 453px;" | column的key重复<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 27<br/>
| style="width: 453px;" | bounds超过最大范围<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 28<br/>
| style="width: 453px;" | 此操作需要表中没有任何poi数据<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 30<br/>
| style="width: 453px;" | 参数错误|过滤条件有错误|坐标转换失败|content-type错误|http的method错误|http的头部错误<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 31<br/>
| style="width: 453px;" | name: 参数不存在|key: 参数不存在|id: 参数不存在|type: 参数不存在|geotable_id: 参数不存在|longitude/latitude: 参数不存在|coord_type: 参数不存在|poi_list: 参数不存在|type: URL不能作为检索/索引字段<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 302<br/>
| style="width: 453px;" | 天配额超限，限制访问。<span style="color:#FF0000;">配额超限，对此错误码不需要重试消耗配额和并发资源，如果想增加配额请</span>联系我们<br/>
| style="width: 292px;" | <br/>
|-
| style="width: 94px;" | 401<br/>
| style="width: 453px;" | 当前并发量已经超过约定并发配额，限制访问。<span style="color:#FF0000;">并发控制超限，对此错误码不需要重试消耗配额和并发资源，请控制并发量或</span>联系我们<br/>
| style="width: 292px;" | <br/>
|}
</div><div class="navRemark"><div class="handpointto">内容（使用指南）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法<br/></div></div><div class="devguide"><div class="leftborderbg" style="height:1500px;"></div><div class="devguideorder"><span>1</span>申请百度账号</div><div class="devguidecenter">百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 点此申请</div><div class="devguideorder"><span>2</span>申请成为百度开发者</div><div class="devguidecenter">登录百度账号后，请申请百度地图开放平台开发者，即可开始使用相关服务。 点此申请</div><div class="devguideorder"><span>3</span>获取服务密钥（ak）</div><div class="devguidecenter">发送服务请求，需使用ak参数进行鉴权（必须）。发送服务请求前需先创建ak。 点此创建</div><div class="devguideorder"><span>4</span>使用云存储服务，创建位置数据表</div><div class="devguidecenter">使用云地理编码解析自定义地理数据，首先需使用云存储服务，创建位置数据表，编辑自定义地址数据。创建数据表成功，获取位置数据表id（geotable_id）</div><div class="devguideorder"><span>5</span>拼写请求URL，使用云存储相关服务<br/></div><div class="devguidecenter">拼写请求URL，使用geotable_id，使用云存储相关接口服务。</div></div><div class="bluetitle"><div class="services-title-text">编码说明<br/></div></div>
API请求中需要用到中文或一些特殊字符的参数，如query、region等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成UTF-8字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。

{|
|-
| style="text-align: center; width: 91px;" | 字符集合
| style="width: 823px; text-align: center;" | 字符
|-
| style="text-align: center; width: 91px;" | URL非保留字<br/>
| style="width: 823px;" | 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 - _ . ~<br/>
|-
| style="text-align: center; width: 91px;" | URL保留字<br/>
| style="width: 823px;" |  ! * ' ( ) ; : @ & = + $ , / ? % # [ ]<br/>
|}

如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。<br/><br/>附注：

{{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

{{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

{{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

{{bluepoint}}php中可以使用函数urlencode对特殊字符进行编码。
<div class="bluetitle"><div class="services-title-text">坐标系说明</div></div>
{{bluepoint}}WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。<br/><br/>{{bluepoint}}GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。<br/><br/>{{bluepoint}}BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标<br/><br/>{{bluepoint}}Place Suggestion API默认输入输出坐标类型为百度坐标（BD09），同时可通过参数（"coord_type","ret_coordtype"）控制输入输出坐标类型。输入坐标支持以上三种坐标系，输出坐标支持-国测局坐标（GCJ02）和百度坐标（BD09）<br/><br/><span style="color:#FF0000;">注意：不同类型坐标如需转换，请使用百度地图开放平台提供的</span>标准坐标转换接口<span style="color:#FF0000;">。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。</span>
<div class="bluetitle"><div class="services-title-text">服务配额</div></div>
{{bluepoint}}每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数（即配额）是有限的。

{{bluepoint}}每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数（即并发量）是有限的。

{{bluepoint}}若需要更高配额和并发量，请申请开发者认证以获取更高配额和更及时的技术支持。

{{bluepoint}}同一个账号下的HTTP/HTTPS请求，配额，并发共享。



配额及默认并发量说明如下
<div class="tablecenter">
{|
|-
! width="220" | 分类
! width="270" | 未认证
! width="220" | 个人认证
! width="270" | 企业认证
|-
| 日配额（次）
| 100,000
| 300,000
| 3,000,000
|-
| 分钟并发数（次/分钟）
| 6,000
| 12,000
| 30,000
|}
</div></div><div class="navRemark"><div class="handpointto">内容（常见问题）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">服务常见问题</div></div><div class="serve-explain-text"><div class="serveintoor-title">1、之前有通过云存储服务存储数据，为什么现在查询不到了？</div>
在排除未进行过删除数据操作的前提下，请查看云存储服务的使用版本（请求中有明确标识）。<br/>云存储V4版服务于2017年7月31日发布，之前使用的云存储服务为V3及以下版本。<br/>V4版服务与之前版本服务数据不相通。及，使用历史版本云存储存储的数据，无法通过V4版云存储相关接口查询，反之亦然。<br/>若有使用云存储V4版服务需求，请对历史版本服务数据进行迁移。若数据量过于庞大，可联系我们协助操作。
</div><div class="serve-explain-text"><div class="serveintoor-title">2、我存储在云存储服务中的数据，会被其他用户访问吗？</div>
稳定性和数据安全是云存储服务的最基本要求。<br/>所有存储在云存储服务中的数据都以数据表为单位进行独立存储，以保障数据安全，不被他人窃取。<br/>每次对数据进行管理操作，均需同时传入数据表ID（geotabel id）和服务访问密钥（AK）进行融合鉴权。其他用户无权访问，请放心使用。
</div><br/></div><div class="navRemark"><div class="handpointto">内容（更新日志）</div></div><div class="txtstyle2"><div class="updatedemo"><div class="uptitle"><div class="next timecut"></div><div class="prve timecut"></div><div class="updatetime"><div class="controlshow"><div class="timeversions">
2013年7月25日

V2.0
</div><div class="timeversions">
2013年10月24日

V2.1
</div><div class="timeversions">
2013年11月7日

V2.2
</div><div class="timeversions">
2013年12月12日

V2.3
</div><div class="timeversions">
2014年1月20日

V3.0
</div><div class="timeversions intro">
2017年7月31日

V4.0
</div></div></div><div class="linellae"></div></div><div class="updatecenter"><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">PC、Android、iOS端的LBS.云DEMO。</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">服务优化</div></div><div class="serve-explain-text">简化数据结构：将Databox、Databox_meta、POI、POI_EXT等参数修改为：geotable（表）、column（列）、POI（记录），建立更符合数据库概念的数据管理方式。<br/>优化与更新批量操作：提高数据管理能力，在存储引擎提供一定能力的空间索引和文本索引，支持按条件批量的更新和删除操作，方便数据管理阶段的数据维护。<br/>大幅度提升存储性能：支持单geotable亿数量级存储，每天百万次的读写操作，每秒千次的并发读写操作。<br/>支持国外数据的存储，但不进行检索建库。</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">修改：Location备注内容。<br/>新增coord_type字段。</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">支持唯一索引字段 ，对应字段名“is-unique-field”；更方便更新、删除以及查询。
优化批量上传接口，增加查看进度接口。
</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">产品上线</div></div><div class="serve-explain-text">LBS.云存储：在原有支持int、double和string类型数据存储基础上添加图片存储功能（需发送邮件申请）。<br/>LBS.云检索：支持对属性值为离散数值类型的POI的筛选。<br/>文档修改：
支持对属性值为离散数值类型的POI的筛选。<br/>用户有自定义权限的字段进一步详细说明如何定义以及定义后效果。<br/>有些参数的使用方法开发者不太清楚，给出详细的url 举例。<br/>注：与LBS.云V2.0相比，LBS.云V3.0新增功能汇总如下：

支持对属性值为离散数值类型的POI的筛选。<br/>在原有支持int、double和string类型数据存储基础上添加图片存储功能。<br/>添加唯一索引扩展字段存储功能。<br/>优化批量上传接口，增加查看进度接口。<br/>支持将检索结果按多字段进行排序的功能。<br/>支持唯一索引字段 。
</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">产品上线</div></div><div class="serve-explain-text">新增面数据管理功能。用户可通过服务存储并管理面状位置数据。<br/>优化接口类型。对不常用或易用性较差的接口做部分删减或融合。接口整体更加精简。<br/>优化服务架构，服务性能大幅提升。<br/>新增容灾机制，数据安全保障能力大幅提升。</div></div></div></div></div></div>