|
|
| （未显示3个用户的199个中间版本） |
| 第1行： |
第1行： |
| − | {{cloud-sidebar}}
| |
| | | | |
| − | ==云存储字段定义方式==
| |
| − | ===位置数据表（geotable）实体字段定义===
| |
| − | '''使用说明'''
| |
| − |
| |
| − | 1.请先了解名词意义： “位置数据表（geotable）”、 “自定义扩展列（column）”、“位置数据（poi） ”概念的意义，更有助于开发。
| |
| − |
| |
| − | 2.云存储接口功能：支持单个geotable亿级数据及数百G大小的存储，每天支持百万量级读写，每秒支持万量级读写。
| |
| − |
| |
| − | 3.批量操作说明：
| |
| − |
| |
| − | V2版本，引入“批量操作”概念。通过批量操作接口操作，您可实现对一个位置数据表（geotable）进行如下操作：
| |
| − |
| |
| − | 批量上传多条数据；
| |
| − | 批量删除多条数据；
| |
| − | 批量删除1个或者多个自定义扩展列（column）；
| |
| − | 批量更新数据（如字段、字段属性、字段对应的值等）等操作<br/>
| |
| − | '''“批量操作”接口原理及使用说明如下：'''
| |
| − |
| |
| − | “批量操作”接口是采用异步服务形式，您可使用此接口对一个位置数据表（geotable）同时执行各种批量操作，服务将在并发数范围内同时处理多个请求任务，超出并发数的请求任务将以消息队列形式进入处理等待状态。<br/>
| |
| − | 当您使用批量操作接口时，服务将先发送批量操作请求，若请求成功，系统将锁定对应的位置数据表（geotable），即用户可对此表进行可读操作，不能进行任何写操作，直到此次批量操作任务完成（即任务进度状态码Status = 3 完成时）自动解锁，恢复可写。同时，系统会返回状态码Status =21和此操作（Job id），Status值用于标识您的操作为批量操作， Job id用于查询此批量操作的任务进度。（Status = 0 表示非批量操作的普通操作）。
| |
| − | 查询某个批量操作任务进度，即根据上述返回的Job id，使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值（1、2、3）确认批量操作的进度（新增操作，消息队列中等待处理；正在处理；完成）。
| |
| − | {|
| |
| − | !colspan="4" |geotable 字段说明
| |
| − | |-
| |
| − | |字段名称
| |
| − | |字段含义
| |
| − | |类型
| |
| − | |备注
| |
| − | |-
| |
| − | |id
| |
| − | |id，记录唯一的标识
| |
| − | |uint32 |
| |
| − | |-
| |
| − | |geotype
| |
| − | |geotable包含的数据类型，包含点、线、面三种类型
| |
| − | |uint32
| |
| − | |1：点；2：线；3：面。默认为1（当前只<br/>支持点）
| |
| − | |-
| |
| − | |modify_time
| |
| − | |记录最后一次被修改的时间
| |
| − | |datetime
| |
| − | |
| |
| − | |-
| |
| − | |create_time
| |
| − | |记录被创建的时间
| |
| − | |datetime
| |
| − | |
| |
| − | |-
| |
| − | |user_id
| |
| − | |创建此记录的用户标识
| |
| − | |uint64
| |
| − | |
| |
| − | |}
| |
| − |
| |
| − | ===自定义扩展列（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/lbs-geosearch.htm#.search.nearby 最多只能设置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代表否。设置后可实现方便快速查询。最多设置2个 <br/>注：is_index_field=1 时才能在根据该列属性值检索到数据，设置后对应功能： http://developer.baidu.com/map/lbs-geodata.htm#.column.manage3.2
| |
| − | |-
| |
| − | |is_unique_field ||是否将字段设置为唯一索引字段。 ||uint32 ||否 || ||1代表是，0代表否。设置后方便更新，删除，查询。最多设置1个
| |
| − | |-
| |
| − | |create_time ||创建时间 ||uint32 ||是 || ||Unix时间戳
| |
| − | |-
| |
| − | |modify_time ||修改时间 ||uint32 ||是 || ||Unix时间戳
| |
| − | |}
| |
| − |
| |
| − | ===位置数据（poi）实体字段定义===
| |
| − | {|
| |
| − | !字段名
| |
| − | !含义
| |
| − | !类型
| |
| − | !是否必须
| |
| − | !默认值
| |
| − | !备注
| |
| − | |-
| |
| − | |id ||唯一标识 ||uint64 ||是 ||无 ||
| |
| − | |-
| |
| − | |location ||坐标 ||array ||是 ||无 ||格式为：[经度,纬度]或者[对应的墨卡托投影]
| |
| − | |-
| |
| − | |province || 省名称 ||string(32) ||否 ||无 ||
| |
| − | |-
| |
| − | | city_id ||市id ||uint32 ||是 ||无 ||
| |
| − | |-
| |
| − | |city ||市名 ||string(32) ||是 ||无 ||
| |
| − | |-
| |
| − | |district ||区名 ||string(64) || 否 || ||
| |
| − | |-
| |
| − | |title ||名称 ||string(256) || 否 || ||
| |
| − | |-
| |
| − | |address ||地址 ||string(256) ||否 || ||
| |
| − | |-
| |
| − | |coord_type ||用户上传的坐标的类型 ||uint32 ||否 ||3 ||可选，1.GPS经纬度坐标<br/>2.国测局加密经纬度坐标<br/>3.百度加密经纬度坐标<br/>4.百度加密墨卡托坐标
| |
| − | |-
| |
| − | |tags || 标签 || string(256) ||否 || ||以空格分隔
| |
| − | |-
| |
| − | |geotable_id ||表主键 ||uint32 ||是 || ||
| |
| − | |-
| |
| − | |create_time || 创建时间 ||uint32 ||是 || ||Unix时间戳
| |
| − | |-
| |
| − | |modify_time ||修改时间 || uint32 ||是 || ||Unix时间戳
| |
| − | |}
| |
| − |
| |
| − | ==位置数据表（geotable&column）管理==
| |
| − | ===创建表（create geotable）接口===
| |
| − | '''请求url'''<br/>
| |
| − | <pre>
| |
| − | http://api.map.baidu.com/geodata/v3/geotable/create //POST请求
| |
| − | </pre>
| |
| − | '''请求参数'''<br/>
| |
| − | {|
| |
| − | !参数名
| |
| − | !参数含义
| |
| − | !类型
| |
| − | !备注
| |
| − | |-
| |
| − | |name ||geotable的中文名称 ||string(45) ||必选
| |
| − | |-
| |
| − | |geotype ||geotable持有数据的类型 || int32 ||必选<br/>1：点poi<br/>2：线poi<br/>3：面poi，默认为1
| |
| − | |-
| |
| − | |is_published || 是否发布到检索 || int32 || 必选 <br/> 0：未自动发布到云检索，<br/>1：自动发布到云检索；<br/>策略提示：<br/>
| |
| − | 注：1）通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。<br/>
| |
| − | 2）可通过数据管理模块设置，如图所示，在设置中将是否发送到检索一栏中选定为是即可。
| |
| − | |-
| |
| − | |timestamp || 时间戳 ||uint32 ||可选
| |
| − | |-
| |
| − | |ak ||用户的访问权限key ||string(50) ||必选
| |
| − | |-
| |
| − | |sn ||用户的权限签名 ||string(50) ||可选
| |
| − | |}
| |
| − | '''响应参数（json格式）'''<br/>
| |
| − | {|
| |
| − | !参数名
| |
| − | !参数含义
| |
| − | !类型
| |
| − | !备注
| |
| − | |-
| |
| − | |status ||状态码 ||int32 ||必须。0代表成功，其它取值含义另行说明
| |
| − | |-
| |
| − | |message ||响应的信息 ||string(50) ||对status的英文描述
| |
| − | |-
| |
| − | |id ||新增的数据的id ||string ||必选
| |
| − | |}
| |
| − | '''请求响应示例（截图来自chrome浏览器插件："POSTMAN"工具，下同）'''<br/>
| |
没有match的答案？试试对话大模型
登录