Skip to main content
Skip table of contents

Using Geospatial Maps

The Map panel lets you work with data positioned on a world map (using Mapbox, Google, or OpenStreetMap servers). When you open the Map panel to display the world map, nodes in the graph space that have latitude and longitude property values are automatically dropped onto the map.

Nodes with no latitude and longitude coordinates which are connected to those on the map are also displayed, with their connecting edges, positioned above the map. By default, a force-directed layout is used for these nodes, unless they have been arranged using a geometric layout.

Nodes with geospatial coordinates are pinned to the map. This is usually desirable, but you can release the nodes using the Pin/Release toolbar icon or Actions>Release in the right-click menu. To drop the released nodes on the map again, click Show Map.

Format for Latitude and Longitude coordinates

Geospatial data must be encoded in the data in separate latitude(lat) and longitude(lng) properties as follows:

Property Name

Example Value







The lat and lng values must be floating point, not strings. Most lat-long data are encoded that way, but if not, strings can be transformed using the toNumber or a custom transform in the f(x) transform panel.

The .KML and .KMZ (Keyhole Markup Language/Keyhole Markup Zip) files used by mapping applications such as Google Earth contain appropriately encoded coordinates, and you can map these files directly in GraphXR.

Navigating and working with mapped data

When you click Map in the Main Menu, the Map panel opens, automatically displaying nodes pinned to their geospatial locations on a map surface rendered in the 3D graph space.

Desktop navigation and data selection is the same as for other layouts. You can:

  • Navigate the mapped nodes using any GraphXR navigation method (for example, pan, zoom, rotate, Center To a single node or selection of nodes, and Fly Out to view all the mapped data)

  • Select nodes using any selection method, and perform any of the data transformations, editing, or tagging available in the graph space.

  • Save snapshot views for use in data visualization.

For example, in the map below, tags have been created to assign regions to sets of nodes.

You can use a tag to select nodes by region then click the Center To icon to zoom in to the center point of the selection on the map.

Using the Map Panel

Click the Map menu item to display the Map panel, which includes

  • Show Map to re-set the map (for example, after you have zoomed in to selected data, or flown away to a search location).

  • Hide Map to dismiss the map.

  • Search Location bar to enter a place name and fly to that location.

  • Map Control to reposition the map and adjust its boundaries.

  • Setting to select a map server, install custom map servers, and set Mode and Auto Fitting options.

Using Show Map and Hide Map

Opening the Map panel automatically displays a map with boundaries set according to the coordinates in your data, and drops your graph data onto it.

  • Click Hide Map to hide the map and return nodes to a default force layout.

  • Click Show Map to:

    • Show the initial map again after using Hide Map.

    • Reset the map to its initial position after using Search Location or Map Control.

You can click the Map panel icon to dismiss the panel. This only removes the panel, not the map. When you are done working with a map, click Map to open the panel, then click Hide Map.

Flying to a Search Location

You can fly to any named world location or region by entering its name in the Search Location bar. There does not need to be any mapped data for that location.

To fly to a named location:

  1. Open the Map panel.

  2. In the Search Location bar, enter the name of a location (e.g. United Kingdom) and click it on the search list.
    The map centers on the named location.

  3. To reset the map, clear the search by clicking the x icon in the search bar, then click Show Map.

Using Map Control

A map boundary is initially set based on the locations in the graph data, but a wider view is often desirable, for example, to display additional areas for which there is no data. Map Control mode lets you adjust the map boundary temporarily.

When you click Map Control, 3D navigation is de-activated.

To adjust map boundaries:

  1. Open the Map panel and click Map Control.
    The button turns blue, indicating you are in map control mode.

  2. Set the map boundaries with the following mouse controls or their equivalent keyboard shortcuts:
    • Pan (left mouse click drag)
    • Zoom (mouse scroll or 2+left mouse click drag)

  3. Click Map Control to exit and resume 3D navigation with the adjusted map.

Whenever you click Show Map, map boundaries are reset to the initial area bounded by the locations in the data. To retain adjusted boundaries you set in Map Control, de-select the AutoFitting checkbox in the Setting dialog.

Using Map Setting options

Map Setting options let you:

  • Select an installed map server (e.g. MapBox, Google or OpenStreetMap)

  • Add or delete custom map servers.

  • Set a Wall or Floor mode.

  • Select or de-select the Auto Fitting option.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.