2019-04-16 01:00:28 +02:00
[role="xpack"]
[[maps-connect-to-ems]]
2020-06-17 16:31:37 +02:00
== Connect to Elastic Maps Service
2019-04-16 01:00:28 +02:00
https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a service that hosts
tile layers and vector shapes of administrative boundaries.
2020-06-17 16:31:37 +02:00
If you are using Kibana's out-of-the-box settings, Maps is already configured to use EMS.
2019-04-16 01:00:28 +02:00
2019-09-16 16:58:03 +02:00
EMS requests are made to the following domains:
* tiles.maps.elastic.co
* vector.maps.elastic.co
2020-06-17 16:31:37 +02:00
Maps makes requests directly from the browser to EMS.
2019-12-06 22:34:34 +01:00
[float]
=== Connect to Elastic Maps Service from an internal network
To connect to EMS when your Kibana server and browser are in an internal network:
. Set `map.proxyElasticMapsServiceInMaps` to `true` in your <<settings, kibana.yml>> file to proxy EMS requests through the Kibana server.
2020-03-09 16:29:25 +01:00
. Update your firewall rules to whitelist connections from your Kibana server to the EMS domains.
2019-12-06 22:34:34 +01:00
NOTE: Coordinate map and region map visualizations do not support `map.proxyElasticMapsServiceInMaps` and will not proxy EMS requests through the Kibana server.
2019-04-16 01:00:28 +02:00
[float]
2019-12-06 22:34:34 +01:00
=== Disable Elastic Maps Service
2019-04-16 01:00:28 +02:00
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.
2020-06-17 16:31:37 +02:00
. Set `map.tilemap.url` to the URL of your tile server. This configures the default tile layer of Maps.
2019-04-16 01:00:28 +02:00
. (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use.