DOCSP-4343: [Charts] Customization options (#144)

* DOCSP-4343: [Charts] Customization options

Author: steveren

source/chart-type-reference/geo-spatial.txt

@@ -1,5 +1,7 @@
 :noprevnext:
 
+.. _geo-spatial-charts:
+
 =================
 Geospatial Charts
 =================
@@ -12,12 +14,80 @@ Geospatial Charts
    :depth: 1
    :class: singlecol
 
-Placeholder description for the Geospatial chart type.
+Placeholder description for the geospatial chart type.
+
+Customization
+-------------
+
+To access the available customizations for any chart, click the
+:guilabel:`Customization` tab above the :ref:`encoding channels
+<encoding-channels>` in the :doc:`Chart Builder </build-charts>`.
+
+.. figure:: /images/charts/geospatial-customization-tab.png
+   :figwidth: 242px
+   :alt: Geospatial customization tab
+
+Custom Color Palette
+~~~~~~~~~~~~~~~~~~~~
+
+The color palette specifies the range of colors that corresponds to
+relative aggregated values in your map. 
+
+:ref:`Geospatial Scatter <scatter-ref>` charts use a discrete color
+picker, and :ref:`Geospatial Heatmap <geospatial-heatmap-type>` and
+:ref:`Choropleth <choropleth-ref>` charts use a gradient color picker,
+but the mechanism to enable customization is the same. To enable
+palette customization, toggle the :guilabel:`Custom Color Palette`
+switch in the :guilabel:`General Customization` section.
+
+For more information, see :ref:`Color Palette Customization
+<color-palette-customization>`.
+
+Automatically Set Viewport
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, geospatial charts show a map which includes all the data
+point markers in your specified collection. You can pan and zoom to
+change the map view, but if you close the chart and re-open it the map
+reverts to its default state. This behavior is controlled by the
+:guilabel:`Automatically Set Viewport` option.
+
+When you toggle the :guilabel:`Automatically Set Viewport` switch to
+``Off``, the area and zoom level at which the map is saved becomes the
+new default view.
+
+.. note::
+
+   You can pan and zoom the map area in a chart on a dashboard, but
+   these changes do not affect the default map view.
+
+Opacity
+~~~~~~~
+
+The :guilabel:`Opacity` level of a map modifies the degree to which
+the chart's map data shows through the data point markers. This
+setting is available on all geospatial charts.
+
+On :ref:`Geospatial Heatmap <geospatial-heatmap-type>` and
+:ref:`Choropleth <choropleth-ref>` charts, the :guilabel:`Opacity`
+level defaults to 100%. On :ref:`Geospatial Scatter <scatter-ref>`
+charts, it defaults to 20%.
+
+Radius
+~~~~~~
+
+.. include:: /includes/radius-description.rst
+
+Stroke Thickness
+~~~~~~~~~~~~~~~~
+
+:ref:`Scatter <scatter-ref>` charts provide the customization option
+to set the :guilabel:`Stroke Thickness`, measured in pixels, of the 
+map's data point markers. This setting defaults to ``2``.
 
 .. class:: hidden
 
    .. toctree::
       :titlesonly:
 
       /chart-type-reference/geospatial-heatmap
-

source/chart-type-reference/geospatial-heatmap.txt

@@ -1,3 +1,5 @@
+.. _geospatial-heatmap-type:
+
 ==================
 Geospatial Heatmap
 ==================
@@ -49,11 +51,7 @@ Intensity
 
 .. include:: /includes/intensity-definition.rst
 
-In geospatial heatmaps, values are aggregated within the radius
-specified in the :doc:`customization </customize-charts>` tab.
-Radius is measured in pixels, and defaults to ``30``. For example:
-if ten data points exist within the specified radius, the color
-displayed is based on the aggregated value of those ten data points.
+.. include:: /includes/radius-description.rst
 
 .. note::
 

source/images/charts/geospatial-customization-tab.png

@@ -18,3 +18,7 @@ for each chart type in MongoDB Charts:
   - :ref:`Data Table <data-table-ref>`
 
   - :ref:`Number Chart <number-chart-ref>`
+
+- :ref:`Geospatial Charts <geo-spatial-charts>`
+
+  - :ref:`Heatmap <geospatial-heatmap-type>`

source/includes/chart-type-ref-list.rst

@@ -0,0 +1,10 @@
+The radius customization option dictates the size of the data markers
+in :ref:`Geospatial Heatmaps <geospatial-heatmap-type>`. The color of
+each data marker reflects the aggregated value of all data points
+within that marker's radius. Radius is measured in pixels, and defaults
+to ``30``.
+
+.. example::
+
+   If ten data points exist within the specified radius, the color
+   displayed is based on the aggregated value of those ten data points.