Skip to content

Commit

Permalink
[skip-ci][Maps] Improve Maps intro page (elastic#44721)
Browse files Browse the repository at this point in the history
* [skip-ci][Maps] Improve Maps intro page

* review feedback

* trim list to 7 items, add link to getting started guide, change all references to app to Elastic Maps

* review feedback

* bold Elastic Maps in intro page
  • Loading branch information
nreese committed Sep 6, 2019
1 parent a9b16ba commit 8f331b3
Show file tree
Hide file tree
Showing 5 changed files with 25 additions and 13 deletions.
6 changes: 3 additions & 3 deletions docs/maps/connect-to-ems.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a service that hosts
tile layers and vector shapes of administrative boundaries.
If you are using Kibana's out-of-the-box settings, the **Maps** application is already configured to use EMS.
If you are using Kibana's out-of-the-box settings, **Elastic Maps** is already configured to use EMS.

The **Maps** application makes requests directly from the browser to EMS.
**Elastic Maps** makes requests directly from the browser to EMS.
To proxy EMS requests through the Kibana server, set `map.proxyElasticMapsServiceInMaps` to `true` in your <<settings, kibana.yml>> file.


Expand All @@ -19,5 +19,5 @@ behind a firewall. If this happens, you can disable the EMS connection to avoid
To disable EMS, change your <<settings, kibana.yml>> file.

. Set `map.includeElasticMapsService` to `false` to turn off the EMS connection.
. Set `map.tilemap.url` to the URL of your tile server. This configures the **Maps** default tile layer.
. Set `map.tilemap.url` to the URL of your tile server. This configures the default tile layer of **Elastic Maps**.
. (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use.
16 changes: 14 additions & 2 deletions docs/maps/index.asciidoc
Original file line number Diff line number Diff line change
@@ -1,11 +1,23 @@
[role="xpack"]
[[maps]]
= Maps
= Elastic Maps

[partintro]
--

The **Maps** application enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease.
*Elastic Maps* enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease.

With *Elastic Maps*, you can:

* Create maps with multiple layers and indices.
* Upload GeoJSON files into Elasticsearch.
* Embed your map in Dashboards.
* Plot individual documents or use aggregations to plot any data set, no matter how large.
* Create choropleth maps.
* Use data driven styling to symbolize features from property values.
* Focus the data you want to display with searches.

Start your tour of *Elastic Maps* with the <<maps-getting-started, getting started tutorial>>.

[role="screenshot"]
image::maps/images/sample_data_ecommerce.png[]
Expand Down
10 changes: 5 additions & 5 deletions docs/maps/maps-getting-started.asciidoc
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
[role="xpack"]
[[maps-getting-started]]
== Getting started with Maps
== Getting started with Elastic Maps

You work with *Maps* by adding layers. The data for a layer can come from
You work with *Elastic Maps* by adding layers. The data for a layer can come from
sources such as {es} documents, vector sources, tile map services, web map
services, and more. You can symbolize the data in different ways.
For example, you might show which airports have the longest flight
Expand All @@ -14,7 +14,7 @@ light to dark.
image::maps/images/sample_data_web_logs.png[]

[[maps-read-only-access]]
NOTE: If you have insufficient privileges to create or save maps, a read-only icon
NOTE: If you have insufficient privileges to create or save maps, a read-only icon
appears in the application header. The buttons to create new maps or edit
existing maps won't be visible. For more information on granting access to
Kibana see <<xpack-security-authorization>>.
Expand All @@ -25,7 +25,7 @@ image::maps/images/read-only-badge.png[Example of Maps' read only access indicat
[float]
=== Prerequisites
Before you start this tutorial, <<add-sample-data, add the web logs sample data set>>. Each
sample data set includes a map to go along with the data. Once you've added the data, open *Maps* and
sample data set includes a map to go along with the data. Once you've added the data, open *Elastic Maps* and
explore the different layers of the *[Logs] Total Requests and Bytes* map.
You'll re-create this map in this tutorial.

Expand All @@ -44,7 +44,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 *Maps*.
. If you haven't already, open *Elastic Maps*.
. On the maps list page, click *Create map*.
. Set the time range to *Last 7 days*.
+
Expand Down
2 changes: 1 addition & 1 deletion docs/maps/search.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
[[maps-search]]
== Searching your data

The **Maps** application embeds the query bar for real-time ad hoc search.
**Elastic Maps** embeds the query bar for real-time ad hoc search.
Only layers requesting data from {es} are filtered when you submit a search request.

You can create a layer that requests data from {es} from the following:
Expand Down
4 changes: 2 additions & 2 deletions docs/maps/trouble-shooting.asciidoc
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
[role="xpack"]
[[maps-troubleshooting]]
== Maps troubleshooting
== Elastic Maps troubleshooting

Use the information in this section to inspect Elasticsearch requests and find solutions to common problems.

[float]
=== Inspect Elasticsearch requests

The Maps application uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown.
*Elastic Maps* uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown.

[role="screenshot"]
image::maps/images/inspector.png[]
Expand Down

0 comments on commit 8f331b3

Please sign in to comment.