# 数据中台API ## Docs - [数据集相关](https://doc2.olmap.cn/65970810f0.md): 此接口为少数高级用户使用,可以参考数据管理平台的界面,后台接口没有做参数的严格校验,使用不当可能导致某些功能异常。一般情况下,建议通过数据管理平台的界面维护数据集 - 第三方接口 [百度](https://doc2.olmap.cn/89588269f0.md): 本文档只展示必填参数,而所有参数会透传给百度接口,参数详情请参阅百度开放平台开发者文档,如:https://lbs.baidu.com/docs/webapi?title=placev3/guide/webservice-placeapiV3/interfaceDocumentV3 - 旧版本v0 [数据集相关](https://doc2.olmap.cn/47311686f0.md): 此接口为少数高级用户使用,可以参考数据管理平台的界面,后台接口没有做参数的严格校验,使用不当可能导致某些功能异常。一般情况下,建议通过数据管理平台的界面维护数据集 ## API Docs - 数据集相关 [创建数据集](https://doc2.olmap.cn/346677724e0.md): - 数据集相关 [全量更新数据集](https://doc2.olmap.cn/346679246e0.md): - 数据集相关 [局部更新数据集](https://doc2.olmap.cn/346679468e0.md): - 数据集相关 [分页查询数据集](https://doc2.olmap.cn/346688629e0.md): - 数据集相关 [根据ID查询单个数据集](https://doc2.olmap.cn/346700338e0.md): - 数据集相关 [删除数据集](https://doc2.olmap.cn/346716889e0.md): - 数据集相关 [查询索引](https://doc2.olmap.cn/346700905e0.md): - 数据集相关 [创建索引](https://doc2.olmap.cn/346701376e0.md): - 数据集相关 [删除索引](https://doc2.olmap.cn/346702477e0.md): - 数据维护 [创建一条或多条数据](https://doc2.olmap.cn/346718425e0.md): data可以是数组也可以是对象。数组代表批量创建,返回创建成功的数量;对象代表创建一条数据,返回创建成功后的数据。 - 数据维护 [全量更新一条或多条数据](https://doc2.olmap.cn/346725153e0.md): data可以是数组也可以是对象。数组代表批量创建,返回创建成功的数量;对象代表创建一条数据,返回创建成功后的数据。“全量”或“局部”是相对于tag属性说的,tag里面存的是用户自定义字段,“全量”需要传入所有字段,而“局部”可以只传需要修改的字段。 - 数据维护 [局部更新一条或多条数据](https://doc2.olmap.cn/346726662e0.md): data可以是数组也可以是对象。数组代表批量创建,返回创建成功的数量;对象代表创建一条数据,返回创建成功后的数据。“全量”或“局部”是相对于tag属性说的,tag里面存的是用户自定义字段,“全量”需要传入所有字段,而“局部”可以只传需要修改的字段。 - 数据维护 [根据查询条件更新数据](https://doc2.olmap.cn/346730487e0.md): 能更新系统字段,谨慎授权 - 数据维护 [GET方式分页查询数据](https://doc2.olmap.cn/346729088e0.md): 根据restful规范,查询数据一般用GET方式,但一些接口支持复杂查询语句,或可以传入大量坐标,GET方式可能超长了,如果有超长的查询参数,可以选用POST查询接口。当需要查询的数据量很大时,比如总数量1000万以上,翻页会变得越来越慢,这是因为mongo的skip分页,需要扫描前方所有记录,才能找到所需要的位置。为了解决这个慢的问题,可以指定排序字段:sort=_id,然后查询第一页,之后带上查询条件:{"_id":{"$gt":"上一页最后一条记录的_id"}} 一直查,查到没数据为止。 - 数据维护 [POST方式分页查询数据](https://doc2.olmap.cn/346729402e0.md): 根据restful规范,查询数据一般用GET方式,但一些接口支持复杂查询语句,或可以传入大量坐标,GET方式可能超长了,如果有超长的查询参数,可以选用POST查询接口。具体参数请参考GET方式的接口 - 数据维护 [多表全量查询数据](https://doc2.olmap.cn/353691365e0.md): 此接口并不是关联查询,每个数据集都是独立的。适合一次请求,查询多个数据集里的数据,相当于多次调用/data/query接口。 - 数据维护 [新增子数据关联](https://doc2.olmap.cn/346731317e0.md): 如果主数据集里定义了数组字段,并且设置“表单类型”为“子数据_id”,可以用这个接口为这个字段增加子记录。子记录以_id数组的形式存于主记录字段中。新增子数据关联时,会自动判断是否有重复的_id,也会判断子数据是否存在,如果不存在或有重复,就会删除对应的_id,防止出现无效数据引用。 - 数据维护 [全量更新子数据关联](https://doc2.olmap.cn/346747717e0.md): 同“新增子数据关联”,区别是会全量覆盖原有关联,比如原来存的是["1"],现在childDataIds传的是"2",那么关联字段就变成["2"],而不是["1","2"] - 数据维护 [删除子数据关联](https://doc2.olmap.cn/346748010e0.md): 如果主数据集里定义了关联数据集字段,可以用这个接口为这个字段删除子记录。子记录以_id数据组的形式存于主记录字段中。 - 数据维护 [根据id或查询条件删除数据](https://doc2.olmap.cn/346753337e0.md): - 数据维护 [导出数据文件](https://doc2.olmap.cn/349296665e0.md): 以下不同的接口地址,分别对应不同的导出文件格式,各接口参数一样: - 空间查询 [框查](https://doc2.olmap.cn/342035219e0.md): 可以查点、线、面数据 - 空间查询 [多边形查](https://doc2.olmap.cn/342035222e0.md): 可以查点线面数据,支持线面缓冲 - 空间查询 [圆查](https://doc2.olmap.cn/342035224e0.md): 只能查点状数据 - 空间查询 [周边查询](https://doc2.olmap.cn/342035228e0.md): 可以查点、线、面数据,查询结果由近及远排序 - 空间查询 [批量周边查询](https://doc2.olmap.cn/342426096e0.md): 可以把中心点存入一个数据集,并且每个点都做为中心点,去另一个点状数据集进行周边查询,返回结果。 - 空间查询 [相交查](https://doc2.olmap.cn/342035231e0.md): 获取与给定的geojson相交的所有geojson, - 空间查询 [反查](https://doc2.olmap.cn/342035229e0.md): 给出一个geoJson数组,一些多边形查询条件,返回落在多边形内的geoJson 适用场景:多边形顶点较多,把多边形传到前端数据量太大,就在后端做空间关系判断 - 地理空间计算 [线的长度](https://doc2.olmap.cn/349841117e0.md): - 地理空间计算 [多边形面积](https://doc2.olmap.cn/349843109e0.md): - 地理空间计算 [绝对中心](https://doc2.olmap.cn/349843989e0.md): 绝对中心,质心,重心,三个接口算法不同。本文档示例中的多边形,求出的三个点不重合,以下是可以演示差距的数据: - 地理空间计算 [质心](https://doc2.olmap.cn/349844928e0.md): - 地理空间计算 [重心](https://doc2.olmap.cn/349845751e0.md): - 地理空间计算 [求缓冲区](https://doc2.olmap.cn/349850244e0.md): - 地理空间计算 [对线/面顶点抽稀(按距离)](https://doc2.olmap.cn/349853124e0.md): - 地理空间计算 [对线/面顶点抽稀(按百分比) ](https://doc2.olmap.cn/349857269e0.md): 此接口可保持相邻多边形的拓扑关系,可用于抽稀行政区划等 - 地理空间计算 [修复重叠和缝隙](https://doc2.olmap.cn/349881286e0.md): - 地理空间计算 [合并区域](https://doc2.olmap.cn/349882489e0.md): - 地理空间计算 [为区域划分网格](https://doc2.olmap.cn/349884171e0.md): 把区划切割成指定大小的网格. - 地理空间计算 [多点聚合分区](https://doc2.olmap.cn/349894699e0.md): type=byMaxDistance时,有效参数: - 地理空间计算 [坐标类型转换](https://doc2.olmap.cn/349846545e0.md): 转换各家坐标 - 地理空间计算 [转换ArcGIS JSON成GeoJSON](https://doc2.olmap.cn/364597672e0.md): 转换各家坐标 - 地理空间计算 [转换wkt字符串成GeoJSON](https://doc2.olmap.cn/364598533e0.md): 转换各家坐标 - 统计分析 [聚合管道统计](https://doc2.olmap.cn/342762133e0.md): 本接口利用mongo的aggregate功能,对数据进行任意的处理、统计 - 统计分析 [格网分析:矩形、六边形](https://doc2.olmap.cn/342762134e0.md): 此接口可以完成数据的后台网格聚合统计,用于网格密度展示或热力图。如果不传入lngWidth和latWidth参数,后台把每一个瓦片(一般是256*256 像素的瓦片)分成8*8=64个小网格,统计落在每个网格内数据的数量,并且可以指定一个数据集属性(数字或字符串类型,后台会把字符串自动转成数字)做为加权值。对于大数据量(比如一次查询的数据量在五万以上),第一次查询会比较慢,推荐传入cache参数,使后台把查询到的数据自动归属到相关瓦片,并缓存起来。如果下次查询的范围没有超出已缓存的瓦片数据,后台会把范围内的瓦片网格数据自动拼装起来返给前端。但这样做的话下次访问就不是实时运算了,如果需要重新运算,需要调用另一个接口清除缓存的数据 - 统计分析 [格网分析:行政区](https://doc2.olmap.cn/349952219e0.md): - 统计分析 [多点聚合分区](https://doc2.olmap.cn/342762141e0.md): 为指定的点集合(如物流订单)自动划分片区,可以指定片区的最大半径(点到片区中心点的距离,单位米)。用于对点集合从空间分布视角划分区域。 - 统计分析 [自定义区域内数据统计](https://doc2.olmap.cn/354499454e0.md): 传入一个区域数据geojson,统计面内的数据情况 - 鉴权相关 [获取接口数字签名](https://doc2.olmap.cn/346769417e0.md): **注意,获取数字签名一定要在后台请求**,不要在浏览器中请求,以免泄漏企业密钥信息,造成数据被盗。推荐参考文档中示例自己在后台生成签名。 - 鉴权相关 [获取接口JWT认证的token](https://doc2.olmap.cn/347354812e0.md): **注意,获取token一定要在后台请求**,不要在浏览器中请求,以免泄漏企业密钥信息,造成数据被盗。 - 第三方接口 > 高德 [地理编码v3](https://doc2.olmap.cn/349947314e0.md): - 第三方接口 > 高德 [逆地理编码v3](https://doc2.olmap.cn/349947315e0.md): - 第三方接口 > 高德 [关键词查兴趣点v5](https://doc2.olmap.cn/349947316e0.md): - 第三方接口 > 高德 [多边形查兴趣点v3](https://doc2.olmap.cn/396842193e0.md): - 第三方接口 > 高德 [多边形查兴趣点v5](https://doc2.olmap.cn/349947317e0.md): - 第三方接口 > 高德 [圆形查兴趣点v5](https://doc2.olmap.cn/349947318e0.md): - 第三方接口 > 高德 [输入提示v3](https://doc2.olmap.cn/349947319e0.md): - 第三方接口 > 高德 [IP定位v3](https://doc2.olmap.cn/349947320e0.md): - 第三方接口 > 高德 [步行路径规划v3](https://doc2.olmap.cn/349947321e0.md): - 第三方接口 > 高德 [驾车路径规划v3](https://doc2.olmap.cn/349947322e0.md): - 第三方接口 > 百度 [关键词查兴趣点v3](https://doc2.olmap.cn/479637755e0.md): - 第三方接口 > 百度 [圆形查兴趣点v3](https://doc2.olmap.cn/479813764e0.md): - 第三方接口 > 百度 [多边形查兴趣点v3](https://doc2.olmap.cn/479818957e0.md): 根据百度官方文档,此接口属于高级权限,需要提交工单申请,请确保您的ak有此接口权限。 百度官方说明:https://lbsyun.baidu.com/index.php?title=dev/webservice-placeapi - 第三方接口 [查询行政区](https://doc2.olmap.cn/349948199e0.md): 本接口数据来源于互联网,自行封装的接口。目前数据更新时间为:2024.10.23 - 实用工具 [发送邮件](https://doc2.olmap.cn/392568006e0.md): 请先在【系统管理】>【配置中心】>【邮箱设置】中填写您的邮件帐号信息。配置中心设置的内容,五分钟后生效 - 实用工具 [发送短信](https://doc2.olmap.cn/392552091e0.md): - 请先在【系统管理】>【配置中心】>【第三方key】中填写阿里云短信服务accessKeyId、accessKeySecret。配置中心设置的内容,五分钟后生效 - AI相关 [向量检索](https://doc2.olmap.cn/505225236e0.md): - 旧版本v0 > 数据集相关 [创建或更新数据集](https://doc2.olmap.cn/245117162e0.md): - 旧版本v0 > 数据集相关 [创建视图](https://doc2.olmap.cn/245227616e0.md): - 旧版本v0 > 数据集相关 [分页查询所有数据集](https://doc2.olmap.cn/245239209e0.md): - 旧版本v0 > 数据集相关 [根据dataSetId查询数据集](https://doc2.olmap.cn/245243000e0.md): - 旧版本v0 > 数据集相关 [根据字段中文名查询数据集](https://doc2.olmap.cn/245247314e0.md): 数据集列表中勾上“检索”复选框,字段配置中勾上“全库检索配置---查表”,就能根据此字段中文名查出此数据集。数据集名称中有些关键词也能被检索到。 - 旧版本v0 > 数据集相关 [删除数据集](https://doc2.olmap.cn/245255363e0.md): - 旧版本v0 > 数据集相关 [创建索引](https://doc2.olmap.cn/245256583e0.md): - 旧版本v0 > 数据集相关 [查询索引](https://doc2.olmap.cn/245257043e0.md): - 旧版本v0 > 数据集相关 [删除索引](https://doc2.olmap.cn/245258048e0.md): - 旧版本v0 > 数据维护 [新增或更新一条数据](https://doc2.olmap.cn/245259737e0.md): - 旧版本v0 > 数据维护 [批量新增数据](https://doc2.olmap.cn/245562298e0.md): - 旧版本v0 > 数据维护 [批量更新数据](https://doc2.olmap.cn/245564571e0.md): - 旧版本v0 > 数据维护 [批量新增或更新数据](https://doc2.olmap.cn/245564841e0.md): - 旧版本v0 > 数据维护 [数据查询(单表分页查询)](https://doc2.olmap.cn/245259613e0.md): - 旧版本v0 > 数据维护 [数据查询(多表全量查询)](https://doc2.olmap.cn/245265153e0.md): - 旧版本v0 > 数据维护 [查询树结构数据](https://doc2.olmap.cn/245565152e0.md): 从数据集中的数据,构造树结构的数据。默认的系统字段: - 旧版本v0 > 数据维护 [批量删除数据(根据数据id号)](https://doc2.olmap.cn/245565681e0.md): - 旧版本v0 > 数据维护 [批量删除数据(根据查询条件)](https://doc2.olmap.cn/245565869e0.md): - 旧版本v0 > 数据维护 [新增子数据](https://doc2.olmap.cn/245567205e0.md): 如果主数据集里定义了关联数据集字段,可以用这个接口为这个字段增加子记录。子记录以_id数组的形式存于主记录字段中。 - 旧版本v0 > 数据维护 [删除子数据](https://doc2.olmap.cn/245567399e0.md): 如果主数据集里定义了关联数据集字段,可以用这个接口为这个字段删除子记录。子记录以_id数据组的形式存于主记录字段中。 - 旧版本v0 > 数据维护 [接收【神箭手】数据发布](https://doc2.olmap.cn/245567647e0.md): 使用“神箭手”可以定时自动爬数据,推送到数据中台。需要填写数据集字段和神剑手字段的映射关系。下面是“神箭手”默认爬取的字段: - 旧版本v0 > 数据维护 [数据同步接口](https://doc2.olmap.cn/245568320e0.md): 使用场景:把数据中台的数据主动推送给其它系统。此接口的作用是,当通过数据中台编辑点线面数据时,调用用户设置的数据同步接口,把编辑的数据推送过去。只对点线面类型的数据集有效。当接口按要求的格式返回成功标识时,系统把数据的isSync属性置为1,如果接口返回失败或格式不正确,系统会每隔一段时间重新发送POST请求。 - 旧版本v0 > 数据维护 [分配数据采集任务](https://doc2.olmap.cn/245568337e0.md): 按人划分负责区域,用这些区域分配数据采集任务(把区域内的数据分配给区域负责人。) - 旧版本v0 > 数据维护 [数据导出](https://doc2.olmap.cn/245568455e0.md): 以下不同的接口地址,分别对应不同的导出文件格式,各接口参数一样: - 旧版本v0 > 空间查询 [框查](https://doc2.olmap.cn/245092680e0.md): 可以查点、线、面数据 - 旧版本v0 > 空间查询 [分页框查](https://doc2.olmap.cn/245099936e0.md): 可以查点、线、面数据 - 旧版本v0 > 空间查询 [多边形查](https://doc2.olmap.cn/245102013e0.md): 可以查点线面数据,支持线面缓冲 - 旧版本v0 > 空间查询 [分页多边形查 ](https://doc2.olmap.cn/245105106e0.md): 可以查点线面数据,支持线面缓冲 - 旧版本v0 > 空间查询 [圆查](https://doc2.olmap.cn/245114196e0.md): 只能查点状数据 - 旧版本v0 > 空间查询 [分页圆查](https://doc2.olmap.cn/245114640e0.md): 只能查点状数据 - 旧版本v0 > 空间查询 [周边查询](https://doc2.olmap.cn/245114880e0.md): 可以查点、线、面数据 - 旧版本v0 > 空间查询 [用多边形过虑数据](https://doc2.olmap.cn/245115618e0.md): 给出一个覆盖物数组,一些多边形查询条件,返回落在多边形内的覆盖物 适用场景:多边形顶点较多,把多边形传到前端数据量太大,就在后端做空间关系判断 - 旧版本v0 > 空间查询 [获取与给定的overlay相交的overlays](https://doc2.olmap.cn/245115798e0.md): 物流分单:overlay传一个点状数据,dataSetId传责任区面数据集,这样就查出了这个点所属的责任区。 - 旧版本v0 > 统计分析 [聚合管道统计](https://doc2.olmap.cn/245568861e0.md): 本接口利用mongo的aggregate功能,对数据进行任意的处理、统计 - 旧版本v0 > 统计分析 [矢量网格密度/热力图](https://doc2.olmap.cn/245569099e0.md): 此接口可以完成数据的后台网格聚合统计,用于网格密度展示或热力图。如果不传入lngWidth和latWidth参数,后台把每一个瓦片(一般是256*256 像素的瓦片)分成8*8=64个小网格,统计落在每个网格内数据的数量,并且可以指定一个数据集属性(数字或字符串类型,后台会把字符串自动转成数字)做为加权值。对于大数据量(比如一次查询的数据量在五万以上),第一次查询会比较慢,推荐传入cache参数,使后台把查询到的数据自动归属到相关瓦片,并缓存起来。如果下次查询的范围没有超出已缓存的瓦片数据,后台会把范围内的瓦片网格数据自动拼装起来返给前端。但这样做的话下次访问就不是实时运算了,如果需要重新运算,需要调用另一个接口清除缓存的数据 - 旧版本v0 > 统计分析 [清除矢量网格密度/热力图缓存](https://doc2.olmap.cn/245705450e0.md): - 旧版本v0 > 统计分析 [空间计算](https://doc2.olmap.cn/245393738e0.md): 用户提供一个geojson数组,为线计算长度,为面计算面积。 - 旧版本v0 > 统计分析 [计算线的长度](https://doc2.olmap.cn/245850134e0.md): 单位米。空间计算接口/spacialUtil/calculate也能计算线的长度,只不过这里支持先对名称进行地理编码拿到坐标。 - 旧版本v0 > 统计分析 [格网分析](https://doc2.olmap.cn/245716078e0.md): 当data,filePath参数没传并且有query参数时,接口会使用dataSetId,query,startTime,endTime这些参数查询出待分析的数据 - 旧版本v0 > 统计分析 [为区域划分网格](https://doc2.olmap.cn/245855183e0.md): - 旧版本v0 > 统计分析 [空间相关度分析](https://doc2.olmap.cn/245741741e0.md): 为指定区域分析数据间的空间相关度。可用于不同品牌门店位置分析、刑侦案件空间相关性分析等。 接口返回所有待分析的数据与第一项数据相比的相关度,所以第一个数据代表与自身的相关度,总是1. - 旧版本v0 > 统计分析 [多点聚集分区](https://doc2.olmap.cn/245747514e0.md): 为指定的点集合(如物流订单)自动划分片区,可以指定片区的最大半径(点到片区中心点的距离,单位米)。用于对点集合从空间分布视角划分区域。 - 旧版本v0 > 统计分析 [面数据集区域内数据统计](https://doc2.olmap.cn/245769866e0.md): 指定一些面查询条件,统计面内的数据情况 - 旧版本v0 > 统计分析 [自定义区域内数据统计](https://doc2.olmap.cn/245773510e0.md): 传入一个区域数据geojson,统计面内的数据情况 - 旧版本v0 > 统计分析 [泰森分区](https://doc2.olmap.cn/245782732e0.md): 应用场景:给出一个区域和区域内人员、机构位置,自动为这个人员、机构划分区域,保证区域内位置离人员、机构最近。 - 旧版本v0 > 统计分析 [识别门店数据真伪](https://doc2.olmap.cn/245799552e0.md): 此接口已废弃,如需要,请联系客服。 - 旧版本v0 > 第三方接口 > 高德 [地理编码](https://doc2.olmap.cn/244875338e0.md): - 旧版本v0 > 第三方接口 > 高德 [逆地理编码](https://doc2.olmap.cn/244878392e0.md): - 旧版本v0 > 第三方接口 > 高德 [关键词查兴趣点](https://doc2.olmap.cn/244880380e0.md): - 旧版本v0 > 第三方接口 > 高德 [多边形查兴趣点](https://doc2.olmap.cn/244880615e0.md): - 旧版本v0 > 第三方接口 > 高德 [圆形查兴趣点](https://doc2.olmap.cn/244880913e0.md): - 旧版本v0 > 第三方接口 > 高德 [输入提示](https://doc2.olmap.cn/244881041e0.md): - 旧版本v0 > 第三方接口 > 高德 [IP定位](https://doc2.olmap.cn/244881301e0.md): - 旧版本v0 > 第三方接口 > 高德 [步行路径规划](https://doc2.olmap.cn/244883800e0.md): - 旧版本v0 > 第三方接口 > 高德 [驾车路径规划](https://doc2.olmap.cn/244885334e0.md): - 旧版本v0 > 动态信息 [创建动态信息模板](https://doc2.olmap.cn/245802524e0.md): - 旧版本v0 > 动态信息 [查询动态信息模板](https://doc2.olmap.cn/245814134e0.md): - 旧版本v0 > 动态信息 [更新动态信息模板 ](https://doc2.olmap.cn/245803940e0.md): - 旧版本v0 > 动态信息 [删除动态信息模板](https://doc2.olmap.cn/245808313e0.md): - 旧版本v0 > 动态信息 [创建动态信息](https://doc2.olmap.cn/245820036e0.md): - 旧版本v0 > 动态信息 [更新动态信息](https://doc2.olmap.cn/245823716e0.md): - 旧版本v0 > 动态信息 [查询动态信息](https://doc2.olmap.cn/245825512e0.md): - 旧版本v0 > 动态信息 [删除动态信息](https://doc2.olmap.cn/245828258e0.md): - 旧版本v0 > 其它 [行政区划查询](https://doc2.olmap.cn/245836847e0.md): 本接口基于网上的行政区划数据,自行封装的查询接口。数据不定时更新。当前更新时间为:2024.10.23 - 旧版本v0 > 其它 [字典项查询](https://doc2.olmap.cn/245846626e0.md): 此接口用于数据中台中自动生成下拉列表 - 旧版本v0 > 其它 [获取数字签名](https://doc2.olmap.cn/245864801e0.md): **注意,获取数字签名一定要在后台请求**,不要在浏览器中请求,以免泄漏企业密钥信息,造成数据被盗。推荐参考文档中示例自己在后台生成签名。 - 旧版本v0 > 其它 [获取文件上传签名](https://doc2.olmap.cn/245866032e0.md): - 旧版本v0 > 其它 [获取私有文件下载签名](https://doc2.olmap.cn/245868775e0.md): - 旧版本v0 > 其它 [发送邮件](https://doc2.olmap.cn/245873786e0.md): 先在红框处填写您的邮件帐号信息 - 旧版本v0 > 其它 [发送短信](https://doc2.olmap.cn/245877578e0.md): 本接口需要付费使用,暂时只对部分客户开放,如需要此功能,请咨询客服,告知使用场景、使用频次,由客服协助完成短信模板的申请。