[skip-ci][Maps][File upload] Geojson indexing and styling docs

[kindsun]

[skip ci]

This PR adds a new section to the maps docs Indexing & Styling GeoJSON Data. It covers:

• How to upload & index GeoJSON files
• How to generate a heat map from the newly indexed data
• How to style layers
• How to organize layers for better presentation

[elasticmachine]

Pinging @elastic/kibana-docs

[elasticmachine]

Pinging @elastic/kibana-gis

[thomasneirynck]

👍

This is a blog post more than it is reference documentation for the UX. It overlaps significantly with the getting-started doc we already have, and it contains a lot of duplicate information (e.g. setting the layer-names for all the layers. That works for a tutorial, less so for technical reference).

Maybe we can call this page Integrated example or something along those lines. @gchaps are there other examples in Kibana where the docs show a fully worked-out example of using an app end2end? I think Timelion might have.

The "import geojson" functionality needs its own page imho, stripped from the rest of this post. That can be short, but reference docs benefit of being short and to the point. It can then link to this page for users who want more a "tutorial" style of reading through the docs.

[gchaps]

I agree with @thomasneirynck

• I'd like see some information on what the geojson functionaliy is, why its important, and what value it brings to the user. Also, the basic process for uploading a geojson file.

• The example is good, and we should use it, whether as a blog or in the docs. I especially like the last page, which is optional, but shows ways to improve the map. I'd recommend paring it down where it covers basic stuff like creating and saving a map and styling the layers, which is covered in the GS. Also, are all layers necessary?

• Timelion does have an example. You can see it here.

• The doc currently doesn't build now. You'll need to remove the anchor above "Creating a new Map". When you're ready to make it visible in the TOC, you'll need to include the file in the maps/index.asciidoc file.

Happy to help with this or doing an edit.

[kindsun]

@gchaps Thanks for the feedback! I've made the following updates:

• Split GeoJSON upload out into its own separate doc with justification for why we use it and how this feature is useful
• Reduced wording and generally make more succinct
• Linked out to relevant docs where needed
• Removed details like "Setting layer names"
• Added wording indicating it's not necessary to use all files for download. It just tells a better story if they do
• Removed breaking anchor above "Creating a new map"
• Added new files to maps/index.asciidoc file
• Removed unused images after streamlining

I left the final section mostly intact because it covers some detail on adding heatmaps that we just don't dive into in our other docs. Happy to revisit this though!

[gchaps]

@aaronjcaldwell Two things to fix to get the docs to build

• Add the image fu_gs_select_source_file_upload.png
• In geojson_upload.asciidoc, line 58, change geojson-upload-integrated-example tp indexing-geojson-data-example. It should look like this:
  <<indexing-geojson-data-example, integrated example>>

[gchaps]

Two minor comments. Otherwise LGTM.