diff --git a/docs/redirects.asciidoc b/docs/redirects.asciidoc index f6da4953c3dee..69a909419be19 100644 --- a/docs/redirects.asciidoc +++ b/docs/redirects.asciidoc @@ -80,4 +80,9 @@ This page has moved. Please see <>. [role="exclude",id="tilemap"] == Coordinate map -This page has moved. Please see <>. +This page has moved. Please see <>. + +[role="exclude",id="visualize-maps"] +== Maps + +This page has moved. Please see <>. diff --git a/docs/setup/settings.asciidoc b/docs/setup/settings.asciidoc index 63d4e7ce63d59..501c36175cb69 100644 --- a/docs/setup/settings.asciidoc +++ b/docs/setup/settings.asciidoc @@ -227,15 +227,13 @@ requests. Supported on {ece}. `map.includeElasticMapsService:`:: *Default: true* Set to false to disable connections to Elastic Maps Service. When `includeElasticMapsService` is turned off, only the vector layers configured by `map.regionmap` -and the tile layer configured by `map.tilemap.url` will be available in the <>, -<>, and <>. +and the tile layer configured by `map.tilemap.url` will be available in <>. `map.proxyElasticMapsServiceInMaps:`:: *Default: false* Set to true to proxy all <> Elastic Maps Service requests through the Kibana server. -This setting does not impact <> and <>. [[regionmap-settings]] `map.regionmap:`:: Specifies additional vector layers for -use in <> visualizations. Supported on {ece}. Each layer +use in <> visualizations. Supported on {ece}. Each layer object points to an external vector file that contains a geojson FeatureCollection. The file must use the https://en.wikipedia.org/wiki/World_Geodetic_System[WGS84 coordinate reference system] diff --git a/docs/user/visualize.asciidoc b/docs/user/visualize.asciidoc index 8fe82d6c28b6d..e8c3f666cee28 100644 --- a/docs/user/visualize.asciidoc +++ b/docs/user/visualize.asciidoc @@ -40,11 +40,7 @@ data sets. Maps:: * *<>* — Displays geospatial data in {kib}. -* *<>* — Displays points on a map using a geohash aggregation. - -* *<>* — Merges any structured map data onto a shape. - -* *<>* — Displays shaded cells within a matrix. +* <>:: Display shaded cells within a matrix. <>:: @@ -138,7 +134,6 @@ include::{kib-repo-dir}/visualize/most-frequent.asciidoc[] include::{kib-repo-dir}/visualize/tsvb.asciidoc[] include::{kib-repo-dir}/visualize/timelion.asciidoc[] -include::{kib-repo-dir}/visualize/tilemap.asciidoc[] include::{kib-repo-dir}/visualize/heatmap.asciidoc[] include::{kib-repo-dir}/visualize/for-dashboard.asciidoc[] diff --git a/docs/visualize/tilemap.asciidoc b/docs/visualize/tilemap.asciidoc index aa80c96f2cac4..6e5b835b67c3a 100644 --- a/docs/visualize/tilemap.asciidoc +++ b/docs/visualize/tilemap.asciidoc @@ -1,98 +1,40 @@ -[[visualize-maps]] -== Maps +[[heat-map]] +== Heat map -To tell a story and answer questions about your geographical data, you can create several types of interactive maps with Visualize. - -Visualize supports the following maps: - -* *Coordinate* — Display latitude and longitude coordinates that are associated to the specified bucket aggregation. - -* *Region* — Display colored boundary vector shapes using a gradient. Darker colors indicate larger values, and lighter colors indicate smaller values. - -NOTE: The maps in Visualize have been replaced with <>, which offers more functionality. - -[float] -[[coordinate-map]] -=== Coordinate map - -Use a coordinate map when your data set includes latitude and longitude values. For example, use a coordinate map to see the varying popularity of destination airports using the sample flight data. +Display graphical representations of data where the individual values are represented by colors. Use heat maps when your data set includes categorical data. For example, use a heat map to see the flights of origin countries compared to destination countries using the sample flight data. [role="screenshot"] -image::images/visualize_coordinate_map_example.png[] +image::images/visualize_heat_map_example.png[] [float] -[[build-coordinate-map]] -==== Build a coordinate map - -Configure the `kibana.yml` settings and add the aggregations. +[[build-heat-map]] +=== Build a heat map -. Configure the following `kibana.yml` settings: +To display your data on the heat map, use the supported aggregations. -* Set `xpack.maps.showMapVisualizationTypes` to `true`. - -* To use a tile service provider for coordinate maps other than https://www.elastic.co/elastic-maps-service[Elastic Maps Service], configure the <>. - -. To display your data on the coordinate map, use the following aggregations: +Heat maps support the following aggregations: * <> - -* <> - -. Specify the geohash bucket aggregation options: - -* *Precision* slider — Determines the granularity of the results displayed on the map. To show the *Precision* slider, deselect *Change precision on map zoom*. For information on the area specified by each precision level, refer to {ref}/search-aggregations-bucket-geohashgrid-aggregation.html#_cell_dimensions_at_the_equator[geohash grid]. -+ -NOTE: Higher precisions increase memory usage for the browser that displays {kib} and the underlying -{es} cluster. - -* *Place markers off grid (use {ref}/search-aggregations-metrics-geocentroid-aggregation.html[geocentroid])* — When you selected, the markers are -placed in the center of all documents in the bucket, and a more accurate visualization is created. When deselected, the markers are placed in the center -of the geohash grid cell. -+ -NOTE: When you have multiple values in the geo_point, the coordinate map is unable to accurately calculate the geo_centroid. - -[float] -[[navigate-coordinate-map]] -==== Navigate the coordinate map - -To navigate the coordinate map, use the navigation options. - -* To move the map center, click and hold anywhere on the map and move the cursor. - -* To change the zoom level, click *Zoom In* or *Zoom out* image:images/viz-zoom.png[]. - -* To automatically crop the map boundaries to the -geohash buckets that have at least one result, click *Fit Data Bounds* image:images/viz-fit-bounds.png[]. - -[float] -[[region-map]] -=== Region map - -Use region maps when you want to show statistical data on a geographic area, such as a county, country, province, or state. For example, use a region map if you want to see the average sales for each country with the sample eCommerce order data. - -[role="screenshot"] -image::images/visualize_region_map_example.png[] +* <> +* <> +* <> [float] -[[build-region-maps]] -==== Build a region map +[[navigate-heatmap]] +=== Change the color ranges -Configure the `kibana.yml` settings and add the aggregations. +When only one color displays on the heat map, you might need to change the color ranges. -. In `kibana.yml`, set `xpack.maps.showMapVisualizationTypes` to `true`. +To specify the number of color ranges: -. To display your data on the region map, use the following aggregations: +. Click *Options*. -* <> -* <> -* <> +. Enter the *Number of colors* to display. -[float] -[[navigate-region-map]] -==== Navigate the region map +To specify custom ranges: -To navigate the region map, use the navigation options. +. Click *Options*. -* To change the zoom level, click *Zoom In* or *Zoom out* image:images/viz-zoom.png[]. +. Select *Use custom ranges*. -* To automatically crop the map boundaries, click *Fit Data Bounds* image:images/viz-fit-bounds.png[]. +. Enter the ranges to display. \ No newline at end of file