[skip ci][maps] troubleshooting documentation (#40539) (#40928)

* trouble shooting docs

* more details

* gchaps feedback

docs/maps/index.asciidoc

@@ -13,9 +13,10 @@ image::maps/images/sample_data_ecommerce.png[]
 --
 
 include::maps-getting-started.asciidoc[]
-include::maps-aggregations.asciidoc[]
 include::heatmap-layer.asciidoc[]
 include::tile-layer.asciidoc[]
 include::vector-layer.asciidoc[]
+include::maps-aggregations.asciidoc[]
 include::search.asciidoc[]
 include::connect-to-ems.asciidoc[]
+include::trouble-shooting.asciidoc[]

docs/maps/trouble-shooting.asciidoc

@@ -0,0 +1,33 @@
+[role="xpack"]
+[[maps-troubleshooting]]
+== Maps troubleshooting
+
+Use the information in this section to inspect Elasticsearch requests and find solutions to common problems.
+
+[float]
+=== Inspect Elasticsearch requests
+
+The Maps application uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown.
+
+[role="screenshot"]
+image::maps/images/inspector.png[]
+
+[float]
+=== Solutions to common problems
+
+[float]
+==== Features are not displayed
+
+* Use Inspector to view {es} responses. Ensure the response is not empty.
+* Ensure geometry uses the correct latitude and longitude ordering.
+  ** Geo-points expressed as strings are ordered as `"latitude,longitude"`. Geo-points expressed as arrays are ordered as the reverse: `[longitude, latitude]`.
+  ** Geo-shapes expressed as geojson provide coordinates as `[longitude, latitude]`.
+* Ensure fill color and border color are distinguishable from map tiles. It's hard to see white features on a white background.
+
+[float]
+==== Tiles are not displayed
+
+* Ensure your tile server has configured https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS[Cross-Origin Resource Sharing (CORS)] so tile requests from your Kibana domain have permission to access your tile server domain.
+* Ensure tiles have the required coordinate system. Vector data must use EPSG:4326 and tiles must use EPSG:3857.
+
+