(以“{{cloud-sidebar}}<br/><div class="labels"><div class="interiorNav"><div class="interiorLI">服务介绍</div><div clas...”为内容创建页面) |
|||
第1行: | 第1行: | ||
− | + | {{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"> | ||
+ | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geodata1.png | ||
+ | </div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">多样化数据管理能力</div> | ||
+ | 支持位置点和区域面两种类型的地理数据存储管理。<br/>通过接口功能,可对数据进行增删改查操作。<br/>使用[http://lbsyun.baidu.com/data/mydata 数据管理平台],可便捷的对数据进行可视化编辑。 | ||
+ | </div><div class="serveintorright"> | ||
+ | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geodata2.png | ||
+ | </div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">地图多服务打通</div> | ||
+ | 用户可将云存储中管理的自定义地理数据,与JS API、地图SDK、Web API等服务<br/>打通,实现自定义地理数据展示和解析的扩展应用。 | ||
+ | </div><div class="serveintorright"> | ||
+ | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geodata3.png | ||
+ | </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的描述([http://lbsyun.baidu.com/data/mydata 数据管理平台]中,列名对应该字段)<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;" | 参见:[http://lbsyun.baidu.com/index.php?title=lbscloud/poitags 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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请ak]<br/> | ||
+ | |- | ||
+ | | style="width: 77px;" | sn<br/> | ||
+ | | style="width: 134px;" | 用户的权限签名<br/> | ||
+ | | style="width: 57px;" | string(50)<br/> | ||
+ | | style="width: 604px;" | 可选,若用户所用AK的校验方式为SN校验时该参数必须([http://lbsyun.baidu.com/index.php?title=lbscloud/api/appendix 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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E8%A1%A8-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E8%A1%A8-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%A0%E9%99%A4%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%A0%E9%99%A4%E8%A1%A8%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/column_update_request.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%A0%E9%99%A4%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%A0%E9%99%A4%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6%E5%88%97%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%9B%E5%BB%BA%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9A%E6%9D%A1%E4%BB%B6POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E7%9A%84POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%9F%A5%E8%AF%A2%E6%8C%87%E5%AE%9Aid%E7%9A%84POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%821.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E5%88%A0%E9%99%A4POI%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E4%BF%AE%E6%94%B9POI%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请ak]<br/> | ||
+ | |} | ||
+ | |||
+ | 导入文件(poi_list对应的文件)的csv格式(自定义字段需与默认字段间隔一个空列):<br/>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%A0%BC%E5%BC%8F.jpeg<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%89%B9%E9%87%8F%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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;" | '''必选 '''[http://lbsyun.baidu.com/apiconsole/key/create 申请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>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%89%B9%E9%87%8F%E6%93%8D%E4%BD%9C%E4%BB%BB%E5%8A%A1%E6%9F%A5%E8%AF%A2%E6%8E%A5%E5%8F%A3-%E8%AF%B7%E6%B1%82.png<div class="separate-title">返回结果示例</div>http://mapopen-website-wiki.bj.bcebos.com/lbscloud/img/%E6%89%B9%E9%87%8F%E6%93%8D%E4%BD%9C%E4%BB%BB%E5%8A%A1%E6%9F%A5%E8%AF%A2%E6%8E%A5%E5%8F%A3-%E7%BB%93%E6%9E%9C.png<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>[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]<br/> | ||
+ | | style="width: 292px;" | <br/> | ||
+ | |- | ||
+ | | style="width: 94px;" | 401<br/> | ||
+ | | style="width: 453px;" | 当前并发量已经超过约定并发配额,限制访问。<span style="color:#FF0000;">并发控制超限,对此错误码不需要重试消耗配额和并发资源,请控制并发量或</span>[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]<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">百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 [https://passport.baidu.com/v2/?reg&tt=1495093911000&gid=8931E63-8868-4768-BCA2-ECD56CFB963B&tpl=mn&u=https://www.baidu.com/ 点此申请]</div><div class="devguideorder"><span>2</span>申请成为百度开发者</div><div class="devguidecenter">登录百度账号后,请申请百度地图开放平台开发者,即可开始使用相关服务。 [http://lbsyun.baidu.com/apiconsole/key 点此申请]</div><div class="devguideorder"><span>3</span>获取服务[http://lbsyun.baidu.com/apiconsole/key/create 密钥](ak)</div><div class="devguidecenter">发送服务请求,需使用ak参数进行鉴权(必须)。发送服务请求前需先创建ak。 [http://lbsyun.baidu.com/apiconsole/key/create 点此创建]</div><div class="devguideorder"><span>4</span>使用云存储服务,创建位置数据表</div><div class="devguidecenter">使用云地理编码解析自定义地理数据,首先需使用[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务,创建位置数据表,编辑自定义地址数据。创建数据表成功,获取位置数据表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>[http://lbsyun.baidu.com/index.php?title=webapi/guide/changeposition 标准坐标转换接口]<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版服务需求,请对历史版本服务数据进行迁移。若数据量过于庞大,可[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]协助操作。 | ||
+ | </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类型数据存储基础上添加图片存储功能(需[mailto:mapapi@baidu.com 发送邮件]申请)。<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> |
2017年10月26日 (四) 05:44的版本
云存储服务是一类Web API接口服务;也是LBS.云系列服务的基础;
用户可在云存储服务中存储并管理自定义的地理数据(位置点&区域面);
用户可将云存储中管理的数据与多类地图服务打通(JS API、地图SDK等),实现自定义数据展示或解析功能。
无需部署服务器,用户可通过云存储服务,完成千万级位置数据存储。
完备的容灾机制,保障服务稳定与数据安全。
优异的服务性能,支持每秒万级并发读写。
支持位置点和区域面两种类型的地理数据存储管理。
通过接口功能,可对数据进行增删改查操作。
使用数据管理平台,可便捷的对数据进行可视化编辑。
用户可将云存储中管理的自定义地理数据,与JS API、地图SDK、Web API等服务
打通,实现自定义地理数据展示和解析的扩展应用。
特别注意:
2.如需使用V4版服务,需使用V4版接口上传数据。同时,云存储V4版接口存储的数据,只能通过V4版数据管理平台管理(即将推出)
3.使用服务前请确认服务版本:"V4"or"V3"(请求接口URL中有对应标识)
字段名 | 参数含义 | 类型 | 备注 |
---|---|---|---|
id | geotable的id标识 | uint32 | geotable的唯一标识 |
name |
位置数据表名称 |
string |
|
user_id |
用户id |
uint64 |
|
is_published |
是否发布到云检索;1(发布)、0(不发布) |
uint32 |
数据表创建完成后,仅允许将发布状态做正向修改(0→1),不允许做逆向修改(1→0) |
create_time |
创建的时间 |
datetime |
|
modify_time |
最后一次修改的时间 |
datetime |
|
字段名 | 参数含义 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|---|
id |
唯一标识 | uint64 | 是 | 无 |
该id为创建列时自动生成 |
key |
存储在geotable 的key标识,含义与“id”字段相同,该字段为用户创建时自定义设置 |
string(64) |
是 |
无 |
在同一geotable(位置数据表)内唯一正则: [a-zA-Z][0-9a-zA-Z_]* |
name |
对key的描述(数据管理平台中,列名对应该字段) |
string(128) |
否 |
无 |
|
type |
字段类型 1、2、3、4 |
int32 | 是 | 无 | 1:Int64 2:double 3:string 4:在线图片url(LBS图片存储) |
is_search_field |
是否设置为云检索的排序筛选or检索字段; 1代表是,0代表否 |
uint32 |
是 |
|
设置后在云检索服务中可根据该字段的内容检索或排序筛选 若字段为int类型,则为排序筛选字段(做多设置15个); |
is_index_field |
是否将字段设置为云存储的索引字段; 1代表是,0代表否。 |
uint32 |
否 |
|
设置后可使用云存储相关检索接口,对该字段数据进行检索(前缀匹配)。最多设置3个。 |
create_time |
创建时间 |
uint32 |
是 |
|
Unix时间戳 |
modify_time |
修改时间 |
uint32 |
是 |
|
Unix时间戳 |
字段名 | 参数含义 | 类型 | 备注 |
---|---|---|---|
id |
id | uint64 | 为唯一标识 |
title |
名称 |
string(256) |
|
tags |
分类标签 |
string(256) |
参见:POI行业分类 多个tag以空格分隔 |
location |
坐标 |
array |
格式为:[经度,纬度]或[墨卡托坐标] |
polygons |
多边形边界坐标点 |
string |
格式为:经度,纬度;经度,纬度;经度,纬度 单个多边形最多创建400个边界点,最大字符长度为10240。 |
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时间戳 |
http://api.map.baidu.com/geodata/v4/geotable/create //云存储V4除批量上传接口服务外,其余接口均支持POST和GET请求,后文不再赘述
参数名 | 参数含义 | 类型 | 备注 |
name |
geotable的中文名称 |
string(45) |
必选 |
is_published |
是否发布到检索 |
int32 |
必选 0:未自动发布到云检索, 1:自动发布到云检索; 注: 1)通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。 2)可通过数据管理平台设置,在表属性设置中将是否发送到检索一栏中选定为是即可。 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
sn |
用户的权限签名 |
string(50) |
可选,若用户所用AK的校验方式为SN校验时该参数必须(SN生成算法) 若AK设置为SN校验,所有云存储接口均需拼写SN参数,为节省篇幅,后续接口不再单独说明。 |
参数名 | 参数含义 | 类型 | 备注 |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 |
id |
新增的数据表id |
string |
即geotable_id |
http://api.map.baidu.com/geodata/v4/geotable/list
参数名 | 参数含义 | 类型 | 备注 |
name |
geotable的名称 |
string(45) |
可选。若未传该参数,则检索ak管理的所有的位置数据表(geotable) |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |
size |
数据表个数 |
int32 |
| |
geotables |
id |
geotable的id |
string |
|
name |
geotable的名称 |
string |
| |
is_published |
是否发布到云检索 |
int32 |
| |
create_time |
创建时间 |
string |
| |
modify_time |
修改时间 |
string |
|
http://api.map.baidu.com/geodata/v4/geotable/detail
参数名 | 参数含义 | 类型 | 备注 |
id |
指定geotable的id |
int32 |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |
geotables |
id |
geotable的id |
string |
|
name |
geotable的名称 |
string |
| |
is_published |
是否发布到云检索 |
int32 |
| |
create_time |
创建时间 |
string |
| |
modify_time |
修改时间 |
string |
|
http://api.map.baidu.com/geodata/v4/geotable/update
参数名 | 参数含义 | 类型 | 备注 |
id |
指定geotable的id |
int32 |
必选 |
is_published |
【云检索相关】 是否发布到云检索; "1"发布,"0"不发布 |
int32 |
可选 当数据表中有数据时,不允许该字段"1"→"0",支持"0"→"1"(会触发批量操作,可通过job list接口查询进度) |
name |
geotable的名称 |
string(45) |
可选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |
id |
批量任务job_id |
int32 |
如果有批量任务(如修改数据表发布状态),会返回该id,便于查询任务状态 |
http://api.map.baidu.com/geodata/v4/geotable/delete
参数名 | 参数含义 | 类型 | 备注 |
id |
指定geotable的id |
int32 |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 |
http://api.map.baidu.com/geodata/v4/column/create
参数名 | 参数含义 | 类型 | 备注 |
name |
column的名称描述 |
string(45) |
必选 |
key |
column存储的key标识,含义与返回结果中的列“id”字段相同,该字段为用户创建时自定义设置 |
string(45) |
必选 同一个geotable内的名字不能相同 |
type |
存储的值的类型 |
uint32 |
必选 枚举值1:Int64, 2:double, 3:string, 4:在线图片url |
is_search_field |
【云检索相关】 是否设置为云检索的排序筛选or检索字段; 1代表是,0代表否 |
uint32 |
必选 设置后在云检索服务中可根据该字段的内容检索或排序筛选。 若字段为int/double类型,则为排序筛选字段,最多设置15个; 若字段为string类型,则为检索字段,最多设置4个,单字段不超过512字节。 |
is_index_field |
【云存储相关】 是否将字段设置为云存储的索引字段; 1代表是,0代表否。 |
uint32 |
必选 设置后可使用云存储相关检索接口,对该字段数据进行检索(前缀匹配,不区分int or string)。最多设置3个。 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |
id |
column的id |
uint32 |
自动生成,和请求中"key"含义相同 |
http://api.map.baidu.com/geodata/v4/column/list
参数名 | 参数含义 | 类型 | 备注 |
name |
geotable数据列中对key的描述内容 |
string(45) |
可选 |
key |
geotable数据列的key标识 |
string(45) |
可选 |
geotable_id |
指定geotable的id |
string(50) |
必选 若只传该字段,则检索该数据表中所有"列"信息 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
size |
返回数据条数 |
uint32 |
| |||
columns |
id |
column的id |
string |
| ||
geotable_id |
所属于的geotable_id |
string |
| |||
name |
列的key描述字段 |
string |
| |||
key |
列的标识字段 |
string |
| |||
type |
存储的值的类型 |
uint32 |
| |||
create_time |
列的创建时间 |
uint32 |
| |||
modify_time |
列的修改时间 |
uint32 |
| |||
is_search_field |
是否为云检索端检索或排序筛选字段 |
uint32 |
| |||
is_index_field |
是否为云存储索引字段 |
uint32 |
|
http://api.map.baidu.com/geodata/v4/column/detail
参数名 | 参数含义 | 类型 | 备注 |
id |
column的id |
uint32 |
必选 |
geotable_id |
数据表的id |
uint32 |
必选 |
ak |
用户的访问权限key |
string |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
columns |
id |
column的id |
string |
| ||
geotable_id |
所属于的geotable_id |
string |
| |||
name |
列的key描述字段 |
string |
| |||
key |
列的标识字段 |
string |
| |||
type |
存储的值的类型 |
uint32 |
| |||
create_time |
列的创建时间 |
uint32 |
| |||
modify_time |
列的修改时间 |
uint32 |
| |||
is_search_field |
是否为云检索端检索或排序筛选字段 |
uint32 |
| |||
is_index_field |
是否为云存储索引字段 |
uint32 |
|
http://api.map.baidu.com/geodata/v4/column/update
参数名 | 参数含义 | 类型 | 备注 |
id |
column的id |
uint32 |
必选 |
geotable_id |
数据表的id |
uint32 |
必选 |
name |
geotable数据列中对key的描述内容 |
string(45) |
可选 前缀匹配 |
is_search_field |
是否设置为云检索的排序筛选or检索字段; 1代表是,0代表否 |
uint32 |
可选 如果数据表中已经有数据,不允许修改此字段。 设置后在云检索服务中可根据该字段的内容检索或排序筛选。 若字段为int/double类型,则为排序筛选字段,最多设置15个; 若字段为string类型,则为检索字段,最多设置4个,单字段不超过512字节。 |
is_index_field |
是否为云存储的索引字段; 1代表是,0代表否 |
uint32 |
可选 如果数据表中已经有数据,不允许修改此字段。 设置后可使用云存储相关检索接口,对该字段数据进行检索(前缀匹配,不区分int or string)。 最多设置3个。 |
ak |
用户的访问权限key |
string |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 |
http://api.map.baidu.com/geodata/v4/column/delete
参数名 | 参数含义 | 类型 | 备注 |
id |
column的id |
uint32 |
必选 |
geotable_id |
数据表的id |
uint32 |
必选 |
ak |
用户的访问权限key |
string |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 |
http://api.map.baidu.com/geodata/v4/poi/create
参数名 | 参数含义 | 类型 | 备注 |
title |
位置数据名称 |
string(256) |
可选。最多128个utf-8字符 |
address |
位置数据地址 |
string(256) |
可选。最多128个utf-8字符 |
tags |
位置数据类别 |
string(256) |
可选。最多200个tag,每个tag最长32个字符。 |
latitude |
用户上传的纬度 |
double |
必选。非百度墨卡托坐标时,取值为[-90,90] |
longitude |
用户上传的经度 |
double |
必选。非百度墨卡托坐标时,取值为[-180,180] |
polygons |
多边形边界点坐标数据 |
double |
可选 若该字段传入数据,则判定为面状位置数据。 格式为:经度,纬度;经度,纬度;经度,纬度 单个多边形最多创建400个边界点,最大字符长度为10240。 |
coord_type |
用户上传的坐标的类型:1、2、3、4 |
uint32 |
必选 1:GPS经纬度坐标 2:国测局加密经纬度坐标 3:百度加密经纬度坐标 4:百度加密墨卡托坐标 |
geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
{column key} |
用户在column定义的key/value对 |
用户自定义的类型(string、int、double) |
唯一索引字段必选,且需要保证唯一,否则会创建失败。最大长度2048字节。 |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
id |
新增的位置数据id |
string |
|
http://api.map.baidu.com/geodata/v4/poi/list
参数名 | 参数含义 | 类型 | 备注 |
{index key} |
用户在column定义的key/value对 |
用户自定义的类型(string、int、double) |
可选。column需要设置了is_index_field=1。对于string,是前缀匹配,如需精确匹配请在字段值末尾加$。对于int或者double,则是范围查找,传递的格式为最小值,最大值。当无最小值或者最大值时,用-代替,同时,此字段最大长度不超过50,最小值与最大值都是整数 例:如加入一个命名为color数据类型为string的column,在检索是可设置为“color=red”的形式来检索color字段为red的POI。 如加入一个命名为number数据类型为int的column,在检索是可设置为“number=20,-”的形式来检索number字段值大于等于20的POI。 |
title |
位置数据名称 |
string(256) |
可选。最多128个utf-8字符 |
tags |
位置数据类别 |
string(256) |
可选。最多200个tag,每个tag最长32个字符,多个tag空格间隔。 |
bounds | 查询的矩形区域 | string(100) | 可选。格式x1,y1;x2,y2分别代表矩形的左上角和右下角。 范围过大时服务易超时,返回数据为空。 建议经度跨度小于0.8,纬度跨度小于0.5。 |
coord_type |
用户上传的坐标的类型:1、2、3、4 | uint32 | 必选 1:GPS经纬度坐标 2:国测局加密经纬度坐标 3:百度加密经纬度坐标 4:百度加密墨卡托坐标 |
page_index | 分页索引 | uint32 | 可选。默认为0 |
page_size |
分页数目 |
uint32 |
可选。默认为10,上限为200 |
start_date |
创建日期 |
string(50) |
可选。格式:2017-06-01 |
end_date |
修改日期 |
string(50) |
可选。格式:2017-06-01 |
geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
size |
单页返回的数据条数 |
uint32 |
| |||
pois |
poi结果列表 |
array |
| |||
id |
新增的位置数据id |
string |
| |||
geotable_id |
所属数据表id |
string |
| |||
title |
poi名称 |
string |
| |||
location |
百度系坐标 |
float | 格式为:[经度,纬度] | |||
gcj_location |
国测局坐标 |
float |
格式为:[经度,纬度] | |||
polygons |
边界点坐标 |
float |
格式为:[经度,纬度]。若该字段为空时不召回。 | |||
address |
地址 |
string |
若该字段为空时不召回。 | |||
tags |
标签 |
string |
| |||
create_time |
用户创建日期 |
string |
| |||
modify_time |
用户修改时间 |
string |
| |||
province |
所在的省份 |
string |
| |||
city |
所在的城市 |
string |
| |||
district |
所在的区 |
string |
| |||
{column key} |
用户在column定义的key/value对 |
用户自定义的类类别 |
|
http://api.map.baidu.com/geodata/v4/poi/detail
参数名 | 参数含义 | 类型 | 备注 |
id |
位置数据对应的id |
uint64 |
必选 |
geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
poi |
poi结果列表 |
dict |
| |||
id |
位置数据id |
string |
| |||
geotable_id |
所属数据表id |
string |
| |||
title |
位置数据名称 |
string |
| |||
location |
百度系坐标 |
float | 格式为:[经度,纬度] | |||
gcj_location |
国测局坐标 |
float |
格式为:[经度,纬度] | |||
polygons |
边界点坐标 |
float |
格式为:[经度,纬度]。若该字段为空时不召回。 | |||
address |
地址 |
string |
若该字段为空时不召回。 | |||
tags |
标签 |
string |
| |||
create_time |
用户创建日期 |
string |
| |||
modify_time |
用户修改时间 |
string |
| |||
province |
所在的省份 |
string |
| |||
city |
所在的城市 |
string |
| |||
district |
所在的区 |
string |
| |||
{column key} |
用户在column定义的key/value对 |
用户自定义的类类别 |
|
http://api.map.baidu.com/geodata/v4/poi/update
参数名 | 参数含义 | 类型 | 备注 |
id |
位置数据对应的id |
uint64 |
必选 |
title |
位置数据名称 |
string(256) |
可选 |
address |
地址 |
string(256) |
可选 |
tags |
数据类别 |
string(256) |
可选 多个tag空格间隔 |
latitude |
用户上传的纬度 |
double |
可选 |
longitude |
用户上传的经度 |
double |
可选 |
coord_type |
用户上传的坐标的类型 |
uint32 |
可选。默认3 1.GPS经纬度坐标 2.测局加密经纬度坐标 3.百度加密经纬度坐标 4.百度加密墨卡托坐标 |
geotable_id |
创建数据的对应数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
{column key} |
用户在column定义的key/value对 |
用户自定义的的列类别 |
|
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 |
http://api.map.baidu.com/geodata/v4/poi/delete
参数名 | 参数含义 | 类型 | 备注 |
id |
被删除的位置数据id |
uint64 |
可选。 如果设置了这个参数,其余删除条件会被忽略,只会根据id删除单条poi。此时此操作不是批量请求。 除该字段外,该接口其他字段均会触发批量任务,任务状态请通过job list接口查看 |
ids |
id列表 |
以,分隔的id |
可选。最多1000个id,如果设置了批量删除is_total_del = 1并且没有设置id字段,则优先根据ids删除多条poi, 其它条件将被忽略. |
{index key} |
用户在column定义的key/value对 |
用户自定义的的列类别 |
可选。column需要设置了is_index_field=1。 字段类型为string,是精确匹配【例:price=high】; 字段类型为int或者double,是范围查找,传递的格式为:最小值,最大值。当无最小值或者最大值时,用-代替,同时,此字段最大长度不超过50,最小值与最大值都是整数【例:price=50,-】。 |
title |
位置数据名称 |
string(256) |
可选。精确匹配 |
tags |
数据类别 |
string(256) |
可选。精确匹配 |
geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
is_total_del |
标记为批量删除 |
int32 |
可选。 如需删除一条以上数据,在设定数据范围的条件时,还需要将该字段设为1。 注意:若仅设为1,而不设定数据范围的条件(如不指定ids、tag等),则默认为删除全表数据 |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
id |
批量任务的job id |
string |
如为批量删除,会返回该字段。job id可通过job list接口查看任务状态 |
http://api.map.baidu.com/geodata/v4/poi/upload //仅支持POST接口
参数名 | 参数含义 | 类型 | 备注 |
poi_list |
输入的位置数据列表名称 |
file |
必选。单次上传的数据表小于1000条数据 |
geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
导入文件(poi_list对应的文件)的csv格式(自定义字段需与默认字段间隔一个空列):
数据列(必选字段)-上传文件
参数名 | 参数含义 | 类型 | 备注 |
title |
poi名称 |
string(45) |
必选 |
latitude |
用户上传的纬度 |
double |
必选 |
longitude |
用户上传的经度 |
double |
必选 |
coord_type |
用户上传的坐标的类型 |
uint32 |
必选 1.GPS经纬度坐标 2.国测局加密经纬度坐标 3.百度加密经纬度坐标 4.百度加密墨卡托坐标 |
{column key} |
用户在column定义的key/value对 |
用户自定义的类类别 |
可选。 文件中,自定义字段需与前几个默认字段间隔一个空列。 |
geotable_id |
删除数据所在的数据表id |
string(50) |
必选 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
id |
导入文件的job id |
string |
使用job list接口,可查看文件上传状态 |
http://api.map.baidu.com/geodata/v4/job/list
参数名 | 参数含义 | 类型 | 备注 |
id |
批量任务的job id |
int32 |
必选。单次上传的数据表小于1000条数据 |
page_size |
分页大小(单页召回的数据量) |
int32 |
可选。默认10,上限200 |
page_index |
翻页 |
int32 |
可选。0为第一页 |
geotable_id |
删除数据所在的数据表id |
string(50) |
可选。若未传geotable_id,则查询该ak账号下所有批量任务 |
ak |
用户的访问权限key |
string(50) |
必选 申请ak |
参数名 |
参数含义 | 类型 | 备注 | |||
status |
状态码 |
int32 |
0代表成功,其它取值见文档最后状态码说明 | |||
message |
响应的信息 |
string(50) |
状态码描述,成功时返回“OK”,失败返回对应信息 | |||
jobs |
job结果列表 |
array |
| |||
id |
批量任务job id |
string |
| |||
create_time |
用户创建日期 |
string |
| |||
modify_time |
用户修改日期 |
string |
| |||
type |
任务类型 |
string |
sync(发布至云检索)/delete(删除)/uplode(发布至云存储) | |||
uplode_num |
导入成功的位置数据数量 |
uint32 |
| |||
delete_num |
删除位置数据的数量 |
uint32 |
| |||
status |
查询任务的状态 |
int32 |
0(成功);1(运行);2(失败) 注意与状态码“status”区分 |
状态码 | 含义 | 备注 |
0 | 成功 | |
1 | 这是批量任务, 可通过job接口查询任务状态 |
|
11 | 未知错误 |
|
20 |
geotable不存在 |
|
21 |
geotable的数量达到上限 |
|
22 |
column的数量达到上限 |
|
23 |
is_search_field数量达到上限 |
|
24 |
is_index_field数量达到上限 |
|
25 |
geotable的name重复 |
|
26 |
column的key重复 |
|
27 |
bounds超过最大范围 |
|
28 |
此操作需要表中没有任何poi数据 |
|
30 |
参数错误|过滤条件有错误|坐标转换失败|content-type错误|http的method错误|http的头部错误 |
|
31 |
name: 参数不存在|key: 参数不存在|id: 参数不存在|type: 参数不存在|geotable_id: 参数不存在|longitude/latitude: 参数不存在|coord_type: 参数不存在|poi_list: 参数不存在|type: URL不能作为检索/索引字段 |
|
302 |
天配额超限,限制访问。配额超限,对此错误码不需要重试消耗配额和并发资源,如果想增加配额请联系我们 |
|
401 |
当前并发量已经超过约定并发配额,限制访问。并发控制超限,对此错误码不需要重试消耗配额和并发资源,请控制并发量或联系我们 |
|
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成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保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
Place Suggestion API默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)
注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数(即配额)是有限的。
每个开发者账号每天调用“正/逆地理编码服务”API 服务的总次数(即并发量)是有限的。
若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持。
同一个账号下的HTTP/HTTPS请求,配额,并发共享。
配额及默认并发量说明如下
分类 | 未认证 | 个人认证 | 企业认证 |
---|---|---|---|
日配额(次) | 100,000 | 300,000 | 3,000,000 |
分钟并发数(次/分钟) | 6,000 | 12,000 | 30,000 |
在排除未进行过删除数据操作的前提下,请查看云存储服务的使用版本(请求中有明确标识)。
云存储V4版服务于2017年7月31日发布,之前使用的云存储服务为V3及以下版本。
V4版服务与之前版本服务数据不相通。及,使用历史版本云存储存储的数据,无法通过V4版云存储相关接口查询,反之亦然。
若有使用云存储V4版服务需求,请对历史版本服务数据进行迁移。若数据量过于庞大,可联系我们协助操作。
稳定性和数据安全是云存储服务的最基本要求。
所有存储在云存储服务中的数据都以数据表为单位进行独立存储,以保障数据安全,不被他人窃取。
每次对数据进行管理操作,均需同时传入数据表ID(geotabel id)和服务访问密钥(AK)进行融合鉴权。其他用户无权访问,请放心使用。
2013年7月25日
V2.0
2013年10月24日
V2.1
2013年11月7日
V2.2
2013年12月12日
V2.3
2014年1月20日
V3.0
2017年7月31日
V4.0
优化与更新批量操作:提高数据管理能力,在存储引擎提供一定能力的空间索引和文本索引,支持按条件批量的更新和删除操作,方便数据管理阶段的数据维护。
大幅度提升存储性能:支持单geotable亿数量级存储,每天百万次的读写操作,每秒千次的并发读写操作。
支持国外数据的存储,但不进行检索建库。
新增coord_type字段。
优化批量上传接口,增加查看进度接口。
LBS.云检索:支持对属性值为离散数值类型的POI的筛选。
文档修改:
支持对属性值为离散数值类型的POI的筛选。
用户有自定义权限的字段进一步详细说明如何定义以及定义后效果。
有些参数的使用方法开发者不太清楚,给出详细的url 举例。
注:与LBS.云V2.0相比,LBS.云V3.0新增功能汇总如下:
支持对属性值为离散数值类型的POI的筛选。
在原有支持int、double和string类型数据存储基础上添加图片存储功能。
添加唯一索引扩展字段存储功能。
优化批量上传接口,增加查看进度接口。
支持将检索结果按多字段进行排序的功能。
支持唯一索引字段 。
优化接口类型。对不常用或易用性较差的接口做部分删减或融合。接口整体更加精简。
优化服务架构,服务性能大幅提升。
新增容灾机制,数据安全保障能力大幅提升。