Adding custom points or regions to a map

You can enhance IBM® Cognos® Analytics with Watson maps by adding custom point or region information from Mapbox to them. You do this by adding a layer on the map to display the additional information.

Before you begin

You must have created a tileset in Mapbox that contains the custom region or point data that you want to add to the map. The tileset that Mapbox generates has the following properties. You must have these values ready to configure in your map:
  • Map ID
  • Layer name
  • Property name


  1. Click New, and then click Report.
  2. In the Templates and themes window, click Blank, and then click OK.
  3. On the canvas, click the Pinned icon pinned items icon, and then click Visualization.
  4. In the Visualization gallery, click Map, and then click OK.
  5. In the left pane, click the Add report data icon pinned items icon, select report data that contains region or point data.
  6. On the data slot pane, click the down arrow and select:
    • Regions, if you want to use region data from Mapbox.
    • Points, if you want to use point data from Mapbox.
  7. In the left pane, expand your data items and drag point or region data to the Locations data slot.
  8. Drag a measure to the Location color or Point color data slot.
  9. Specify the properties for the custom region or point data. You must obtain the values of the properties for Map ID, Layer name, and Property name from the Mapbox. Make sure the visualization is selected on the canvas, and in the Properties pane, under REGIONS or POINTS, specify the following properties:
    Note: Use the same sentence case as used in the Mapbox properties.
    Option Description
    Transparency Transparency of the region fill. 0 is fully opaque and 100 is completely transparent.
    Map ID The Mapbox unique map ID
    Layer name The layer name that is used in the Mapbox map
    Property name The custom property name that you want to use from the Mapbox map
    Applies to version 11.1.0 and subsequent versions unless specifically overridden Type Defines how points are grouped. Choices are no grouping, heat, and clustered. Applies only to points (and latitude/longitude).
  10. Select Page preview to run the report.
    Note: You can also click Run options > Run HTML to run the report.
  11. Select Page design to return to page design mode. If you ran the report from Run options, close the tab, which returns you to page design mode.


An example of a map visualization with a region layer that shows the population for each time-zone. The layout of the time-zones is defined in a Mapbox map.
A map visualization with a region layer that shows the population for each time-zone.