Add Custom Map Layers

You can add custom map layers to use in map visualizations.

You add a custom map layer using a geometric data file with the .json extension that conforms to GeoJSON schema (the maximum file size allowed is 25MB). You then use the custom map layer to view geometric map data in a project. For example, you might add a Mexico_States.json file to enable you to visualize geometric data in a map of Mexico States.
When creating a custom map layer, you must select layer keys that correspond with data columns that you want to analyze in a map visualization. For example, if you want to analyze Mexican States data on a map visualization, you might start by adding a custom map layer for Mexican States, and select HASC code layer key from the Mexican_States.json file. Here is an extract from the Mexican_States.json file that shows some of the geometric data for the Baja California state.

Description of mexstatesjsonbajasnap.gif follows
Description of the illustration mexstatesjsonbajasnap.gif

If you wanted to use the Mexican_States.json file, the layer keys that you select must match columns that you want to analyze from the Mexican States Data tables. For example, if you know there is a data cell for the Mexican state Baja California then select the corresponding name field in the JSON file to display state names in the Map visualization. When you create a project and select column (such as State, and HASC), then Mexican states are displayed on the map. When you hover the mouse pointer over a state, the HASC code (such as MX BN) for each state is displayed on the map.
  1. Open the Console page and click Maps to display the Map Layers page.

    You can perform the following actions when managing System Map Layers and Custom Map Layers.

    What action can I perform? System Map Layer Custom Map Layer
    Enable Yes Yes
    Disable Yes Yes
    Create No Yes
    Delete No Yes
  2. To add a custom map layer, click Add Custom Layer or drag and drop a JSON file from File Explorer to the Custom Maps area.
  3. Browse the Open dialog, and select a JSON file (for example, Mexico_States.json).

    The JSON file must be a GeoJSON file that conforms to the standard specified in (the maximum file size allowed is 25MB).

    Custom layers that use the Line String geometry type aren't fully supported. The Color and Size section on Visualization Grammar pane doesn't apply to line geometries.

  4. Click Open to display the Map Layer dialog.
  5. Enter a Name and an optional Description.
  6. Select the layer keys that you want to use from the Layer Keys list.
    The layer keys are a set of property attributes for each map feature, such as different codes for each state in Mexico. The layer keys originate from the JSON file. Where possible, select only the layer keys that correspond with your data.
  7. Click Add. A success message is displayed when the process is complete and the layer is added.