In this Session…

Before you begin…

  • Using the Map panel to display graph data on a world map.

  • Tagging nodes

To follow along, download the files:



How To GraphXR 12. Geospatial Mapping and Tagging


Before You Begin…

Ideally, you’ll have worked through Module 11. Editing. If you’re starting here, and you want to follow along, you’ll need to:

  • Log in to GraphXR , create a Project, and open its graph space.

  • Download, which contains the Game of Thrones data we’re using in this tutorial series.


Although Game of Thrones takes place in a fictional world, we can map the locations where it was filmed. Click Clean Graph to remove data from the graph, then drag and drop the Locations.kml file into GraphXR. A node is created for each filming location.


.KML and .KMZ (Keyhole Markup Language and Keyhole Markup Zip) files are used by mapping applications such as Google Earth. Because they contain latitude and longitude information, we can map these files in GraphXR.


Open the Map panel to display the world map (the default map is powered by Mapbox). The location nodes are dropped onto the map and the map automatically zooms to display just the locations present in the graph data.


Click the Map Control toggle to pan the map with left click drag and zoom with mouse scroll.  While in Map Control mode, 3D navigation is disabled.


You can search for locations by name in the Search Location bar. Click a location name to center the map on it.


Now deactivate Map Control to return to 3D navigation. You still zoom using the  mouse scroll, but now left click drag rotates and tilts the map in three dimensions.


Now let’s group our locations by hotter or cooler climate. To do that, we’ll use the Tag function, which lets us create temporary groups of nodes regardless of their existing category. Select nodes toward the south and click the Tag icon.


In the Manager Tags dialog, enter a tag label (Warmer) and click Add Tag..


We’ve now created a tag called “Warmer” containing 37 nodes. A badge appears on each tagged node. If we want to remove the tag, we could click Clean Node Tags, but let’s create a few more tags instead.


In the graph, select mid-latitude nodes in Britain, click the Tag icon and enter a new ”Cooler” tag. Go back to the graph and select nodes in Iceland and add a “Cold” tag. You can click Save Tags as Property to add a _graphxrtags property to all tagged nodes.


The tag label (e.g. Warmer, Cooler, Cold) is entered as the _graphxrtags property value. If you give a node more than one tag, the tag labels are separated by colons.


So far nothing visibly changed in the graph. Let’s switch to Tag mode in the Legend. Now nodes for each of our three tags are given separate colors.


You can select all nodes with a given tag by clicking the tag label. You can also click the dot next to the tag label to choose a different tag color.


We’ve used the default Mapbox map server so far. In the Map panel you can click Setting to choose a different available Map Server such as Google or OpenStreetMaps.


The map changes immediately when you select a different map server.


When you click Hide Map, the nodes, which were pinned to the 3D map, are released and returned to a Force layout.

Next Steps…