[Maps] connecting to EMS docs (#34737)

* [Maps] connecting to EMS docs

* remove un-related test file

* worked with gchaps to make much better

* simplify disable intro

* feedback

* add optional flag back to step
This commit is contained in:
Nathan Reese 2019-04-15 17:00:28 -06:00 committed by GitHub
parent a70a2cdc00
commit bc4ad271f1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 29 additions and 1 deletions

View file

@ -0,0 +1,27 @@
[role="xpack"]
[[maps-connect-to-ems]]
== Connecting to Elastic Maps Service
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.
Requests to EMS are made with two methods:
* Requests for tile layer meta data, vector shapes meta data, and vector shapes are proxied through the Kibana server.
* Requests for EMS tiles are made directly from the browser to EMS.
NOTE: The legacy tilemap and regionmap visualizations make requests directly from the browser to EMS.
[float]
=== Disabling Elastic Maps Service
You might experience EMS connection issues if your Kibana server or browser are on a private network or
behind a firewall. If this happens, you can disable the EMS connection to avoid unnecessary EMS requests.
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.
. (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use.

View file

@ -19,3 +19,4 @@ include::heatmap-layer.asciidoc[]
include::tile-layer.asciidoc[]
include::vector-layer.asciidoc[]
include::search.asciidoc[]
include::connect-to-ems.asciidoc[]

View file

@ -9,7 +9,7 @@ You can augment vector features with property values that symbolize features and
image::maps/images/terms_join.png[]
Follow the example below to understand how *Terms joins* work.
This example uses Elastic Maps Service(EMS) World Countries as the vector source and
This example uses https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] World Countries as the vector source and
the Kibana sample data set "Sample web logs" as the Elasticsearch index.
Example feature from World Countries: