diff --git a/docs/maps/images/timeslider_toggle_icon.png b/docs/maps/images/timeslider_toggle_icon.png new file mode 100644 index 000000000000..00b09215782e Binary files /dev/null and b/docs/maps/images/timeslider_toggle_icon.png differ diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index cbc00e965e56..157eb0f04466 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -68,7 +68,7 @@ Customize each layer to highlight meaningful dimensions in your data. For exampl [float] === Focus on only the data that’s important to you -Search across the layers in your map to focus in on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. Draw a polygon on the map or use the shape from features to create spatial filters. Filter individual layers to compares facets. +Search across the layers in your map to focus on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. Draw a polygon on the map or use the shape from features to create spatial filters. Filter individual layers to compares facets. -- diff --git a/docs/maps/search.asciidoc b/docs/maps/search.asciidoc index ada7551f3e57..af6939eb8ae1 100644 --- a/docs/maps/search.asciidoc +++ b/docs/maps/search.asciidoc @@ -2,35 +2,72 @@ [[maps-search]] == Search geographic data -Search across the layers in your map to focus in on just the data you want. +Search across the layers in your map to focus on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. -Layers that request data from {es} are narrowed when you submit a <>. -Layers narrowed by semi-structured search and filters contain the filter icon image:maps/images/filter_icon.png[] next to the layer name in the legend. - -Layers that request data from {es} using an <> with a configured time field are narrowed by the <>. -These layers contain the clock icon image:maps/images/clock_icon.png[clock icon] next to the layer name in the legend. Use the time slider to quickly select time slices within the global time filter range. -Click previous and next buttons to advance the time slice backward or forward. Click play to animate your spatial temporal data. - -You can create a layer that requests data from {es} from the following: - -* <> with: - -** Documents - -** Clusters and grid - -** Point to point - -** <> - -** Top hits per entity - -** Tracks - -* <> +This image shows an example of global search and global time narrowing results. [role="screenshot"] -image::maps/images/global_search_bar.png[] +image::maps/images/global_search_bar.png[global search and global time narrowing results] + +Only layers requesting data from {es} are narrowed by global search and global time. +To add a layer that requests data from {es} to your map, click *Add layer*, then select one of the following: + +* Documents + +* Choropleth + +* Clusters and grid + +* Heat map + +* Point to point + +* Top hits per entity + +* Tracks + +[float] +[[maps-narrow-layer-by-global-search]] +==== Narrow layers by global search + +Layers that request data from {es} are narrowed when you submit a <>. +Layers narrowed by semi-structured search and filters contain the filter icon image:maps/images/filter_icon.png[] next to the layer name in the legend. + +To prevent the global search from applying to a layer, configure the following: + +* In *Filtering*, clear the *Apply global search to layer data* checkbox to turn off global search for the layer source. + +* In *Term joins*, clear the *Apply global search to join* checkbox to turn off global search for the <>. + +[float] +[[maps-narrow-layer-by-global-time]] +==== Narrow layers by global time + +Layers that request data from {es} using an <> with a configured time field are narrowed by the <>. +These layers contain the clock icon image:maps/images/clock_icon.png[clock icon] next to the layer name in the legend. + +Use the time slider to quickly select time slices within the global time range: + +. Click image:maps/images/timeslider_toggle_icon.png[timeslider icon] to open the time slider. +. Click previous and next buttons to advance the time slice backward or forward. +. Click play to animate your spatial temporal data. + +To prevent the global time filter from applying to a layer, configure the following: + +* In *Filtering*, clear the *Apply global time to layer data* checkbox to turn off the global time for the layer source. + +* In *Term joins*, clear the *Apply global time to join* checkbox to turn off the global time for the <>. + +[float] +[[maps-refresh-layer]] +==== Refresh layer data + +Layers that request data from {es} re-fetch data when <> fires and when you click *Refresh*. + +To prevent refreshing layer data, configure the following: + +* In *Filtering*, clear the *Apply global refresh to layer data* checkbox to turn off refresh for the layer source. + [role="xpack"] [[maps-create-filter-from-map]] @@ -114,13 +151,9 @@ The most common cause for empty layers are searches for a field that exists in o [float] [[maps-disable-search-for-layer]] -==== Disable search for a layer +==== Disable global search for a layer -You can prevent the search bar from applying search context to a layer by configuring the following: - -* In *Filtering*, clear the *Apply global filter to layer data* checkbox to turn off the global search context for the layer source. - -* In *Term joins*, clear the *Apply global filter to join* checkbox to turn off the global search context for the <>. +One strategy for eliminating unintentional empty layers from a cross index search is to <>. [float] [[maps-add-index-search]]