Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Removed Coordinate and Region Maps #59828

Merged
merged 5 commits into from
Mar 11, 2020
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/redirects.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,4 @@ This page has moved. Please see <<get-data-in>>.
[role="exclude",id="tilemap"]
== Coordinate map

This page has moved. Please see <<coordinate-map>>.
This page has moved. Please see <<maps>>.
6 changes: 2 additions & 4 deletions docs/setup/settings.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -220,15 +220,13 @@ requests. Supported on Elastic Cloud Enterprise.
`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 <<maps, Maps application>>,
<<tilemap, Coordinate map visualizations>>, and <<visualize-maps, Region map visualizations>>.
and the tile layer configured by `map.tilemap.url` will be available in <<maps, Maps>>.

`map.proxyElasticMapsServiceInMaps:`:: *Default: false*
Set to true to proxy all <<maps, Maps application>> Elastic Maps Service requests through the Kibana server.
This setting does not impact <<tilemap, Coordinate map visualizations>> and <<visualize-maps, Region map visualizations>>.

[[regionmap-settings]] `map.regionmap:`:: Specifies additional vector layers for
use in <<visualize-maps, Region Map>> visualizations. Supported on {ece}. Each layer
use in <<maps, Maps>> 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 (ESPG:4326)]
Expand Down
6 changes: 1 addition & 5 deletions docs/user/visualize.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -45,11 +45,7 @@ data sets.
[horizontal]
<<maps,Elastic Maps>>:: The most powerful way of visualizing map data in {kib}.

<<visualize-maps,Coordinate map>>:: Displays points on a map using a geohash aggregation.

<<visualize-maps,Region map>>:: Merge any structured map data onto a shape.

<<visualize-maps,Heat map>>:: Display shaded cells within a matrix.
<<heat-map,Heat map>>:: Display shaded cells within a matrix.

* *<<for-dashboard,Dashboard tools>>*
[horizontal]
Expand Down
112 changes: 6 additions & 106 deletions docs/visualize/tilemap.asciidoc
Original file line number Diff line number Diff line change
@@ -1,116 +1,16 @@
[[visualize-maps]]
== Maps

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* &mdash; Display latitude and longitude coordinates that are associated to the specified bucket aggregation.

* *Region* &mdash; Display colored boundary vector shapes using a gradient. Darker colors indicate larger values, and lighter colors indicate smaller values.

* *Heat* &mdash; Display graphical representations of data where the individual values are represented by colors.

NOTE: The maps in Visualize have been replaced with <<maps>>, 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.

[role="screenshot"]
image::images/visualize_coordinate_map_example.png[]

[float]
[[build-coordinate-map]]
==== Build a coordinate map

Configure the `kibana.yml` settings and add the aggregations.

. Configure the following `kibana.yml` settings:

* 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 <<tilemap-settings,tilemap settings>>.

. To display your data on the coordinate map, use the following aggregations:

* <<visualize-metric-aggregations,Metric>>

* <<visualize-bucket-aggregations,Geohash bucket aggregation>>

. Specify the geohash bucket aggregation options:

* *Precision* slider &mdash; 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])* &mdash; 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

Configure the `kibana.yml` settings and add the aggregations.

. In `kibana.yml`, set `xpack.maps.showMapVisualizationTypes` to `true`.

. To display your data on the region map, use the following aggregations:

* <<visualize-metric-aggregations,Metric>>
* <<visualize-sibling-pipeline-aggregations,Sibling pipeline>>
* <<visualize-bucket-aggregations,Terms bucket aggregation>>

[float]
[[navigate-region-map]]
==== Navigate the region map

To navigate the region map, use the navigation options.

* To change the zoom level, click *Zoom In* or *Zoom out* image:images/viz-zoom.png[].

* To automatically crop the map boundaries, click *Fit Data Bounds* image:images/viz-fit-bounds.png[].

[float]
[[heat-map]]
=== Heat map
== Heat map

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.
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_heat_map_example.png[]

NOTE: The maps in Visualize have been replaced with <<maps>>, which offers more functionality.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

[float]
[[build-heat-map]]
==== Build a heat map
=== Build a heat map

To display your data on the heat map, use the supported aggregations.

Expand All @@ -123,7 +23,7 @@ Heat maps support the following aggregations:

[float]
[[navigate-heatmap]]
==== Change the color ranges
=== Change the color ranges

When only one color displays on the heat map, you might need to change the color ranges.

Expand Down