如何通过TigerGraph GSQL关联Location与Action Vertex地理属性以展示在Map Widget

方案一：持久化更新Action顶点的经纬度属性（适合长期复用） #

如果希望后续所有查询都能直接获取Action的经纬度，推荐给Action顶点添加属性并批量更新：

1. 给Action顶点添加经纬度属性
   先确认你的Action顶点没有经纬度属性，执行以下GSQL命令（替换成你的图名和属性名）：

   USE GRAPH YourGraphName
   ALTER VERTEX Action ADD ATTRIBUTE (latitude DOUBLE, longitude DOUBLE);
   

   如果已经有相关属性，跳过此步骤。

2. 编写GSQL遍历查询批量更新
   假设Action与Location通过occurs_at类型的边关联（替换成你的实际边类型和方向），编写查询遍历所有Action，关联对应的Location并更新经纬度：

   USE GRAPH YourGraphName
   CREATE QUERY update_action_geo() FOR GRAPH YourGraphName {
     FOR action IN Action {
       // 找到当前Action关联的第一个Location（1对多场景需调整逻辑，比如取特定规则的Location）
       location = SELECT l FROM action - (occurs_at>)- l:Location LIMIT 1;
       IF location.size() > 0 THEN
         action.latitude = location[0].latitude;
         action.longitude = location[0].longitude;
       END;
     }
   }
   

3. 部署并运行查询
   执行命令部署查询：

   INSTALL QUERY update_action_geo
   

   运行查询完成更新：

   RUN QUERY update_action_geo()
   

   完成后，Action顶点就有了经纬度属性，直接在Map Widget中选择Action顶点，配置对应的经纬度字段即可展示。

方案二：查询时动态关联经纬度（无需修改顶点结构） #

如果不需要持久化存储，仅需在查询时临时关联Location的经纬度返回给Map Widget，可使用此方法：

1. 编写动态关联的GSQL查询
   返回包含Action属性及对应Location经纬度的结果集：

   USE GRAPH YourGraphName
   CREATE QUERY get_action_with_geo() FOR GRAPH YourGraphName {
     // 定义返回的结果结构，替换成你的Action实际属性
     TYPEDEF TUPLE <action_id STRING, action_name STRING, latitude DOUBLE, longitude DOUBLE> ActionWithGeo;
     ListAccum<ActionWithGeo> @@result;
   
     FOR action IN Action {
       location = SELECT l FROM action - (occurs_at>)- l:Location LIMIT 1;
       IF location.size() > 0 THEN
         @@result += ActionWithGeo(action.id, action.name, location[0].latitude, location[0].longitude);
       END;
     }
   
     RETURN @@result;
   }
   

2. 部署查询并配置Map Widget
   部署查询后，在TigerGraph Insights的Map Widget中，选择此查询作为数据源，然后在配置面板指定返回结果中的latitude和longitude字段作为地理坐标，即可展示Action的位置。

关键注意事项 #

• 边方向与类型：务必根据你的图结构调整查询中的边类型（如occurs_at）和方向（- (edge>)-或- (<edge)-），确保能正确关联到Location顶点。
• 多关联场景处理：如果一个Action关联多个Location，需修改查询逻辑（比如取最近的Location、按业务规则筛选），避免返回错误的经纬度。
• 数据校验：运行查询前确认Location顶点的经纬度属性已正确导入CSV数据，且属性值不为空。

内容的提问来源于stack exchange，提问作者Michael