Skip to content

Commit

Permalink
Region map settings clarifications (#14893)
Browse files Browse the repository at this point in the history
Improve documentation.

This also includes some additions to clarify the new includeElasticMapsService setting.
  • Loading branch information
markwalkom authored and thomasneirynck committed Dec 5, 2017
1 parent e169dd3 commit b6ee7a1
Showing 1 changed file with 11 additions and 5 deletions.
16 changes: 11 additions & 5 deletions docs/setup/settings.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -81,13 +81,10 @@ The minimum value is 100.
Each layer object points to an external vector file that contains a geojson FeatureCollection.
The file must use the [WGS84 coordinate reference system](https://en.wikipedia.org/wiki/World_Geodetic_System) and only include polygons.
If the file is hosted on a separate domain from Kibana, the server needs to be CORS-enabled so Kibana can download the file.
The url field also serves as a unique identifier for the file.
Each layer can contain multiple fields to indicate what properties from the geojson features you want to expose.
The field.description is the human readable text that is shown in the Region Map visualization's field menu.
An optional attribution value can be added as well.
The following example shows a valid regionmap configuration.

regionmap:
includeElasticMapsService: false
layers:
- name: "Departments of France"
url: "http://my.cors.enabled.server.org/france_departements.geojson"
Expand All @@ -98,9 +95,18 @@ The following example shows a valid regionmap configuration.
- name: "INSEE"
description: "INSEE numeric identifier"

`name:`:: Mandatory. A description of the map being provided.
`url:`:: Mandatory. The location of the geojson file as provided by a webserver.
`attribution:`:: Optional. References the originating source of the geojson file.
`fields:`:: Mandatory. Each layer can contain multiple fields to indicate what properties from the geojson features you wish to expose. The example above shows how to define multiple properties.
`fields.name:`:: Mandatory. This value is used to do an inner-join between the document stored in Elasticsearch and the geojson file. e.g. if the field in the geojson is called `Location` and has city names, there must be a field in Elasticsearch that holds the same values that Kibana can then use to lookup for the geoshape data.
`fields.description:`:: Mandatory. The human readable text that is shown under the Options tab when building the Region Map visualization.


`regionmap.includeElasticMapsService`:: turns on or off whether layers from the Elastic Maps Service should be included in the vector layer option list.
By turning this off, only the layers that are configured here will be included.
By turning this off, only the layers that are configured here will be included. The default is true.

<<<<<<< HEAD
`server.basePath:`:: Enables you to specify a path to mount Kibana at if you are running behind a proxy. This only affects
the URLs generated by Kibana, your proxy is expected to remove the basePath value before forwarding requests
to Kibana. This setting cannot end in a slash (`/`).
Expand Down

0 comments on commit b6ee7a1

Please sign in to comment.