elastic · nreese · Oct 19, 2020 · Oct 7, 2020 · Oct 7, 2020 · Oct 8, 2020
diff --git a/docs/maps/geojson-upload.asciidoc b/docs/maps/geojson-upload.asciidoc
diff --git a/docs/maps/images/fu_gs_select_source_file_upload.png b/docs/maps/images/fu_gs_select_source_file_upload.png
diff --git a/docs/maps/import-geospatial-data.asciidoc b/docs/maps/import-geospatial-data.asciidoc
@@ -0,0 +1,30 @@
+[role="xpack"]
+[[import-geospatial-data]]
+== Import geospatial data
+
+In order to use your geospatial data in the Elastic Stack, it must be indexed as {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape].
+Kibana makes it easy to import geospatial data into the Elastic Stack.
+
+=== Upload a CSV file with latitude and longitude columns
+
+To upload a CSV file with latitude and longitude columns
+
+. Open the Kibana sidebar menu, then click *{kib} > Machine Learning*.
-. Open the Kibana sidebar menu, then click *{kib} > Machine Learning*.
+. Open the menu, then click *Machine Learning*.
-. Open the Kibana sidebar menu, then click *{kib} > Machine Learning*.
+. Open the menu, then click *Machine Learning*.
+. Select the *Data Visualizer* tab, then click *Upload file*.
+. Use the file chooser to select a CSV file.
+. Click *Import*.
+. Select the *Advanced* tab.
+. Set *Index name*.
+. Click *Add combined field*, then click *Add geo point field*.
+. Fill out the *ADD GEO POINT FIELD* form and click *Add*.
+. Click *Import*.
+
+=== Upload a GeoJSON file
+
+To upload a GeoJSON file:
+
+. <<maps-create>>
+. Click *Add layer*.
+. Select *Upload GeoJSON*.
+. Use the file chooser to select a GeoJSON file.
+. Click *Import file*.
diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc
@@ -56,6 +56,6 @@ include::maps-aggregations.asciidoc[]
 include::search.asciidoc[]
 include::map-settings.asciidoc[]
 include::connect-to-ems.asciidoc[]
-include::geojson-upload.asciidoc[]
+include::import-geospatial-data.asciidoc[]
 include::indexing-geojson-data-tutorial.asciidoc[]
 include::trouble-shooting.asciidoc[]
diff --git a/docs/maps/indexing-geojson-data-tutorial.asciidoc b/docs/maps/indexing-geojson-data-tutorial.asciidoc
@@ -47,7 +47,7 @@ image::maps/images/fu_gs_new_england_map.png[]
 For each GeoJSON file you downloaded, complete the following steps:
 
 . Click *Add layer*.
-. From the list of layer types, click *Uploaded GeoJSON*.
+. From the list of layer types, click *Upload GeoJSON*.
 . Using the File Picker, upload the GeoJSON file.
 +
 Depending on the geometry type of your features, this will

diff --git a/docs/maps/map-settings.asciidoc b/docs/maps/map-settings.asciidoc
@@ -9,12 +9,16 @@ To access these settings, click *Map settings* in the application toolbar.
 [[maps-settings-navigation]]
 === Navigation
 
+*Auto fit map to bounds*::
+When enabled, the map will automatically pan and zoom to show the filtered data bounds.
+
 *Zoom range*::
 Constrain the map to the defined zoom range.
 
 *Initial map location*::
 Configure the initial map center and zoom.
 * *Map location at save*: Use the map center and zoom from the map position at the time of the latest save.
+* *Auto fit map to bounds*: Set the initial map location to show the filtered data bounds.
 * *Fixed location*: Lock the map center and zoom to fixed values.
 * *Browser location*: Set the initial map center to the browser location.
 

diff --git a/docs/maps/maps-getting-started.asciidoc b/docs/maps/maps-getting-started.asciidoc
@@ -50,7 +50,7 @@ In this tutorial, you'll learn to:
 
 The first thing to do is to create a new map.
 
-. If you haven't already, open the menu, then click *{kib} > Maps*.
+. If you haven't already, open the Kibana sidebar menu, then click *{kib} > Maps*.
 . On the maps list page, click *Create map*.
 . Set the time range to *Last 7 days*.
 +

diff --git a/docs/maps/search.asciidoc b/docs/maps/search.asciidoc
@@ -49,13 +49,15 @@ Spatial filters have the following properties:
 * *Geometry label* enables you to provide a meaningful name for your spatial filter.
 * *Spatial field* specifies the geo_point or geo_shape field used to determine if a document matches the spatial relation with the specified geometry.
 * *Spatial relation* determines the {ref}/query-dsl-geo-shape-query.html#_spatial_relations[spatial relation operator] to use at search time. Only available when *Spatial field* is set to geo_shape.
+* *Action* specifies where the filter will be applied. Select *Apply filter to current view* to apply the filter to the current view. Select a drilldown action to apply the filter to the drilldown action. Only available when the map is a panel in a {kibana-ref}/dashboard.html[dashboard] with {kibana-ref}/drilldowns.html[drilldowns].
 
 [float]
 [[maps-phrase-filter]]
 ==== Phrase filters
 
 A phrase filter narrows search results to documents that contain the specified text.
 You can create a phrase filter by clicking the plus icon image:maps/images/gs_plus_icon.png[] in a <<maps-vector-tooltip-locking, locked tooltip>>.
+When the map is a panel in a {kibana-ref}/dashboard.html[dashboard] with {kibana-ref}/drilldowns.html[drilldowns], you can apply a phrase filter to a drilldown by selecting the drilldown action.
 
 [role="screenshot"]
 image::maps/images/create_phrase_filter.png[]

diff --git a/docs/maps/vector-layer.asciidoc b/docs/maps/vector-layer.asciidoc
@@ -17,8 +17,19 @@ The index must contain at least one field mapped as {ref}/geo-point.html[geo_poi
 *Documents*:: Points, lines, and polyons from Elasticsearch.
 The index must contain at least one field mapped as {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape].
 
-NOTE: Document results are limited to the `index.max_result_window` index setting, which defaults to 10000.
-Use <<maps-aggregations, aggregations>> to plot large data sets.
+Results are limited to the `index.max_result_window` index setting, which defaults to 10000.
+Select the appropriate *Scaling* option for your use case.
+
+* *Limit results to 10000.* The layer displays features from the first `index.max_result_window` documents.
+Results exceeding `index.max_result_window` are not displayed.
+
+* *Show top hits per entity.* The layer displays the <<maps-top-hits-aggregation, most relevant documents per entity>>.
+
+* *Show clusters when results exceed 10000.* When results exceed `index.max_result_window`, the layer uses {ref}/search-aggregations-bucket-geotilegrid-aggregation.html[GeoTile grid aggregation] to group your documents into clusters and displays metrics for each cluster. When results are less then `index.max_result_window`, the layer displays features from individual documents.
+
+* *Use vector tiles.* Vector tiles partition your map into 6 to 8 tiles.
+Each tile request is limited to the `index.max_result_window` index setting.
+Tiles exceeding `index.max_result_window` provide a visual indication that there are too many features to display.
 
 *EMS Boundaries*:: Administrative boundaries from https://www.elastic.co/elastic-maps-service[Elastic Maps Service].