IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Connect to Elastic Maps Service Tutorial: Index GeoJSON data »
Elastic Docs ›Kibana Guide [7.13] ›Maps

Import geospatial data

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Import geospatial data

edit

To import geospatical data into the Elastic Stack, the data must be indexed as geo_point or geo_shape. Geospatial data comes in many formats. Choose an import tool based on the format of your geospatial data.

Security privileges

edit

The Elastic Stack security features provide roles and privileges that control which users can upload files. You can manage your roles, privileges, and spaces in Stack Management in Kibana. For more information, see Security privileges, Kibana privileges, and Kibana role management.

To upload GeoJSON files in Kibana with Maps, you must have:

  • The all Kibana privilege for Maps.
  • The all Kibana privilege for Index Pattern Management.
  • The create and create_index index privileges for destination indices.
  • To use the index in Maps, you must also have the read and view_index_metadata index privileges for destination indices.

To upload CSV files in Kibana with the File Data Visualizer, you must have privileges to upload GeoJSON files and:

  • The manage_pipeline cluster privilege.
  • The read Kibana privilege for Machine Learning.
  • The machine_learning_admin or machine_learning_user role.

Upload CSV with latitude and longitude columns

edit

File Data Visualizer indexes CSV files with latitude and longitude columns as a geo_point.

  1. Open the main menu, then click Machine Learning.
  2. Select the Data Visualizer tab, then click Upload file.
  3. Use the file chooser to select a CSV file.
  4. Click Import.
  5. Select the Advanced tab.
  6. Set Index name.
  7. Click Add combined field, then click Add geo point field.
  8. Fill out the form and click Add.
  9. Click Import.

Upload a GeoJSON file

edit

Upload GeoJSON indexes GeoJSON features as a geo_point or geo_shape.

  1. Create a new map.
  2. Click Add layer.
  3. Select Upload GeoJSON.
  4. Use the file chooser to select a GeoJSON file.
  5. Click Import file.

Upload data with IP addresses

edit

The GeoIP processor adds information about the geographical location of IP addresses. See GeoIP processor for details. For private IP addresses, see Enriching data with GeoIPs from internal, private IP addresses.

Upload data with GDAL

edit

GDAL (Geospatial Data Abstraction Library) contains command line tools that can convert geospatial data between 75 different geospatial file formats and index that geospatial data into Elasticsearch. See Ingest geospatial data into Elasticsearch with GDAL for details.

« Connect to Elastic Maps Service Tutorial: Index GeoJSON data »