浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
(清空页面)
 
第1行: 第1行:
{{cloud-sidebar}}
 
==坐标系说明==
 
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
 
  
 
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
 
 
 
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
 
 
 
云存储 API默认输入坐标类型为百度坐标(BD09),同时可通过参数("coord_type")控制输入坐标类型,输入坐标支持以上三种坐标系。
 
 
云存储 API同时返回百度坐标(BD09)和国测局坐标(GCJ02)两类坐标点数据。
 
 
 
 
<p style="color:red">注意:不同类型坐标如需转换,请使用百度地图开放平台提供的[http://lbsyun.baidu.com/index.php?title=webapi/guide/changeposition 标准坐标转换接口]。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
 
 
==云存储字段定义方式==
 
'''使用说明'''
 
 
1.请先了解名词意义: “[http://developer.baidu.com/map/index.php?title=lbscloud/guide/explanation 位置数据表(geotable)]”、 “[http://developer.baidu.com/map/index.php?title=lbscloud/guide/explanation 自定义扩展列(column)]”、“[http://developer.baidu.com/map/index.php?title=lbscloud/guide/explanation 位置数据(poi)]”概念的意义,更有助于开发。
 
 
2.云存储接口功能:支持单个geotable亿级数据及数百G大小的存储,每天支持百万量级读写,每秒支持万量级读写。
 
 
3.批量操作说明:
 
 
V2版本,引入“批量操作”概念。通过批量操作接口操作,您可实现对一个位置数据表(geotable)进行如下操作:
 
 
{{bluepoint}}批量上传多条数据;
 
 
{{bluepoint}}批量删除多条数据;
 
 
{{bluepoint}}批量删除1个或者多个自定义扩展列(column);
 
 
{{bluepoint}}批量更新数据(如字段、字段属性、字段对应的值等)等操作<br/>
 
 
4.云存储已全面支持http/https两种请求形式。后文介绍中以http请求为例。
 
 
 
'''“批量操作”接口原理及使用说明如下:'''
 
 
{{bluepoint}}“批量操作”接口是采用异步服务形式,您可使用此接口对一个位置数据表(geotable)同时执行各种批量操作,服务将在并发数范围内同时处理多个请求任务,超出并发数的请求任务将以消息队列形式进入处理等待状态。<br/>
 
{{bluepoint}}当您使用批量操作接口时,服务将先发送批量操作请求,若请求成功,系统将锁定对应的位置数据表(geotable),即用户可对此表进行可读操作,不能进行任何写操作,直到此次批量操作任务完成(即任务进度状态码Status = 3 完成时)自动解锁,恢复可写。同时,系统会返回状态码Status =21和此操作(Job id),Status值用于标识您的操作为批量操作, Job id用于查询此批量操作的任务进度。(Status = 0 表示非批量操作的普通操作)。
 
 
{{bluepoint}}查询某个批量操作任务进度,即根据上述返回的Job id,使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值(1、2、3)确认批量操作的进度(新增操作,消息队列中等待处理;正在处理;完成)。<br/>
 
 
 
'''编码说明:'''
 
 
API请求中需要用到中文或一些特殊字符的参数,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
 
{|
 
|-
 
!width="74" |字符集合
 
!width="500" |字符
 
|-
 
|URL非保留字
 
|a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
 
|-
 
|URL保留字
 
|! * ' ( ) ; : @ & = + $ , / ? % # [ ]
 
|}
 
如果中文参数中使用URL保留字字符的字面意思,例如,检索关键字包含一个问号,此问号也必须进行编码。
 
 
附注:
 
 
(1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
 
 
(2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
 
 
(3) C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
 
 
(4) php中可以使用函数urlencode对特殊字符进行编码。
 
 
===位置数据表(geotable)实体字段定义===
 
{|
 
!width="100"|字段名
 
!width="150" |含义
 
!width="100"|类型
 
!width="350"|备注
 
|-
 
|id
 
|id
 
|uint32
 
|即geotable_id,为唯一标识
 
|-
 
|user_id
 
|用户id
 
|uint64
 
|
 
|-
 
|geotype
 
|数据类型
 
|uint32
 
|1(点)、3(面)
 
|-
 
|create_time
 
|创建的时间
 
|datetime
 
|
 
|-
 
|modify_time
 
|最后一次修改的时间
 
|datetime
 
|
 
|}
 
 
===自定义扩展列(column)实体字段定义===
 
{|
 
!width="100"|字段名
 
!含义
 
!width="80"|类型
 
!width="60"|是否必须
 
!width="50"|默认值
 
!备注
 
|-
 
|id || 唯一标识 || uint64 || 是 || 无 ||
 
|-
 
|key || 存储在geotable<br/>的key标识 || string(64) || 是 ||无 || 在同一geotable内唯一正则:<br/>[a-zA-Z][0-9a-zA-Z_]*
 
|-
 
|name || 对key的描述 || string(128) || 否 || 无 ||
 
|-
 
|type || 字段类型 || int32 || 是 || 无 || 1:Int64, 2:double, 3:string, 4:在线图片url,LBS图片存储
 
|-
 
|max_length || 最大长度 || int32 ||否 ||无 ||1,针对String是必须<br/>2,最大值不超过2048
 
|-
 
|default_value ||默认值 ||string(32) ||否 ||无 ||1,如果此列被设置成排序筛选字段,则default_value必须进行设置.否则默认为0
 
|-
 
|is_sortfilter_field ||是否将字段设置为云检索时的排序筛选字段 ||uint32 ||是 || ||1代表是,0代表否。设置后效果详见        [http://developer.baidu.com/map/index.php?title=lbscloud/api/geosearch#poi.E5.91.A8.E8.BE.B9.E6.90.9C.E7.B4.A2 http://developer.baidu.com/map/index.php?title=lbscloud/api/geosearch]最多只能设置15个
 
|-
 
|sortfilter_id ||排序筛选字段id ||uint32 ||否   || ||1-15,在同一geotable内不能重复.
 
|-
 
|is_search_field ||是否设置为检索时的文本检索字段 ||uint32 ||是 || ||1代表是,0代表否。设置后可根据对该字段的内容要求进行检索<br/> 只能针对String类型的字段,最大<br/>设置大小不超过2048,最多不超过4个
 
|-
 
|is_index_field  ||是否将字段设置为索引字段。 ||uint32 ||否 || || 1代表是,0代表否。设置后可实现方便快速查询。最多设置3个 <br/>注:is_index_field=1 时才能在根据该列属性值检索到数据,设置后对应功能: [http://developer.baidu.com/map/index.php?title=lbscloud/api/geodata#.E6.9F.A5.E8.AF.A2.E6.8C.87.E5.AE.9A.E6.9D.A1.E4.BB.B6.E7.9A.84.E6.95.B0.E6.8D.AE.EF.BC.88poi.EF.BC.89.E5.88.97.E8.A1.A8.E6.8E.A5.E5.8F.A3 http://developer.baidu.com/map/index.php?title=lbscloud/api/geodata]
 
|-
 
|is_unique_field ||是否将字段设置为唯一索引字段。 ||uint32 ||否 || ||1代表是,0代表否。设置后方便更新,删除,查询。最多设置1个
 
|-
 
|create_time ||创建时间 ||uint32 ||是   || ||Unix时间戳
 
|-
 
|modify_time ||修改时间 ||uint32 ||是   ||    ||Unix时间戳
 
|}
 
 
===位置数据(poi)实体字段定义===
 
{|
 
!width="100"|字段名
 
!width="150" |含义
 
!width="100"|类型
 
!width="350"|备注
 
|-
 
|id || id || uint64 || 为唯一标识
 
|-  
 
|title || 名称 || string(256) ||
 
|-
 
|tags || 分类标签 || string(256) || 参见:[http://lbsyun.baidu.com/index.php?title=lbscloud/poitags POI行业分类]<br/>多个tag以空格分隔
 
|-
 
|location || 坐标 || array || 格式为:[经度,纬度]或[墨卡托坐标]
 
|-
 
|coord_type || 坐标类型 || uint32 || 1(GPS经纬度坐标)、2(国测局加密经纬度坐标)、3(百度加密经纬度坐标)、4(百度加密墨卡托坐标)
 
|-
 
|province || 省 || string(32) || 
 
|-
 
|city || 市 || string(32) ||
 
|-
 
|district || 区 || string(64) ||
 
|-
 
|address || 地址 || string(256) ||
 
|-
 
|geotable_id || 所属geotable id || uint32 ||
 
|-
 
|create_time || 创建时间 || uint32 || Unix时间戳
 
|-
 
|modify_time || 最后一次修改的时间 || uint32 || Unix时间戳
 
|}
 
 
==位置数据表(geotable)管理==
 
===创建表(create geotable)接口===
 
'''请求url'''<br/>
 
<pre>
 
http://api.map.baidu.com/geodata/v3/geotable/create  //POST请求
 
</pre>
 
'''请求参数'''<br/>
 
{|
 
!参数名
 
!width="100"|参数含义
 
!width="100"|类型
 
!备注
 
|-
 
|name ||geotable的中文名称 ||string(45) ||必选
 
|-
 
|geotype ||geotable持有数据的类型 || int32 ||必选<br/>1:点;2:线;3:面。默认为1(当前不支持“线”)
 
|-
 
|is_published || 是否发布到检索 || int32 || 必选 <br/> 0:未自动发布到云检索,<br/>1:自动发布到云检索;<br/>注:1)通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。<br/>2)可通过数据管理模块设置,在设置中将是否发送到检索一栏中选定为是即可。
 
|-
 
|ak ||用户的访问权限key ||string(50) ||必选
 
|-
 
|sn ||用户的权限签名 ||string(50) ||可选
 
|-
 
|timestamp || 时间戳 ||uint32 ||可选,配合sn使用,增加时间戳安全验证
 
|}
 
 
 
'''响应参数(json格式)'''<br/>
 
{|
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status ||状态码 ||int32 ||0代表成功,其它取值含义另行说明
 
|-
 
|message ||响应的信息 ||string(50) ||状态码描述
 
|-
 
|id ||新增的数据的id ||string ||
 
|}
 
 
 
'''请求响应示例'''(截图来自chrome浏览器插件:"POSTMAN"工具,下同)<br/>
 
 
http://developer.baidu.com/map/static/img/geodata-1.jpg
 
 
===查询表(list geotable)接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/geotable/list // GET请求
 
</source>
 
 
 
'''请求参数'''
 
 
{|
 
|-
 
!width="100" |  参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|name
 
|geotable的名字
 
|string(45)
 
|可选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
 
{|
 
|-
 
!width="200" colspan="2"| 参数名
 
!width="100" | 参数含义
 
!width="80" |类型
 
!width="150" | 备注
 
|-
 
|colspan="2"|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|colspan="2"| message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|colspan="2"| size
 
|数据个数
 
|int32
 
|
 
|-
 
|rowspan="7" width="80"| geotables
 
|
 
|geotable列表
 
|array
 
|
 
|-
 
|id
 
|geotable的主键
 
|string
 
|
 
|-
 
|geotype
 
|geo类型
 
|
 
|
 
|-
 
|name
 
|geotable的中文名称
 
|string
 
|
 
|-
 
|is_published
 
|是否发布到检索
 
|int32
 
|
 
|-
 
|create_time
 
|创建日期
 
|string
 
|
 
|-
 
|modify_time
 
|最近一次修改时间
 
|string
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-2.jpg
 
 
===查询指定id表(detail geotable)接口===
 
 
''' 请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/geotable/detail // GET请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!width="100" |  参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|指定geotable的id
 
|int32
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
''' 响应参数(json格式)'''
 
{|
 
!width="200" colspan="2" | 参数名
 
!width="100" | 参数含义
 
!width="80" |类型
 
!width="150" | 备注
 
|-
 
|colspan="2" | status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|colspan="2" | message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|rowspan="7" width="80"|  geotable
 
|
 
|geotable列表
 
|array
 
|
 
|-
 
|id
 
|geotable的主键
 
|string
 
|
 
|-
 
|geotype
 
|geo类型
 
|
 
|
 
|-
 
|name
 
|geotable的中文名称
 
|string
 
|
 
|-
 
|is_published
 
|是否发布到检索
 
|int32
 
|
 
|-
 
|create_time
 
|创建日期
 
|string
 
|
 
|-
 
|modify_time
 
|最近一次修改时间
 
|string
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-3.jpg
 
 
===修改表(update geotable)接口===
 
 
'''请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/geotable/update // POST请求
 
</source>
 
 
 
''' 请求参数'''
 
 
{|
 
|-
 
!width="100" |  参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|geotable主键
 
|uint32
 
|必选
 
|-
 
|is_published
 
|是否发布到检索
 
|int32
 
|会引起批量操作
 
|-
 
|name
 
|geotable的中文名称
 
|string(45)
 
|可选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
''' 响应参数(json格式)'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-4.jpg
 
 
===删除表(geotable)接口 ===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/geotable/delete // POST请求
 
//注:当geotable里面没有有效数据时,才能删除geotable
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|表主键
 
|uint32
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-5.jpg
 
 
==数据列(column)管理==
 
 
===创建列(create column)接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/column/create // POST请求
 
</source>
 
 
 
'''请求参数'''
 
 
{|
 
|-
 
!width="80" |  参数名
 
!width="150" | 参数含义
 
!width="80" | 类型
 
!width="200" | 备注
 
|-
 
|name
 
|column的属性中文名称
 
|string(45)
 
|必选
 
|-
 
|key
 
|column存储的属性key
 
|string(45)
 
|必选,同一个geotable内的名字不能相同
 
|-
 
|type
 
|存储的值的类型
 
|uint32
 
|必选,枚举值1:Int64, 2:double, 3:string, 4:在线图片url
 
|-
 
|max_length
 
|最大长度
 
|uint32
 
|最大值2048,最小值为1。当type为string该字段有效,此时该字段必填。此值代表utf8的汉字个数,不是字节个数
 
|-
 
|default_value
 
|默认值
 
|string(45)
 
|设置默认值
 
|-
 
|is_sortfilter_field
 
|是否检索引擎的数值排序筛选字段
 
|uint32
 
|必选<br/>1代表是,0代表否。设置后,在请求[[lbscloud/api/geosearch | LBS云检索]]时可针对该字段进行排序。该字段只能为int或double类型,最多设置15个
 
|-
 
|is_search_field
 
|是否检索引擎的文本检索字段
 
|uint32
 
|必选<br/>1代表支持,0为不支持。只有type为string时可以设置检索字段,只能用于字符串类型的列且最大长度不能超过512个字节
 
|-
 
|is_index_field
 
|是否存储引擎的索引字段
 
|uint32
 
|必选<br/>用于存储接口查询:1代表支持,0为不支持<br/>注:is_index_field=1 时才能在根据该列属性值检索时检索到数据
 
|-
 
|is_unique_field
 
|是否云存储唯一索引字段,方便更新,删除,查询
 
|uint32
 
|可选,1代表是,0代表否。设置后将在数据创建和更新时进行该字段唯一性检查,并可以以此字段为条件进行数据的更新、删除和查询。最多设置1个
 
|-
 
|geotable_id
 
|所属于的geotable_id
 
|string(50)
 
|
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
''' 响应参数(json格式)'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|id
 
|新增的数据id
 
|uint32
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-6.jpg
 
 
===查询列(list column)接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/column/list // GET请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="250" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|name
 
|geotable meta的属性中文名称
 
|string(45)
 
|可选
 
|-
 
|key
 
|geotable meta存储的属性key
 
|string(45)
 
|可选
 
|-
 
|geotable_id
 
|所属于的geotable_id
 
|string(50)
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
 
{|
 
|-
 
!width="200" colspan="2"| 参数名
 
!width="100" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|colspan="2" | status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|colspan="2" |message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|colspan="2" |size
 
|返回数据条数
 
|uint32
 
|
 
|-
 
|rowspan="13" width="100"| columns
 
|id
 
|id
 
|string
 
|
 
|-
 
|geotable_id
 
|所属于的geotable_id
 
|string
 
|
 
|-
 
|name
 
|中文名称
 
|string
 
|
 
|-
 
|key
 
|存储的属性key
 
|string
 
|
 
|-
 
|type
 
|存储的值的类型
 
|uint32
 
|
 
|-
 
|max_length
 
|列的最大长度
 
|uint32
 
|
 
|-
 
|default_value
 
|列的默认值
 
|string(32)
 
|
 
|-
 
|create_time
 
|列的创建时间
 
|uint32
 
|
 
|-
 
|modify_time
 
|列的修改时间
 
|uint32
 
|
 
|-
 
|is_sortfilter_field
 
|是否检索端排序字段
 
|uint32
 
|
 
|-
 
|is_search_field
 
|是否检索端文本检索字段
 
|uint32
 
|
 
|-
 
|is_index_field
 
|是否存储管理索引字段
 
|uint32
 
|
 
|-
 
|is_unique_field
 
|是否存储管理唯一索引字段
 
|uint32
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-7.jpg
 
 
===查询指定id列(detail column)详情接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/column/detail // GET请求
 
</source>
 
 
'''请求参数'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|列的id
 
|uint32
 
|必选
 
|-
 
|geotable_id
 
|表的id
 
|uint32
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string
 
|可选
 
|}
 
 
 
''' 响应参数(json格式)'''
 
 
{|
 
|-
 
!width="200" colspan="2"|  参数名
 
!width="100" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|colspan="2"| status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|colspan="2"| message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|rowspan="13" width="80"| column
 
|id
 
|id
 
|string
 
|
 
|-
 
|geotable_id
 
|所属于的geotable_id
 
|string
 
|
 
|-
 
|name
 
|中文名称
 
|string
 
|
 
|-
 
|key
 
|存储的属性key
 
|string
 
|
 
|-
 
|type
 
|存储的值的类型
 
|uint32
 
|
 
|-
 
|max_length
 
|列的最大长度
 
|uint32
 
|
 
|-
 
|default_value
 
|列的默认值
 
|string(32)
 
|
 
|-
 
|create_time
 
|列的创建时间
 
|uint32
 
|
 
|-
 
|modify_time
 
|列的修改时间
 
|uint32
 
|
 
|-
 
|is_sortfilter_field
 
|是否是[[lbscloud/api/geosearch | LBS云检索]]排序字段
 
|uint32
 
|
 
|-
 
|is_search_field
 
|是否是[[lbscloud/api/geosearch | LBS云检索]]文本检索字段
 
|uint32
 
|
 
|-
 
|is_index_field
 
|是否是云存储索引字段
 
|uint32
 
|
 
|-
 
|is_unique_field
 
|是否是云存储唯一索引字段
 
|uint32
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-8.jpg
 
 
===修改指定条件列(column)接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/column/update // POST请求
 
</source>
 
 
 
'''请求参数'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|列主键
 
|uint32
 
|必选
 
|-
 
|geotable_id
 
|所属表主键
 
|uint32
 
|必选
 
|-
 
|name
 
|属性中文名称
 
|string(45)
 
|可选
 
|-
 
|default_value
 
|默认值
 
|string
 
|可选
 
|-
 
|max_length
 
|文本最大长度
 
|int32
 
|字符串最大长度,只能改大,不能改小
 
|-
 
|is_sortfilter_field
 
|是否检索引擎的数值排序字段
 
|uint32
 
|1代表是,0代表否,如果poi表中已经有数据,并且发布到了[[lbscloud/api/geosearch | LBS云检索]],修改此字段,会引起批量操作
 
|-
 
|is_search_field
 
|是否检索引擎的文本检索字段
 
|uint32
 
|1代表是,0代表否,如果poi表中已经有数据,并且发布到了[[lbscloud/api/geosearch | LBS云检索]],修改此字段,会引起批量操作
 
|-
 
|is_index_field
 
|是否存储引擎的索引字段
 
|uint32
 
|1代表是,0代表否
 
|-
 
|is_unique_field
 
|是否存储索引的唯一索引字段
 
|uint32
 
|1代表是,0代表否。设置后将在数据创建和更新时进行该字段唯一性检查,并可以以此字段为条件进行数据的更新、删除和查询。最多设置1个
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-9.jpg
 
 
===删除指定条件列(column)接口===
 
 
''' 请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/column/delete // POST请求
 
</source>
 
 
 
''' 请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|
 
|
 
|必选
 
|-
 
|geotable_id
 
|
 
|
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
'''响应参数(json格式)'''
 
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|}
 
 
 
''' 请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-10.jpg
 
 
== 位置数据(poi)管理==
 
===创建数据(create poi)接口===
 
 
 
''' 请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/create // POST请求
 
</source>
 
 
'''请求参数'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|title
 
|poi名称
 
|string(256)
 
|可选
 
|-
 
|address
 
|地址
 
|string(256)
 
|可选
 
|-
 
|tags
 
|tags
 
|string(256)
 
|可选
 
|-
 
|latitude
 
|用户上传的纬度
 
|double
 
|必选
 
|-
 
|longitude
 
|用户上传的经度
 
|double
 
|必选
 
|-
 
|coord_type
 
|用户上传的坐标的类型
 
|uint32
 
|必选<br/>1:GPS经纬度坐标<br/>2:国测局加密经纬度坐标<br/>3:百度加密经纬度坐标<br/>4:百度加密墨卡托坐标
 
|-
 
|geotable_id
 
|记录关联的geotable的标识
 
|string(50)
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|开发者自定义的类型(string、int、double)
 
|唯一索引字段必选,且需要保证唯一,否则会创建失败
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|id
 
|新增的数据的id
 
|string
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-11.jpg
 
 
=== 查询指定条件的数据(poi)列表接口===
 
 
'''请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/list // GET请求
 
</source>
 
 
 
'''请求参数'''
 
 
{|
 
|-
 
!width="80" | 参数名
 
!width="100" | 参数含义
 
!width="100" | 类型
 
!width="250" | 备注
 
|-
 
|{index key}
 
|用户在column定义的key/value对
 
|
 
|column需要设置了is_index_field=1。对于string,是前缀匹配,如需精确匹配请在末尾加$。对于int或者double,则是范围查找,传递的格式为最小值,最大值。当无最小值或者最大值时,用-代替,同时,此字段最大长度不超过50,最小值与最大值都是整数<br/>例:如加入一个命名为color数据类型为string的column,在检索是可设置为“color=red”的形式来检索color字段为red的POI
 
|-
 
|title
 
|记录(数据)名称
 
|string(256)
 
|可选
 
|-
 
|tags
 
|记录的标签(用于检索筛选)
 
|string(256)
 
|可选
 
|-
 
|bounds
 
|查询的矩形区域
 
|string(100)
 
|格式x1,y1;x2,y2分别代表矩形的左上角和右下角,可选
 
|-
 
|geotable_id
 
|geotable_id
 
|string(50)
 
|必选
 
|-
 
|page_index
 
|分页索引
 
|uint32
 
|默认为0
 
|-
 
|page_size
 
|分页数目
 
|uint32
 
|默认为10,上限为200
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''3.2.3 响应参数(json格式)'''
 
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|size
 
|返回数据条数
 
|uint32
 
|
 
|-
 
|total
 
|全部的数据条数
 
|uint32
 
|
 
|-
 
|pois
 
|poi结果列表
 
|array
 
|
 
|-
 
|id
 
|数据id
 
|string
 
|
 
|-
 
|geotable_id
 
|geotable_id
 
|string
 
|
 
|-
 
|title
 
|poi名称
 
|string
 
|
 
|-
 
|location
 
|百度系坐标
 
|float
 
|格式为:[经度,纬度]
 
|-
 
|gcj_location
 
|国测局坐标
 
|float
 
|格式为:[经度,纬度]
 
|-
 
|address
 
|地址
 
|string
 
|
 
|-
 
|tags
 
|标签
 
|string
 
|
 
|-
 
|create_time
 
|用户创建日期
 
|string
 
|
 
|-
 
|modify_time
 
|用户修改时间
 
|string
 
|
 
|-
 
|province
 
|所在的省份
 
|string
 
|
 
|-
 
|district
 
|所在的区
 
|string
 
|
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|用户自定义的类类别
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-12.jpg
 
 
===查询指定id的数据(poi)详情接口===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/detail // GET请求
 
</source>
 
 
 
''' 请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|poi主键
 
|uint64
 
|必选
 
|-
 
|geotable_id
 
|表主键
 
|int32
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|poi
 
|poi结果列表
 
|dict
 
|
 
|-
 
|id
 
|数据id
 
|string
 
|当不存在唯一索引字段时必选,存在唯一索引字段时可选
 
|-
 
|geotable_id
 
|geotable_id
 
|string
 
|
 
|-
 
|{自定义唯一索引key}
 
|Value
 
|自定义类型
 
|若自定义索引字段和id共存时,将优先根据id进行查询
 
|-
 
|title
 
|poi名称
 
|string
 
|
 
|-
 
|location
 
|百度系坐标
 
|float
 
|格式为:[经度,纬度]
 
|-
 
|gcj_location
 
|国测局坐标
 
|float
 
|格式为:[经度,纬度]
 
|-
 
|create_time
 
|用户创建日期
 
|string
 
|
 
|-
 
|address
 
|地址
 
|string
 
|
 
|-
 
|city
 
|城市
 
|string
 
|
 
|-
 
|province
 
|所在的省份
 
|string
 
|
 
|-
 
|district
 
|所在区域
 
|string
 
|
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|自定义类型
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-13.jpg
 
 
===修改数据(poi)接口===
 
 
'''请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/update // POST请求
 
</source>
 
 
 
'''请求参数'''
 
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|id
 
|poi的id
 
|uint64
 
|当不存在唯一索引字段时必须,存在唯一索引字段可选
 
|-
 
|自定义唯一索引key
 
|Value
 
|用户自定义类型
 
|可选,若自定义索引字段和id共存时,将以id为准,且自定义索引key将被新的value
 
|-
 
|title
 
|poi名称
 
|string(256)
 
|
 
|-
 
|address
 
|地址
 
|
 
|
 
|-
 
|tags
 
|tags
 
|
 
|
 
|-
 
|latitude
 
|用户上传的纬度
 
|double
 
|
 
|-
 
|longitude
 
|用户上传的经度
 
|double
 
|
 
|-
 
|coord_type
 
|用户上传的坐标的类型
 
|uint32
 
|必选<br/>1.GPS经纬度坐标<br/>2.测局加密经纬度坐标<br/>3.百度加密经纬度坐标<br/>4.百度加密墨卡托坐标
 
|-
 
|geotable_id
 
|记录关联的geotable的标识
 
|string(50)
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|用户自定义的的列类别
 
|
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-14.jpg
 
 
===删除数据(poi)接口(支持批量)===
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/delete // POST请求
 
</source>
 
 
 
''' 请求参数'''
 
{|
 
|-
 
!width="80" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="250" | 备注
 
|-
 
|id
 
|被删除的id
 
|uint64
 
|如果设置了这个参数,其它的删除条件会被忽略,只会根据id删除单条poi。此时此操作不是批量请求。
 
|-
 
|自定义唯一索引key
 
|Value
 
|用户自定义类型
 
|可选,若自定义索引字段和id共存时,优先选择根据id删除poi。
 
|-
 
|ids
 
|id列表
 
|以,分隔的id
 
|最多1000个id, 如果设置了批量删除is_total_del = 1并且没有设置id字段,则优先根据ids删除多条poi, 其它条件将被忽略.
 
|-
 
|{index key}
 
|用户在column定义的key/value对
 
|
 
|column需要设置了is_index_field=1。对于string,是前缀匹配,如需精确匹配请在末尾加$。对于int或者double,则是范围查找,传递的格式为:最小值,最大值。当无最小值或者最大值时,用-代替,同时,此字段最大长度不超过50,最小值与最大值都是整数.
 
|-
 
|title
 
|名称
 
|string(256)
 
|可选
 
|-
 
|tags
 
|标签
 
|string(256)
 
|可选
 
|-
 
|bounds
 
|查询的矩形区域
 
|string(100)
 
|格式x1,y1;x2,y2分别代表矩形的左上角和右下角
 
|-
 
|geotable_id
 
|geotable_id
 
|string(50)
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|
 
|
 
|-
 
|is_total_del
 
|标记为批量删除
 
|int32
 
|如需删除一条以上数据,在设定数据范围的条件时,还需要将该字段设为1。 {{red | 注意:若仅设为1,而不设定数据范围的条件(如不指定ids、tag等),则默认为删除全表数据 }}
 
|}
 
 
 
'''3.5.3 响应参数(json格式)'''
 
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|id
 
|job id
 
|string
 
|
 
|}
 
 
 
''' 请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-15.jpg
 
 
===批量上传数据(post pois csv file)接口===
 
 
注意:该接口每日限调用25次。若对数据的实时性要求较高,建议通过“创建数据(create poi)接口”实现。
 
 
 
'''请求url'''
 
 
<source>
 
http://api.map.baidu.com/geodata/v3/poi/upload // POST请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|geotable_id
 
|导入的geotable的标识
 
|uint32
 
|必选
 
|-
 
|poi_list
 
|输入的poi列表名称
 
|file
 
|必选,小于8M
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|-
 
|timestamp
 
|时间戳
 
|uint32
 
|必选,配合sn使用,增加时间戳安全验证
 
|}
 
 
导入文件(poi_list)的CSV格式:
 
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|title
 
|poi名称
 
|string(45)
 
|必选
 
|-
 
|latitude
 
|用户上传的纬度
 
|double
 
|必选
 
|-
 
|longitude
 
|用户上传的经度
 
|double
 
|必选
 
|-
 
|coord_type
 
|用户上传的坐标的类型
 
|uint32
 
|1.GPS经纬度坐标<br/>2.国测局加密经纬度坐标<br/>3.百度加密经纬度坐标<br/>4.百度加密墨卡托坐标
 
|-
 
|{column key}
 
|用户在column定义的key/value对
 
|用户自定义的类类别
 
|可选
 
|-
 
|address
 
|地址
 
|string(256)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|job_id
 
|导入job的id
 
|string
 
|用以查询这个job后续的导入情况调用job/listimportdata接口详情见下
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-16.jpg
 
 
附:批量导入示例文件(data.csv )
 
 
http://developer.baidu.com/map/static/img/yun3642.jpeg
 
 
=== 批量上传进度查询接口(支持进度查询和上传失败的poi)===
 
 
''' 请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/job/listimportdata // GET请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|geotable_id
 
|导入的geotable的标识
 
|uint32
 
|必选
 
|-
 
|job_id
 
|导入接口返回的job_id
 
|string(50)
 
|必选
 
|-
 
|status
 
|Poi导入的状态
 
|uint32
 
|默认为0,0为全部,1为失败,2为成功,已经废弃。
 
|-
 
|page_index
 
|分页索引
 
|uint32
 
|默认为0
 
|-
 
|page_size
 
|分页数目
 
|uint32
 
|默认为10,上限为100
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|-
 
|timestamp
 
|时间戳
 
|uint32
 
|
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|total
 
|导入poi总数目
 
|int32
 
|
 
|-
 
|size
 
|当前返回个数
 
|int32
 
|
 
|-
 
|process_status
 
|导入进度状态
 
|int32
 
|0为进行中,1为完成
 
|-
 
|process_total
 
|导入总数
 
|int32
 
|
 
|-
 
|process_failed
 
|导入失败总数
 
|int32
 
|
 
|-
 
|process_success
 
|导入成功总数
 
|
 
|
 
|-
 
|datas
 
|Array[ poi=>array(),//导入的poi信息 msg=>导入状态信息 ]
 
|Array
 
|
 
|-
 
|Header
 
|导入的header信息
 
|Array
 
|
 
|-
 
|time
 
|导入总时间单位s
 
|int32
 
|
 
|}
 
 
== 批量操作任务(JOB)查询进度接口==
 
=== 批量操作接口原理及使用说明===
 
 
{{bluepoint}}通过“批量操作”接口,可实现对一个位置数据表(geotable)进行各种批量操作,包括:上传多条数据,删除多条数据,删除多个自定义扩展列(column),更新数据(如字段、字段属性、字段对应的值等)等。
 
 
{{bluepoint}}“批量操作”接口采用异步形式,服务将在并发数范围内同时处理多个请求任务,超出并发数的请求任务将以消息队列形式进入处理等待状态。
 
 
{{bluepoint}}当您使用批量操作接口时,服务将先发送批量操作请求,若请求成功,系统将锁定对应的位置数据表(geotable),即用户可对此表进行可读操作,不能进行任何写操作,直到此次批量操作任务完成(即任务进度状态码Status = 3 完成时)自动解锁,恢复可写。同时,系统会返回状态码Status =21(表示批量操作)和此操作的Job id(用于查询此批量操作的任务进度)。
 
 
{{bluepoint}}查询某个批量操作任务进度,即根据上述返回的Job id,使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值确认批量操作的进度(1为等待处理,2为正在处理,3为完成)。
 
 
{{bluepoint}}注意:“批量上传”功能每日限调用25次。<br/>
 
 
=== 批量操作任务查询(list job)接口===
 
 
''' 请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/job/list // GET请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|type
 
|job类型
 
|int32(<10)
 
|
 
|-
 
|status
 
|job状态
 
|int32(<10)
 
|1为等待处理,2为正在处理,3为完成。
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
''' 响应参数(json格式)'''
 
{|
 
|-
 
!参数名
 
!参数含义
 
!类型
 
!备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|jobs
 
|job结果列表
 
|array
 
|
 
|-
 
|id
 
|数据id
 
|string
 
|
 
|-
 
|create_time
 
|用户创建日期
 
|string
 
|
 
|-
 
|modify_time
 
|
 
|string
 
|
 
|-
 
|error
 
|错误码
 
|int32
 
|
 
|-
 
|poi_fail
 
|导入失败的
 
|uint32
 
|
 
|-
 
|poi_size
 
|导入总数的
 
|uint32
 
|可能为0
 
|-
 
|poi_success
 
|导入成功的
 
|uint32
 
|
 
|-
 
|status
 
|状态
 
|int32
 
|
 
|-
 
|type
 
|类型
 
|int32
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-17.jpg
 
 
===根据id查询批量任务(detail job)接口===
 
 
'''请求url'''
 
<source>
 
http://api.map.baidu.com/geodata/v3/job/detail // GET请求
 
</source>
 
 
 
'''请求参数'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="150" | 备注
 
|-
 
|id
 
|id
 
|uint64
 
|必选
 
|-
 
|ak
 
|用户的访问权限key
 
|string(50)
 
|必选
 
|-
 
|sn
 
|用户的权限签名
 
|string(50)
 
|可选
 
|}
 
 
 
'''响应参数(json格式)'''
 
{|
 
|-
 
!width="100" | 参数名
 
!width="150" | 参数含义
 
!width="100" | 类型
 
!width="250" | 备注
 
|-
 
|status
 
|状态码
 
|int32
 
|0代表成功,其它取值含义另行说明
 
|-
 
|message
 
|响应的信息
 
|string(50)
 
|状态码描述
 
|-
 
|job
 
|job结果列表
 
|dict
 
|
 
|-
 
|id
 
|数据id
 
|string
 
|
 
|-
 
|create_time
 
|用户创建日期
 
|string
 
|
 
|-
 
|modify_time
 
|用户修改时间
 
|string
 
|
 
|-
 
|error
 
|错误码
 
|string
 
|
 
|-
 
|poi_fail
 
|导入失败的
 
|uint32
 
|
 
|-
 
|poi_size
 
|导入总数的
 
|uint32
 
|可能为0
 
|-
 
|poi_success
 
|导入成功的
 
|uint32
 
|
 
|-
 
|status
 
|状态
 
|int
 
|
 
|-
 
|type
 
|类型
 
|int
 
|
 
|}
 
 
 
'''请求响应示例'''
 
 
http://developer.baidu.com/map/static/img/geodata-18.jpg
 
 
== 返回码定义值表==
 
 
0: 成功
 
 
1: 服务器内部错误
 
 
2: 参数错误
 
 
3: http method错误
 
 
21: 此操作为批量操作
 
 
22: 同步到检索失败
 
 
31: 服务端加锁失败
 
 
32: 服务端释放锁失败
 
 
1001: 表的name重复
 
 
1002: 表的数量达到了最大值
 
 
1003: 表中存在poi数据,不允许删除
 
 
2001: 列的key重复
 
 
2002: 列的key是保留字段
 
 
2003: 列的数量达到了最大值
 
 
2004: 唯一索引只能创建一个
 
 
2005: 更新为唯一索引失败,原poi数据中有重复
 
 
2011: 排序筛选字段只能用于整数或小数类型的列
 
 
2012: 排序筛选的列已经达到了最大值
 
 
2021: 检索字段只能用于字符串类型的列且最大长度不能超过512个字节
 
 
2022: 检索的列已经达到了最大值
 
 
2031: 索引的列已经达到了最大值
 
 
2041: 指定的列不存在
 
 
2042: 修改max_length必须比原值大
 
 
3001: 更新坐标必须包含经纬度和类型
 
 
3002: 唯一索引字段存在重复
 
 
3031: 上传的文件太大
 
 
 
控制服务错误码:
 
 
请参见[http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix 附录]。
 

2022年11月14日 (一) 16:39的最后版本

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消