In this Session…

Before you begin…

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

  • Tagging nodes.

  • Selecting a Map Server.

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.


Game of Thrones takes place in a fictional world, but we can map the locations where it was filmed.
First, click the Clear toolbar icon to delete any data in the graph space.


Now drag and drop the Locations.kml file onto the project space. KeyholeMarkup Language (.kml) and Keyhole Markup Zip (.kmz) files are used by mapping applications such as Google Earth. Since they include latitude and longitude coordinates we can map the resulting nodes in GraphXR.


A node is created for each filming location. Open the Table panel to see the locations and their latitude / longitude properties.


The category name isn’t very descriptive, so let’s click to open an Enhanced Table and re-label the category as Location.


Now open the Map panel to display the world map (powered by Mapbox). The Location nodes are dropped onto the map and the map automatically zooms to display just the locations present in the data.


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


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


By default, map boundaries are auto-fitted to the data when you close and re-open the map panel. To have your map boundaries persist, click the map Settings button and de-select the Auto Fitting checkbox.


Now click to deactivate Map Control to return to 3D navigation. You still zoom using 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 to 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 the UK, click the Tag icon and add a ”Cooler” tag. Go back to the graph and select nodes in Iceland and add a “Cold” tag.
Optionally, click Save Tags as Property to add a _graphxrtags property to all tagged nodes.


The tag label (e.g. Warmer, Cooler, or 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 our three tags are given separate colors.


Click a tag label to select all nodes with that tag.
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, click Settings 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.


With the Map panel open, you can click Show Map again to drop the nodes back on the map.

Next, in Module 13. Querying, we’ll introduce GraphXR features for pulling in data from a connected Neo4j graph database.

Next Steps…