全部服务产品
开发者频道
服务升级
登录

文档全面上新

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

体验新版


云存储字段定义方式

位置数据表(geotable)实体字段定义

使用说明

1.请先了解名词意义: “位置数据表(geotable)”、 “自定义扩展列(column)”、“位置数据(poi) ”概念的意义,更有助于开发。

2.云存储接口功能:支持单个geotable亿级数据及数百G大小的存储,每天支持百万量级读写,每秒支持万量级读写。

3.批量操作说明:

V2版本,引入“批量操作”概念。通过批量操作接口操作,您可实现对一个位置数据表(geotable)进行如下操作:

批量上传多条数据; 批量删除多条数据; 批量删除1个或者多个自定义扩展列(column); 批量更新数据(如字段、字段属性、字段对应的值等)等操作
“批量操作”接口原理及使用说明如下:

“批量操作”接口是采用异步服务形式,您可使用此接口对一个位置数据表(geotable)同时执行各种批量操作,服务将在并发数范围内同时处理多个请求任务,超出并发数的请求任务将以消息队列形式进入处理等待状态。
当您使用批量操作接口时,服务将先发送批量操作请求,若请求成功,系统将锁定对应的位置数据表(geotable),即用户可对此表进行可读操作,不能进行任何写操作,直到此次批量操作任务完成(即任务进度状态码Status = 3 完成时)自动解锁,恢复可写。同时,系统会返回状态码Status =21和此操作(Job id),Status值用于标识您的操作为批量操作, Job id用于查询此批量操作的任务进度。(Status = 0 表示非批量操作的普通操作)。 查询某个批量操作任务进度,即根据上述返回的Job id,使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值(1、2、3)确认批量操作的进度(新增操作,消息队列中等待处理;正在处理;完成)。

geotable 字段说明
字段名称 字段含义 类型 备注
id id,记录唯一的标识
geotype geotable包含的数据类型,包含点、线、面三种类型 uint32 1:点;2:线;3:面。默认为1(当前只
支持点)
modify_time 记录最后一次被修改的时间 datetime
create_time 记录被创建的时间 datetime
user_id 创建此记录的用户标识 uint64

自定义扩展列(column)实体字段定义

字段名 含义 类型 是否必须 默认值 备注
id 唯一标识 uint64
key 存储在geotable
的key标识
string(64) 在同一geotable内唯一正则:
[a-zA-Z][0-9a-zA-Z_]*
name 对key的描述 string(128)
type 字段类型 int32 1:Int64, 2:double, 3:string, 4:在线图片url,LBS图片存储
max_length 最大长度 int32 1,针对String是必须
2,最大值不超过2048
default_value 默认值 string(32) 1,如果此列被设置成排序筛选字段,则default_value必须进行设置.否则默认为0
is_sortfilter_field 是否将字段设置为云检索时的排序筛选字段 uint32 1代表是,0代表否。设置后效果详见 http://developer.baidu.com/map/lbs-geosearch.htm#.search.nearby 最多只能设置15个
sortfilter_id 排序筛选字段id uint32 1-15,在同一geotable内不能重复.
is_search_field 是否设置为检索时的文本检索字段 uint32 1代表是,0代表否。设置后可根据对该字段的内容要求进行检索
只能针对String类型的字段,最大
设置大小不超过2048,最多不超过4个
is_index_field 是否将字段设置为索引字段。 uint32 1代表是,0代表否。设置后可实现方便快速查询。最多设置2个
注:is_index_field=1 时才能在根据该列属性值检索到数据,设置后对应功能: http://developer.baidu.com/map/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经纬度坐标
2.国测局加密经纬度坐标
3.百度加密经纬度坐标
4.百度加密墨卡托坐标
tags 标签 string(256) 以空格分隔
geotable_id 表主键 uint32
create_time 创建时间 uint32 Unix时间戳
modify_time 修改时间 uint32 Unix时间戳

位置数据表(geotable&column)管理

2.1 创建表(create geotable)接口

2.1.1 请求url

http://api.map.baidu.com/geodata/v3/geotable/create  //POST请求

2.1.2 请求参数

参数名 参数含义 类型 备注
name geotable的中文名称 string(45) 必选
geotype geotable持有数据的类型 int32 必选
1:点poi
2:线poi
3:面poi,默认为1
is_published 是否发布到检索 int32 必选
0:未自动发布到云检索,
1:自动发布到云检索;
策略提示:

注:1)通过URL方式创建表时只有is_published=1时 在云检索时表内的数据才能被检索到。
2)可通过数据管理模块设置,如图所示,在设置中将是否发送到检索一栏中选定为是即可。

timestamp 时间戳 uint32 可选
ak 用户的访问权限key string(50) 必选
sn 用户的权限签名 string(50) 可选

2.1.3 响应参数(json格式)

参数名 参数含义 类型 备注
status 状态码 int32 必须。0代表成功,其它取值含义另行说明
message 响应的信息 string(50) 对status的英文描述
id 新增的数据的id string 必选

2.1.4 请求响应示例(截图来自chrome浏览器插件:"POSTMAN"工具,下同)

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消