Designer Layers Drilling
Drilling properties allow you to create a geographic hierarchy so you can navigate up and down from regions to administrative areas and even points.
Introduction to Drilling
Drill level is a numeric value starting at 1 as the top layer in the hierarchy. As you drill down you will move from level 1 to 2 to 3 and so on.
The top layer, enter “1”
Currently there are 2 options for triggering a drill action.
Clicking on a Layer will immediately drill without displaying the InfoWindow
Clicking on a layer will display the InfoWindow and present you with a drill icon inside of the InfoWindow
Select the parent layer that is one layer up in the hierarchy.
Introduction to Drilling with CMaps Analytics DesignerCMaps Analytics views natively support drilling between maps layers using a geographic hierarchy definition. CMaps Analytics drilling requires 2 configuration steps:
1. Create geographic hierarchy with Layer drill behaviors:For each layer, you can view Drilling properties in the "Appearance" tab.
Drill LevelDrill level is a numeric value starting at 1 as the top layer in the hierarchy. As you drill down you will move from level 1 to 2 to 3 and so on. The top layer, enter "1"
Drill WhenCurrently there are 2 options for triggering a drill action.
Layer ClickedClicking on a Layer will immediately drill without displaying the InfoWindow
InfoWindow IconClicking on a layer will display the InfoWindow and present you with a drill icon inside of the InfoWindow
Drill ParentSelect the parent layer that is one layer up in the hierarchy. Learn more about drill behaviors
STEP 2. Layer Drill Keys and Properties:To configure drilling between layers, you need to establish a data relationship, which is accomplished through a drill key definition. For example, if you click on a state and want to see city icons appear for that given state, the states layer and cities layer both need to be connected. This is the role of layer drill keys. The following example demonstrates:
Layer 1: Top LayerFor layer 1, which is the top layer, we have regions east and west. The drill IDs will correspond to layer 2 drill IDs. DATA Label | Drill ID West Region West East Region East PROPERTIES The top layer in your drill hierarchy will have a Drill Level = 1. You can set the Drill When trigger to either drill when a layer is clicked, or when an end user clicks on a drill icon inside of the InfoWindow. The Drill Parent for Layer 1 will be set to "Any Layer Above Me."
Layer 2: Child LayerLayer 2 has a drill ID that corresponds to layer 1. So when a user clicks on "West", CMaps Analytics will automatically display only the locations with the drill ID "West" DATA Label | Drill ID CA West NV West NY East FL East PROPERTIES The second layer is a "child layer" that is dependant on the "parent layer" (layer 1). This second layer is Drill Level = 2. You can set the Drill When trigger to any value, because there is no additional child layers. The Drill Parent for Layer 2 will be set to the specific layer that contains corresponding drill IDs. In this example Layer 1 (named Regions), is the drill parent.
3 Layer Hierarchy ExampleTo add more than 2 layers, the Drill ID data property will serve as a reference for the parent layer, and also needs to drive child layers. In this scenario, the data format for Layer 2 changes slightly. The following shows the same example with 3 layers of geographic hierarchy. Layer 1 Label | Drill ID West West East East Layer 2 The big difference with a geographic hierarchy with more than two layers is a need for parent and child drill IDs. In this example, Layer 2 needs to contain the keys as you drill from layer 1. Because there is also a dependent 3rd layer, there needs to be a second set of keys to drive the drill path. To do this, place the parent and child drill IDs with a "|" delimiter. Label | Drill ID CA West|CA NV West|NV NY East|NY FL East|FL Layer 3 Label | Drill ID Los Angeles CA San Diego CA Nevada NV Reno NV Learn more about layer properties
Other Drilling OptionsDrilling via OLAP style reporting or dashboard integrations, additional integration steps are required using the CMaps Analytics API. Please contact CMaps Analytics support for additional guidance and support.