全部产品
云市场

路径分析服务

更新时间:2018-01-03 16:32:47

7.1. 描述

  1. 名称:PathAnalysisGraph
  2. url: /rest/graph/pathAnalysisGraph.json

关联反查API提供客户端可以通过I+接口查询,查询两个实体之间指定关系的一度或多度关系网络路径。
1、支持多个不同类型的节点出发
2、支持查询多个关系
3、支持定义关系的过滤条件
4、支持定义目标节点的过滤条件
5、支持设置路径分析的路径查询数量
6、最多支持6度的关系拓展
7、路径分析不支持间接关系

7.2. 请求参数

名称 类型 是否必须 描述
objects String,Array< String > 起始节点列表,KV结构,K为实体类型,和I+后台配置相同,V为实体ID数组,参见请求示例
links Array< Link > 图查询的需要关系
linkType String 关系类型和I+后台配置相同
direct int 关系出入度,0:出度,1:入度,2:出入度,3:无向,不传默认无向/出入度(支持关联反查,群集分析,共同邻居)
queryProps Array< String > 指定想要查询的属性,默认查询所有属性
propertyList Array< PropertyFilter > 需要过滤关系的属性,详见示例
propertyId String 关系过滤属性的类型
propertyType String 关系过滤属性的查询类型
values Array< String > 详见1.3的其他说明
degree int 传值则返回指定度数内的所有路径,不传值默认查询最短路径

7.3. 返回参数

名称 类型 描述
nodeCnt Integer 网络中实体节点个数
linkCnt Integer 网络中关系边个数
nodes Array< Node > 节点列表
id String 节点id
label String 节点标签,跟I+后台配置的实体属性一致
type String 节点类型,如O0001
virtual Boolean 节点在网络中是否存在
nodesProps Array< Property > 节点属性列表
< Property > < String,String > 节点属性KV值,K为节点类型,和I+后台配置的实体类型一致,V为节点属性,比如”O0003P0001”:”张三”
links Array< Link > 关系边列表
id String 关系边id
source String 关系边的源实体id
sourceType String 关系边的源实体类型,如O0003
target String 关系边的目标实体id
targetType String 关系边的目标实体类型,如O0004
linkDetails Array 关系边包含的边明细记录id列表
linkDetails Array 关系边明细列表
label String 关系边明细的label
linkId String 关系边明细的id
linkType String 关系边明细类型
linkProps Array< Property > 关系边明细属性列表
< Property > < String,String > 关系属性KV值,K为关系边属性类型,和I+后台配置的关系边属性类型一致,V为关系边属性值,比如”L0003P0001”:”乘车时间”

7.4. 示例

7.4.1. 请求示例
  1. {
  2. "type": "remote",
  3. "degree": "3",
  4. "objects": {
  5. "O0003": [
  6. "O0003P0004-37141137******5795",
  7. "O0003P0004-89375189******6906"
  8. ],
  9. "O0004":[
  10. "O0004P0002-HB1163",
  11. "O0004P0002-HB1985",
  12. "O0004P0002-HB4999"
  13. ]
  14. },
  15. "links": [
  16. {
  17. "linkType": "L0003",
  18. "propertyList": [],
  19. "derivated": []
  20. },
  21. {
  22. "linkType": "L0004",
  23. "propertyList": [
  24. {
  25. "propertyId": "L0004CC002",
  26. "propertyType": "string_like",
  27. "values": [
  28. "11"
  29. ]
  30. }
  31. ],
  32. "derivated": [
  33. {
  34. "count": {
  35. "propertyType": "string_equal",
  36. "values": [
  37. "1"
  38. ]
  39. },
  40. "propIds": [
  41. "L0004CC002"
  42. ],
  43. "intervaltime": []
  44. }
  45. ]
  46. }
  47. ],
  48. "targetObjects": [
  49. {
  50. "objectType": "O0003",
  51. "propertyList": [
  52. {
  53. "propertyId": "O0003P0002",
  54. "propertyType": "string_like",
  55. "values": [
  56. "22"
  57. ]
  58. }
  59. ]
  60. }
  61. ]
  62. }
7.4.2. 返回示例
  1. {
  2. "data": {
  3. "linkCnt": 2,
  4. "linkDetails": {
  5. "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
  6. "label": "乘火车",
  7. "linkId": "L0003^27b44b00fcf663b8fdfad968f8a2eba9",
  8. "linkType": "L0003",
  9. },
  10. "L0003^49052e268251cf1b8252c407961e132a": {
  11. "label": "乘火车",
  12. "linkId": "L0003^49052e268251cf1b8252c407961e132a",
  13. "linkType": "L0003"
  14. }
  15. },
  16. "linkProps": {
  17. "L0003^27b44b00fcf663b8fdfad968f8a2eba9": {
  18. "L0003P0001":"",
  19. "L0003P0002":"",
  20. } ,
  21. "L0003^49052e268251cf1b8252c407961e132a": {
  22. "L0003P0001":"",
  23. "L0003P0002":"",
  24. }
  25. },
  26. "links": [
  27. {
  28. "id": "O0003#O0003P0004-89375189******6906^O0004#O0004P0002-HB1163",
  29. "linkDetails": [
  30. "L0003^27b44b00fcf663b8fdfad968f8a2eba9"
  31. ],
  32. "source": "O0003P0004-89375189******6906",
  33. "sourceType": "O0003",
  34. "target": "O0004P0002-HB1163",
  35. "targetType": "O0004"
  36. },
  37. {
  38. "id": "O0003#O0003P0004-37141137******5795^O0004#O0004P0002-HB1163",
  39. "linkDetails": [
  40. "L0003^49052e268251cf1b8252c407961e132a"
  41. ],
  42. "source": "O0003P0004-37141137******5795",
  43. "sourceType": "O0003",
  44. "target": "O0004P0002-HB1163",
  45. "targetType": "O0004"
  46. }
  47. ],
  48. "nodeCnt": 3,
  49. "nodes": {
  50. "O0003P0004-37141137******5795": {
  51. "id": "O0003P0004-37141137******5795",
  52. "label": "李四",
  53. "type": "O0003",
  54. "virtual": false
  55. },
  56. "O0003P0004-89375189******6906": {
  57. "id": "O0003P0004-89375189******6906",
  58. "label": "张三",
  59. "type": "O0003",
  60. "virtual": false
  61. },
  62. "O0004P0002-HB1163": {
  63. "id": "O0004P0002-HB1163",
  64. "label": "HB1163",
  65. "type": "O0004",
  66. "virtual": false
  67. }
  68. },
  69. "nodesProps": {
  70. "O0003P0004-37141137******5795": {
  71. "O0003P0001":"李四",
  72. "O0003P0002":"",
  73. "O0003P0003":"",
  74. "O0003P0004":"37141137******5795"
  75. },
  76. "O0003P0004-89375189******6906": {
  77. "O0003P0001":"张三",
  78. "O0003P0002":"",
  79. "O0003P0003":"",
  80. "O0003P0004":"89375189******6906"
  81. },
  82. "O0004P0002-HB1163": {
  83. "O0003P0001":"",
  84. "O0003P0002":"HB1163",
  85. "O0003P0003":""
  86. }
  87. }
  88. },
  89. "elapsedTime": 0,
  90. "noteMsg": "",
  91. "success": true
  92. }