Skip to content

Commit 679209b

Browse files
authored
[Maps] 7.9 documenation updates (#71893)
* [Maps] 7.9 documenation updates * more cleanup * add vector tiles card to tile layers page
1 parent 36ff576 commit 679209b

File tree

5 files changed

+18
-40
lines changed

5 files changed

+18
-40
lines changed

docs/maps/heatmap-layer.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@ Heat map layers cluster point data to show locations with higher densities.
77
[role="screenshot"]
88
image::maps/images/heatmap_layer.png[]
99

10-
To add a heat map layer to your map, click *Add layer*, then select the *Heat map* layer.
11-
The index must contain at least one field mapped as {ref}/geo-point.html[geo_point].
10+
To add a heat map layer to your map, click *Add layer*, then select *Heat map*.
11+
The index must contain at least one field mapped as {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape].
1212

1313
NOTE: Only count, sum, unique count metric aggregations are available with the grid aggregation source and heat map layers.
1414
Average, min, and max are turned off because the heat map will blend nearby values.

docs/maps/maps-aggregations.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Grid aggregation layers use {ref}/search-aggregations-bucket-geotilegrid-aggrega
4747
Symbolize grid aggregation metrics as:
4848

4949
*Clusters*:: Creates a <<vector-layer, vector layer>> with a cluster symbol for each gridded cell.
50-
The cluster location is the weighted centroid for all geo-points in the gridded cell.
50+
The cluster location is the weighted centroid for all documents in the gridded cell.
5151

5252
*Grid rectangles*:: Creates a <<vector-layer, vector layer>> with a bounding box polygon for each gridded cell.
5353

@@ -60,7 +60,7 @@ To enable a grid aggregation layer:
6060
To enable a blended layer that dynamically shows clusters or documents:
6161

6262
. Click *Add layer*, then select the *Documents* layer.
63-
. Configure *Index pattern* and the *Geospatial field*. To enable clustering, the *Geospatial field* must be set to a field mapped as {ref}/geo-point.html[geo_point].
63+
. Configure *Index pattern* and the *Geospatial field*.
6464
. In *Scaling*, select *Show clusters when results exceed 10000*.
6565

6666

docs/maps/maps-getting-started.asciidoc

Lines changed: 6 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -68,40 +68,17 @@ The first layer you'll add is a choropleth layer to shade world countries
6868
by web log traffic. Darker shades symbolize countries with more web log traffic,
6969
and lighter shades symbolize countries with less traffic.
7070

71-
==== Add a vector layer to display world country boundaries
72-
7371
. Click *Add layer*.
74-
. Select the *EMS Boundaries* layer.
72+
. Select *Choropleth*.
7573
. From the *Layer* dropdown menu, select *World Countries*.
74+
. Under *Statistics source*, set *Index pattern* to *kibana_sample_data_logs*.
75+
. Set *Join field* to *geo.src*.
7676
. Click the *Add layer* button.
7777
. Set *Name* to `Total Requests by Country`.
7878
. Set *Opacity* to 50%.
7979
. Click *Add* under *Tooltip fields*.
8080
. In the popover, select *ISO 3166-1 alpha-2 code* and *name* and click *Add*.
81-
82-
===== Join the vector layer with the sample web log index
83-
84-
You now have a vector layer containing the world countries.
85-
To symbolize countries by web traffic, you'll need to augment the world country features with the count of Elasticsearch weblog documents originating from each country.
86-
To do this, you'll create a <<terms-join, term join>> to link the vector source *World Countries* to
87-
the {es} index `kibana_sample_data_logs` on the shared key iso2 = geo.src.
88-
89-
. Click plus image:maps/images/gs_plus_icon.png[] next to the *Term Joins* label.
90-
. Click *Join --select--*
91-
. Set *Left field* to *ISO 3166-1 alpha-2 code*.
92-
. Set *Right source* to *kibana_sample_data_logs*.
93-
. Set *Right field* to *geo.src*.
94-
. Click *and use metric count*.
95-
. Set *Custom label* to *web logs count*.
96-
97-
===== Set the layer style
98-
99-
All of the world countries are still a single color because the layer is using <<maps-vector-style-static, static styling>>.
100-
To shade the world countries based on which country is sending the most requests, you'll need to use <<maps-vector-style-data-driven, data driven styling>>.
101-
102-
. Under *Fill color*, change the selected value from *Solid* to *By value*.
103-
. In the field select input, select *web logs count*.
104-
. Select the grey color ramp.
81+
. Under *Fill color*, select the grey color ramp.
10582
. Under *Border color*, change the selected color to *white*.
10683
. Click *Save & close*.
10784
+
@@ -127,7 +104,7 @@ This layer displays web log documents as points.
127104
The layer is only visible when users zoom in the map past zoom level 9.
128105

129106
. Click *Add layer*.
130-
. Click the *Documents* layer.
107+
. Select *Documents*.
131108
. Set *Index pattern* to *kibana_sample_data_logs*.
132109
. Click the *Add layer* button.
133110
. Set *Name* to `Actual Requests`.
@@ -161,7 +138,7 @@ image::maps/images/grid_metrics_both.png[]
161138
===== Add the layer
162139

163140
. Click *Add layer*.
164-
. Click the *Clusters and grids* layer.
141+
. Select *Clusters and grids*.
165142
. Set *Index pattern* to *kibana_sample_data_logs*.
166143
. Click the *Add layer* button.
167144
. Set *Name* to `Total Requests and Bytes`.

docs/maps/tile-layer.asciidoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Tile layers display image tiles served from a tile server.
77
[role="screenshot"]
88
image::maps/images/tile_layer.png[]
99

10-
To add a tile layer to your map, click *Add layer*, then select one of the following layers:
10+
To add a tile layer to your map, click *Add layer*, then select one of the following:
1111

1212
*Configured Tile Map Service*:: Tile map service configured in kibana.yml.
1313
See map.tilemap.url in <<settings>> for details.
@@ -16,4 +16,6 @@ See map.tilemap.url in <<settings>> for details.
1616

1717
*Tile Map Service*:: Tile map service configured in interface.
1818

19+
*Vector tiles*:: Data service implementing the Mapbox vector tile specification.
20+
1921
*Web Map Service*:: Maps from OGC Standard WMS.

docs/maps/vector-layer.asciidoc

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,14 @@ Vector layers display points, lines, and polygons.
77
[role="screenshot"]
88
image::maps/images/vector_layer.png[]
99

10-
To add a vector layer to your map, click *Add layer*, then select one of the following layers:
10+
To add a vector layer to your map, click *Add layer*, then select one of the following:
1111

12-
*Clusters and grids*:: Geospatial data grouped in grids with metrics for each gridded cell.
13-
The index must contain at least one field mapped as {ref}/geo-point.html[geo_point].
12+
*Choropleth*:: Shaded areas to compare statistics across boundaries.
1413

15-
*Configured GeoJSON*:: Vector data from hosted GeoJSON configured in kibana.yml.
16-
See map.regionmap.* in <<settings>> for details.
14+
*Clusters and grids*:: Geospatial data grouped in grids with metrics for each gridded cell.
15+
The index must contain at least one field mapped as {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape].
1716

18-
*Documents*:: Vector data from a Kibana index pattern.
17+
*Documents*:: Points, lines, and polyons from Elasticsearch.
1918
The index must contain at least one field mapped as {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape].
2019

2120
NOTE: Document results are limited to the `index.max_result_window` index setting, which defaults to 10000.

0 commit comments

Comments
 (0)