Region maps are thematic maps in which boundary vector shapes are colored using a gradient: higher intensity colors indicate larger values, and lower intensity colors indicate smaller values. These are also known as choropleth maps.
To create a region map, you configure an inner join that joins the result of an Elasticsearch terms aggregation and a reference vector file based on a shared key.
Select any of the supported Metric or Sibling Pipeline Aggregations.
Configure a Terms aggregation. The term is the key that is used to join the results to the vector data on the map.
- Vector map: select from a list of vector maps. This list includes the maps that are hosted by the © Elastic Maps Service, as well as your self-hosted layers that are configured in the config/kibana.yml file. To learn more about how to configure Kibana to make self-hosted layers available, see the regionmap settings documentation. You can also explore and preview vector layers available in Elastic Maps Service at https://maps.elastic.co.
Join field: this is the property from the selected vector map that will be used to join on the terms in your terms-aggregation.
When terms cannot be joined to any of the shapes in the vector layer because there is no exact match in the vector layer, Kibana will display a warning.
To turn of these warnings, go to Management/Kibana/Advanced Settings and set
- Color Schema: the color range used to color the shapes.
- Legend Position: the location on the screen where the legend should be rendered.
- Show Tooltip: indicates whether a tooltip should be displayed when hovering over a shape..