Region Map renders data that contains latitude and longitude information, but instead of placing icons, the Region Map plots geometric shapes (which represent regions) using GeoJSON.
Base Map configuration for a Region Map is similar to an Icon Map.
A symbolic name used to represent this Visualization. This is the name that will show up in choosers when adding a Visualization to a page.
The Tile Provider controls what the map looks like. Each tile set provides its own look and feel, as well as min and max zoom ranges. These ranges are included on the right hand side of the pull-down.
Refer to the Map Tiles and Overlays section for more information.
Choose the minimum zoom level that the map is allowed to show. This option is only enabled when you choose No for Default Zoom Levels.
Choose the maximum zoom level that the map is allowed to show. This option is only enabled when you choose No for Default Zoom Levels.
This sets the default zoom level for the map.
This sets the Latitude for the center point of the map.
This sets the Longitude for the center point of the map.
Determines the placement of the zoom control on the map. Options are:
Enables options for looking up current location based off an address.
This is where a Region Map starts to differ from an Icon Map. Instead of placing icons, the Region Map plots geometric shapes. It uses GeoJSON to define these regions.
The Attribute in the data source that contains GeoJSON file names. For example, the data source attribute File has U.S. states GeoJSON file names to be used in conjunction with “GeoJSON File URI”.
See the “Working with GeoJSON Files” section below.
Enter a relative URI to the GeoJSON files specified in the “GeoJSON File Attribute”. It will start from /custom which is file system location /static-web of the edgeSuite deployment.
The example above translates to the following web URI:
The web URI will point at the following directory on the server:
Determines how the fill color of the regions is determined.
The “Static” fill option applies the same static color to all regions.
Determines a static fill color for all regions.
Determines the alpha for all regions. The Alpha value allows underlying map detail to show through the region.
Determines the border size to use for all regions.
Determines the alpha value for the border. The alpha value allows underlying map detail to show through the border.
The “Derived” fill option determines a region’s color based on values in the data. This options allows fill color to change based upon a set of rules.
This is the only property required for a derived fill. The individual rules within this rule set are what will determine the fill color of a region.
See the Rule Sets section for more information.
Determines whether to show a textual label in the center of each region.
Determines whether to show an icon in the center of each region.
For a Region Map that uses “FeatureCollection”, marker/label settings do not apply. FeatureCollection is used for complex regions containing multiple polygons. Because there is an array of polygons defining a region, edgeSuite is unable to determine which polygon to use when calculating marker and label placement.
A Label and Marker tab will appear if either “Show Label” or “Show Marker” is set to Yes on the previous step.
Marker properties will appear if “Show Marker” is set to Yes on the previous step.
See Icon Renderer for more information.
Label properties will appear if “Show Label” is set to Yes on the previous step. Otherwise, the position of the label will be centered in the region.
Choose an attribute from the data that contains values to be used as a label.
Configure a formatter for the label.
This section determines how the “Marker” and “Label” are positioned, relative to one another. This option is only available if “Show Marker” is also set to Yes on the previous step. Otherwise, the position of the label will be centered in the region.
Determines where the label is positioned within a region.
This is will appear on the “Base Map” step of the wizard if:
The legend’s colors and labels will be rendered from the derived rules’ color and label, see Rule Sets for more detail. If both cases are true, then the rule values from Fill will be used.
The Region Map is limited to only a weather layer. For information on other layers, refer to Icon Map.
If weather is enabled, an additional wizard step is revealed providing an administrator additional configuration options.
This step previews the end result based on the configuration choices made.
GeoJSON is a format for encoding a variety of geographic data structures. This Visualization uses one file per area to represent the desired regions for display. An area can be a country, state, continent, or any other shape on a map. A way to generate the GeoJSON files is to search for the region by name here:
For example, a search for “Texas” there will return a list of entities with matching names. The top item in the resulting list is “State Boundary Texas, United States of America“. Click on that link to go to that page. At the top of the page it says “Relation: Texas (114690)“.
The number in the parentheses is the entity ID. To find the GeoJSON to download for the searched area, enter its ID number into the field labeled “Id of relation” on this page:
When submitted, the site returns a list of available polygons for the ID that was provided. The top (or only) row lists the full resolution polygon and the number of points constituting it. For the Texas example, the number of points is over 38k – excessive for use in the Visualization. There is an option to generate a simplified version of the geometry below. Adjust the X, Y and Z fields and submit to generate the reduced version. It is recommended to accept the defaults for Y and Z, but to set X to zero so that neighboring areas do not overlap. For Texas, this produces an object with approximately 800 points. From that entry in the list, download the GeoJSON link, saving it with a .json file extension.
To make GeoJSON files available to the Region Map Visualization, place the generated GeoJSON files into the /custom directory, which is located in the /static-web directory of the edgeSuite deployment. You can create the /custom directory if it does not already exist in the /static-web directory.