kibana/docs/maps/geojson-upload.asciidoc
Nathan Reese f4efe1b70b
[Maps] layer work flow usability (#154102)
All this dashboard usability work as sparked some ideas to make better
work flows in Maps

### Adding layer
Enhance "Add layer" work flow by allowing users to exit wizard after
layer is added instead of forcing users to continue wizard even if they
do not have any additional configuration changes to make.

Old
<img width="300" alt="Screen Shot 2023-03-30 at 2 56 56 PM"
src="https://user-images.githubusercontent.com/373691/228962788-397e77fe-81b5-438a-a45c-3210101be336.png">


New
<img width="300" alt="Screen Shot 2023-03-30 at 2 22 44 PM"
src="https://user-images.githubusercontent.com/373691/228962403-ed18f8dc-c518-473d-8dd1-f889f7e51684.png">

### Editing layer
"Save" language in layer editor is poor choice since layer changes are
not persisted until user clicks "Save" button in top chrome to save
entire map. Updated copy to better reflect action.

Old
<img width="300" alt="Screen Shot 2023-03-30 at 2 57 16 PM"
src="https://user-images.githubusercontent.com/373691/228962822-d923978f-71c4-4c7f-96f9-b003ededfbbe.png">


New
<img width="300" alt="Screen Shot 2023-03-30 at 2 49 57 PM"
src="https://user-images.githubusercontent.com/373691/228962420-4bd9d554-97ae-4c37-b677-84cd762e3f39.png">

### Other changes
"Map settings" => "Settings"

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-04-04 11:48:21 -06:00

44 lines
1.9 KiB
Text

[role="xpack"]
[[geojson-upload]]
== Upload GeoJSON data
Maps makes it easy to import geospatial data into the Elastic Stack.
Using the GeoJSON Upload feature, you can drag and drop your point and shape
data files directly into {es}, and then use them as layers
in the map. You can also use the GeoJSON data in the broader Kibana ecosystem,
for example, in visualizations and Canvas workpads.
[float]
=== Why GeoJSON?
GeoJSON is an open-standard file format for storing geospatial vector data.
Although many vector data formats are available in the GIS community,
GeoJSON is the most commonly used and flexible option.
[float]
=== Upload a GeoJSON file
Follow these instructions to upload a GeoJSON data file, or try the
<<indexing-geojson-data-tutorial, end-to-end integrated example>>.
. Open the main menu, click *Maps*, and then click *Add layer*.
. Click *Uploaded GeoJSON*.
+
[role="screenshot"]
image::maps/images/fu_gs_select_source_file_upload.png[]
. Use the file chooser to select a valid GeoJSON file. The file will load
a preview of the data on the map.
. Use the default *Index type* of {ref}/geo-point.html[geo_point] for point data,
or override it and select {ref}/geo-shape.html[geo_shape].
All other shapes will default to a type of `geo_shape`.
. Leave the default *Index name* and *Data view* names (the name of the uploaded
file minus its extension). You might need to change the index name if it is invalid.
. Click *Import file*.
+
Upon completing the indexing process and creating the associated data view,
the Elasticsearch responses are shown on the *Layer add panel* and the indexed data
appears on the map. The geospatial data on the map
should be identical to the locally-previewed data, but now it's indexed data from Elasticsearch.
. To continue adding data to the map, click *Add and continue*.
. In *Layer settings*, adjust any settings or <<maps-vector-style-properties, properties>> as needed.
. Click *Keep changes*.