[7.x] [DOCS] Removed Coordinate and Region Maps (#59828) (#59909)

* [DOCS] Removed Coordinate and Region Maps (#59828)

* [DOCS] Removed Coordinate and Region Maps

* Review comment

* Added redirect for visualize-maps

* Fixed build errors
This commit is contained in:
Kaarina Tungseth 2020-03-16 13:59:36 -05:00 committed by GitHub
parent 7f908a58f2
commit 64a1e7fc13
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 9 additions and 109 deletions

View file

@ -80,4 +80,9 @@ 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>>.
[role="exclude",id="visualize-maps"]
== Maps
This page has moved. Please see <<maps>>.

View file

@ -227,15 +227,13 @@ requests. Supported on {ece}.
`map.includeElasticMapsService:`:: *Default: true*
To disable connections to Elastic Maps Service, set to `false`.
When `includeElasticMapsService` is turned off, only the vector layers configured by `map.regionmap`,
and the tile layer configured by `map.tilemap.url`, are available in the <<maps,Maps application>>,
<<coordinate-map,Coordinate map visualizations>>, and <<region-map,Region map visualizations>>.
and the tile layer configured by `map.tilemap.url`, are available in the <<maps,Maps application>>.
`map.proxyElasticMapsServiceInMaps:`:: *Default: false*
Set to true to proxy all <<maps,Maps application>> Elastic Maps Service requests through the {kib} server.
This setting does not impact <<coordinate-map,Coordinate map visualizations>> and <<region-map,Region map visualizations>>.
[[regionmap-settings]] `map.regionmap:`:: Specifies additional vector layers for
use in <<region-map,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)]

View file

@ -40,11 +40,7 @@ data sets.
Maps::
* *<<maps,Elastic Maps>>* &mdash; Displays geospatial data in {kib}.
* *<<visualize-maps,Coordinate map>>* &mdash; Displays points on a map using a geohash aggregation.
* *<<visualize-maps,Region map>>* &mdash; Merges any structured map data onto a shape.
* *<<heat-map,Heat map>>* &mdash; Displays shaded cells within a matrix.
* <<heat-map,Heat map>>:: Display shaded cells within a matrix.
<<for-dashboard,Dashboard tools>>::
@ -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[]

View file

@ -1,98 +0,0 @@
[[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.
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[].