highcharts 6.1.1 → 6.2.0

package/modules/tilemap.src.js

@@ -1,5 +1,5 @@
 /**
- * @license  Highcharts JS v6.1.1 (2018-06-27)
+ * @license  Highcharts JS v6.2.0 (2018-10-17)
  * Tilemap module
  *
  * (c) 2010-2017 Highsoft AS
@@ -10,13 +10,17 @@
 (function (factory) {
 	if (typeof module === 'object' && module.exports) {
 		module.exports = factory;
+	} else if (typeof define === 'function' && define.amd) {
+		define(function () {
+			return factory;
+		});
 	} else {
 		factory(Highcharts);
 	}
 }(function (Highcharts) {
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -49,6 +53,8 @@
 		        var point = this,
 		            method = vis ? 'show' : 'hide';
 
+		        point.visible = Boolean(vis);
+
 		        // Show and hide associated elements
 		        each(['graphic', 'dataLabel'], function (key) {
 		            if (point[key]) {
@@ -123,10 +129,13 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
+
+
+
 		var colorPointMixin = H.colorPointMixin,
 		    colorSeriesMixin = H.colorSeriesMixin,
 		    each = H.each,
@@ -138,29 +147,36 @@
 		    seriesType = H.seriesType,
 		    seriesTypes = H.seriesTypes;
 
+		/**
+		 * @private
+		 * @class
+		 * @name Highcharts.seriesTypes.heatmap
+		 *
+		 * @augments Highcharts.Series
+		 */
+		seriesType('heatmap', 'scatter'
 
 		/**
 		 * A heatmap is a graphical representation of data where the individual values
 		 * contained in a matrix are represented as colors.
 		 *
-		 * @sample       highcharts/demo/heatmap/
-		 *               Simple heatmap
-		 * @sample       highcharts/demo/heatmap-canvas/
-		 *               Heavy heatmap
+		 * @sample highcharts/demo/heatmap/
+		 *         Simple heatmap
+		 * @sample highcharts/demo/heatmap-canvas/
+		 *         Heavy heatmap
+		 *
 		 * @extends      {plotOptions.scatter}
-		 * @excluding    animationLimit,connectEnds,connectNulls,dashStyle,
-		 *               findNearestPointBy,getExtremesFromAll,linecap,lineWidth,marker,
-		 *               pointInterval,pointIntervalUnit,pointRange,pointStart,shadow,
-		 *               softThreshold,stacking,step,threshold
+		 * @excluding    animationLimit, connectEnds, connectNulls, dashStyle,
+		 *               findNearestPointBy, getExtremesFromAll, linecap, lineWidth,
+		 *               marker, pointInterval, pointIntervalUnit, pointRange,
+		 *               pointStart, shadow, softThreshold, stacking, step, threshold
 		 * @product      highcharts highmaps
 		 * @optionparent plotOptions.heatmap
 		 */
-		seriesType('heatmap', 'scatter', {
+		, {
 
 		    /**
 		     * Animation is disabled by default on the heatmap series.
-		     *
-		     * @type {Boolean|Object}
 		     */
 		    animation: false,
 
@@ -172,9 +188,9 @@
 		    /**
 		     * Padding between the points in the heatmap.
 		     *
-		     * @type {Number}
-		     * @default 0
-		     * @since 6.0
+		     * @type      {number}
+		     * @default   0
+		     * @since     6.0
 		     * @apioption plotOptions.heatmap.pointPadding
 		     */
 
@@ -184,10 +200,9 @@
 		     * options are set in the [colorAxis](#colorAxis), the default value
 		     * is pulled from the [options.colors](#colors) array.
 		     *
-		     * @type {Color}
-		     * @default null
-		     * @since 4.0
-		     * @product highcharts
+		     * @type      {Highcharts.ColorString}
+		     * @since     4.0
+		     * @product   highcharts
 		     * @apioption plotOptions.heatmap.color
 		     */
 
@@ -195,24 +210,30 @@
 		     * The column size - how many X axis units each column in the heatmap
 		     * should span.
 		     *
-		     * @type {Number}
-		     * @sample {highcharts} maps/demo/heatmap/ One day
-		     * @sample {highmaps} maps/demo/heatmap/ One day
-		     * @default 1
-		     * @since 4.0
-		     * @product highcharts highmaps
+		     * @sample {highcharts} maps/demo/heatmap/
+		     *         One day
+		     * @sample {highmaps} maps/demo/heatmap/
+		     *         One day
+		     *
+		     * @type      {number}
+		     * @default   1
+		     * @since     4.0
+		     * @product   highcharts highmaps
 		     * @apioption plotOptions.heatmap.colsize
 		     */
 
 		    /**
 		     * The row size - how many Y axis units each heatmap row should span.
 		     *
-		     * @type {Number}
-		     * @sample {highcharts} maps/demo/heatmap/ 1 by default
-		     * @sample {highmaps} maps/demo/heatmap/ 1 by default
-		     * @default 1
-		     * @since 4.0
-		     * @product highcharts highmaps
+		     * @sample {highcharts} maps/demo/heatmap/
+		     *         1 by default
+		     * @sample {highmaps} maps/demo/heatmap/
+		     *         1 by default
+		     *
+		     * @type      {number}
+		     * @default   1
+		     * @since     4.0
+		     * @product   highcharts highmaps
 		     * @apioption plotOptions.heatmap.rowsize
 		     */
 
@@ -222,13 +243,13 @@
 		     * The color applied to null points. In styled mode, a general CSS class is
 		     * applied instead.
 		     *
-		     * @type {Color}
+		     * @type {Highcharts.ColorString}
 		     */
 		    nullColor: '#f7f7f7',
+
     
 
 		    dataLabels: {
-
 		        formatter: function () { // #2945
 		            return this.point.value;
 		        },
@@ -244,7 +265,9 @@
 		     */
 		    marker: null,
 
-		    /**    @ignore */
+		    /**
+		     * @ignore
+		     */
 		    pointRange: null, // dynamically set to colsize by default
 
 		    tooltip: {
@@ -254,6 +277,7 @@
 		    states: {
 
 		        hover: {
+
 		            /**
 		             * @ignore
 		             */
@@ -266,14 +290,15 @@
 		             * In styled mode, the hover brightening is by default replaced
 		             * with a fill-opacity set in the `.highcharts-point:hover` rule.
 		             *
-		             * @type {Number}
 		             * @product highcharts highmaps
 		             */
 		            brightness: 0.2
 		        }
+
 		    }
 
 		}, merge(colorSeriesMixin, {
+
 		    pointArrayMap: ['y', 'value'],
 		    hasPointSpecificOptions: true,
 		    getExtremesFromAll: true,
@@ -281,6 +306,9 @@
 
 		    /**
 		     * Override the init method to add point ranges on both axes.
+		     *
+		     * @private
+		     * @function Highcharts.seriesTypes.heatmap#init
 		     */
 		    init: function () {
 		        var options;
@@ -291,6 +319,11 @@
 		        options.pointRange = pick(options.pointRange, options.colsize || 1);
 		        this.yAxis.axisPointRange = options.rowsize || 1; // general point range
 		    },
+
+		    /**
+		     * @private
+		     * @function Highcharts.seriesTypes.heatmap#translate
+		     */
 		    translate: function () {
 		        var series = this,
 		            options = series.options,
@@ -345,6 +378,11 @@
 
 		        series.translateColors();
 		    },
+
+		    /**
+		     * @private
+		     * @function Highcharts.seriesTypes.heatmap#drawPoints
+		     */
 		    drawPoints: function () {
 		        seriesTypes.column.prototype.drawPoints.call(this);
 
@@ -354,10 +392,37 @@
             
 		        }, this);
 		    },
+
+		    /**
+		     * @ignore
+		     * @deprecated
+		     * @function Highcharts.seriesTypes.heatmap#animate
+		     */
 		    animate: noop,
+
+		    /**
+		     * @ignore
+		     * @deprecated
+		     * @function Highcharts.seriesTypes.heatmap#getBox
+		     */
 		    getBox: noop,
+
+		    /**
+		     * @private
+		     * @borrows Highcharts.LegendSymbolMixin.drawRectangle as Highcharts.seriesTypes.heatmap#drawLegendSymbol
+		     */
 		    drawLegendSymbol: LegendSymbolMixin.drawRectangle,
+
+		    /**
+		     * @private
+		     * @borrows Highcharts.seriesTypes.column#alignDataLabel as Highcharts.seriesTypes.heatmap#alignDataLabel
+		     */
 		    alignDataLabel: seriesTypes.column.prototype.alignDataLabel,
+
+		    /**
+		     * @private
+		     * @function Highcharts.seriesTypes.heatmap#getExtremes
+		     */
 		    getExtremes: function () {
 		        // Get the extremes from the value data
 		        Series.prototype.getExtremes.call(this, this.valueData);
@@ -369,6 +434,15 @@
 		    }
 
 		}), H.extend({
+
+		    /**
+		     * @private
+		     * @function Highcharts.Point#haloPath
+		     *
+		     * @param {number} size
+		     *
+		     * @return {Highcharts.SVGPathArray}
+		     */
 		    haloPath: function (size) {
 		        if (!size) {
 		            return [];
@@ -383,14 +457,14 @@
 		        ];
 		    }
 		}, colorPointMixin));
+
 		/**
 		 * A `heatmap` series. If the [type](#series.heatmap.type) option is
 		 * not specified, it is inherited from [chart.type](#chart.type).
 		 *
-		 * @type {Object}
-		 * @extends series,plotOptions.heatmap
-		 * @excluding dataParser,dataURL,marker,pointRange,stack
-		 * @product highcharts highmaps
+		 * @extends   series,plotOptions.heatmap
+		 * @excluding dataParser, dataURL, marker, pointRange, stack
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap
 		 */
 
@@ -414,8 +488,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 2.  An array of objects with named values. The objects are point
-		 * configuration objects as seen below. If the total number of data
+		 * 2.  An array of objects with named values. The following snippet shows only a
+		 * few settings, see the complete options set below. If the total number of data
 		 * points exceeds the series' [turboThreshold](#series.heatmap.turboThreshold),
 		 * this option is not available.
 		 *
@@ -435,9 +509,6 @@
 		 *     }]
 		 *  ```
 		 *
-		 * @type {Array<Object|Array>}
-		 * @extends series.line.data
-		 * @excluding marker
 		 * @sample {highcharts} highcharts/chart/reflow-true/
 		 *         Numerical values
 		 * @sample {highcharts} highcharts/series/data-array-of-arrays/
@@ -448,7 +519,11 @@
 		 *         Arrays of point.name and y
 		 * @sample {highcharts} highcharts/series/data-array-of-objects/
 		 *         Config objects
-		 * @product highcharts highmaps
+		 *
+		 * @type      {Array<Array<number>|*>}
+		 * @extends   series.line.data
+		 * @excluding marker
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap.data
 		 */
 
@@ -457,8 +532,8 @@
 		 * explicitly, as we use the color to denote the `value`. Options for
 		 * this are set in the [colorAxis](#colorAxis) configuration.
 		 *
-		 * @type {Color}
-		 * @product highcharts highmaps
+		 * @type      {Highcharts.ColorString}
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap.data.color
 		 */
 
@@ -466,8 +541,8 @@
 		 * The value of the point, resulting in a color controled by options
 		 * as set in the [colorAxis](#colorAxis) configuration.
 		 *
-		 * @type {Number}
-		 * @product highcharts highmaps
+		 * @type      {number}
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap.data.value
 		 */
 
@@ -475,24 +550,26 @@
 		 * The x value of the point. For datetime axes,
 		 * the X value is the timestamp in milliseconds since 1970.
 		 *
-		 * @type {Number}
-		 * @product highcharts highmaps
+		 * @type      {number}
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap.data.x
 		 */
 
 		/**
 		 * The y value of the point.
 		 *
-		 * @type {Number}
-		 * @product highcharts highmaps
+		 * @type      {number}
+		 * @product   highcharts highmaps
 		 * @apioption series.heatmap.data.y
 		 */
 
 		/**
 		 * Point padding for a single point.
 		 *
-		 * @type {Number}
-		 * @sample maps/plotoptions/tilemap-pointpadding Point padding on tiles
+		 * @sample maps/plotoptions/tilemap-pointpadding
+		 *         Point padding on tiles
+		 *
+		 * @type      {number}
 		 * @apioption series.heatmap.data.pointPadding
 		 */
 
@@ -508,6 +585,8 @@
 		 * License: www.highcharts.com/license
 		 */
 
+
+
 		var seriesType = H.seriesType,
 		    each = H.each,
 		    reduce = H.reduce,
@@ -525,10 +604,22 @@
 		        };
 		    };
 
-		// Map of shape types
+		/**
+		 * Map of shape types.
+		 *
+		 * @private
+		 * @name Highcharts.tileShapeTypes
+		 * @type {*}
+		 */
 		H.tileShapeTypes = {
 
-		    /** Hexagon shape type **/
+		    /**
+		     * Hexagon shape type.
+		     *
+		     * @private
+		     * @name Highcharts.tileShapeTypes.hexagon
+		     * @type {*}
+		     */
 		    hexagon: {
 		        alignDataLabel: H.seriesTypes.scatter.prototype.alignDataLabel,
 		        getSeriesPadding: function (series) {
@@ -660,7 +751,13 @@
 		    },
 
 
-		    /** Diamond shape type **/
+		    /**
+		     * Diamond shape type.
+		     *
+		     * @private
+		     * @name Highcharts.tileShapeTypes.diamond
+		     * @type {*}
+		     */
 		    diamond: {
 		        alignDataLabel: H.seriesTypes.scatter.prototype.alignDataLabel,
 		        getSeriesPadding: function (series) {
@@ -777,7 +874,13 @@
 		    },
 
 
-		    /** Circle shape type **/
+		    /**
+		     * Circle shape type.
+		     *
+		     * @private
+		     * @name Highcharts.tileShapeTypes.circle
+		     * @type {*}
+		     */
 		    circle: {
 		        alignDataLabel: H.seriesTypes.scatter.prototype.alignDataLabel,
 		        getSeriesPadding: function (series) {
@@ -907,7 +1010,13 @@
 		    },
 
 
-		    /** Square shape type **/
+		    /**
+		     * Square shape type.
+		     *
+		     * @private
+		     * @name Highcharts.tileShapeTypes.square
+		     * @type {*}
+		     */
 		    square: {
 		        alignDataLabel: H.seriesTypes.heatmap.prototype.alignDataLabel,
 		        translate: H.seriesTypes.heatmap.prototype.translate,
@@ -953,12 +1062,18 @@
 		    }
 		});
 
+		/**
+		 * @private
+		 * @class
+		 * @name Highcharts.seriesTypes.tilemap
+		 *
+		 * @augments Highcharts.Series
+		 */
+		seriesType('tilemap', 'heatmap'
 
 		/**
 		 * A tilemap series is a type of heatmap where the tile shapes are configurable.
 		 *
-		 * @extends {plotOptions.heatmap}
-		 * @product highcharts highmaps
 		 * @sample highcharts/demo/honeycomb-usa/
 		 *         Honeycomb tilemap, USA
 		 * @sample maps/plotoptions/honeycomb-brazil/
@@ -970,20 +1085,30 @@
 		 * @sample maps/demo/circlemap-africa/
 		 *         Circlemap tilemap, Africa
 		 * @sample maps/demo/diamondmap
-		 *           Diamondmap tilemap
-		 * @since 6.0.0
-		 * @excluding joinBy, shadow, allAreas, mapData, data
+		 *         Diamondmap tilemap
+		 *
+		 * @extends      plotOptions.heatmap
+		 * @since        6.0.0
+		 * @excluding    joinBy, shadow, allAreas, mapData, data
+		 * @product      highcharts highmaps
 		 * @optionparent plotOptions.tilemap
 		 */
-		seriesType('tilemap', 'heatmap', {
-		// Default options
+		, { // Default options
+
 		    states: {
+
 		        hover: {
+
 		            halo: {
+
 		                enabled: true,
+
 		                size: 2,
+
 		                opacity: 0.5,
+
 		                attributes: {
+
 		                    zIndex: 3
 		                }
 		            }
@@ -993,7 +1118,8 @@
 		    /**
 		     * The padding between points in the tilemap.
 		     *
-		     * @sample maps/plotoptions/tilemap-pointpadding Point padding on tiles
+		     * @sample maps/plotoptions/tilemap-pointpadding
+		     *         Point padding on tiles
 		     */
 		    pointPadding: 2,
 
@@ -1001,39 +1127,55 @@
 		     * The column size - how many X axis units each column in the tilemap
 		     * should span. Works as in [Heatmaps](#plotOptions.heatmap.colsize).
 		     *
-		     * @type {Number}
-		     * @sample {highcharts} maps/demo/heatmap/ One day
-		     * @sample {highmaps} maps/demo/heatmap/ One day
-		     * @default 1
-		     * @product highcharts highmaps
+		     * @sample {highcharts} maps/demo/heatmap/
+		     *         One day
+		     * @sample {highmaps} maps/demo/heatmap/
+		     *         One day
+		     *
+		     * @type      {number}
+		     * @default   1
+		     * @product   highcharts highmaps
 		     * @apioption plotOptions.tilemap.colsize
 		     */
 
 		    /**
-		      * The row size - how many Y axis units each tilemap row should span.
+		     * The row size - how many Y axis units each tilemap row should span.
 		     * Analogous to [colsize](#plotOptions.tilemap.colsize).
-		      *
-		      * @type {Number}
-		      * @sample {highcharts} maps/demo/heatmap/ 1 by default
-		      * @sample {highmaps} maps/demo/heatmap/ 1 by default
-		      * @default 1
-		      * @product highcharts highmaps
-		      * @apioption plotOptions.tilemap.rowsize
-		      */
+		     *
+		     * @sample {highcharts} maps/demo/heatmap/
+		     *         1 by default
+		     * @sample {highmaps} maps/demo/heatmap/
+		     *         1 by default
+		     *
+		     * @type      {number}
+		     * @default   1
+		     * @product   highcharts highmaps
+		     * @apioption plotOptions.tilemap.rowsize
+		     */
 
 		    /**
 		     * The shape of the tiles in the tilemap. Possible values are `hexagon`,
 		     * `circle`, `diamond`, and `square`.
 		     *
-		     * @sample maps/demo/circlemap-africa Circular tile shapes
-		     * @sample maps/demo/diamondmap Diamond tile shapes
+		     * @sample maps/demo/circlemap-africa
+		     *         Circular tile shapes
+		     * @sample maps/demo/diamondmap
+		     *         Diamond tile shapes
+		     *
+		     * @validvalue ["circle", "diamond", "hexagon", "square"]
 		     */
 		    tileShape: 'hexagon'
 
-		// Prototype functions
-		}, {
+		}, { // Prototype functions
 
-		    // Set tile shape object on series
+		    /**
+		     * Set tile shape object on series
+		     *
+		     * @private
+		     * @function Highcharts.seriesTypes.tilemap#setOptions
+		     *
+		     * @return {*}
+		     */
 		    setOptions: function () {
 		        // Call original function
 		        var ret = H.seriesTypes.heatmap.prototype.setOptions.apply(this,
@@ -1044,14 +1186,30 @@
 		        return ret;
 		    },
 
-		    // Use the shape's defined data label alignment function
+		    /**
+		     * Use the shape's defined data label alignment function
+		     *
+		     * @private
+		     * @function Highcharts.seriesTypes.tilemap#alignDataLabel
+		     *
+		     * @return {*}
+		     */
 		    alignDataLabel: function () {
 		        return this.tileShape.alignDataLabel.apply(this,
 		            Array.prototype.slice.call(arguments)
 		        );
 		    },
 
-		    // Get metrics for padding of axis for this series
+		    /**
+		     * Get metrics for padding of axis for this series
+		     *
+		     * @private
+		     * @function Highcharts.seriesTypes.tilemap#getSeriesPixelPadding
+		     *
+		     * @param {Highcharts.Axis} axis
+		     *
+		     * @return {*}
+		     */
 		    getSeriesPixelPadding: function (axis) {
 		        var isX = axis.isXAxis,
 		            padding = this.tileShape.getSeriesPadding(this),
@@ -1096,7 +1254,12 @@
 		        };
 		    },
 
-		    // Use translate from tileShape
+		    /**
+		     * Use translate from tileShape
+		     *
+		     * @private
+		     * @function Highcharts.seriesTypes.tilemap#translate
+		     */
 		    translate: function () {
 		        return this.tileShape.translate.apply(this,
 		            Array.prototype.slice.call(arguments)
@@ -1104,6 +1267,13 @@
 		    }
 
 		}, H.extend({
+
+		    /**
+		     * @private
+		     * @function Highcharts.Point#haloPath
+		     *
+		     * @return {Highcharts.SVGPathArray}
+		     */
 		    haloPath: function () {
 		        return this.series.tileShape.haloPath.apply(this,
 		            Array.prototype.slice.call(arguments)
@@ -1115,110 +1285,114 @@
 		 * A `tilemap` series. If the [type](#series.tilemap.type) option is
 		 * not specified, it is inherited from [chart.type](#chart.type).
 		 *
-		 * @type      {Object}
 		 * @extends   series,plotOptions.tilemap
-		 * @excluding allAreas,dataParser,dataURL,joinBy,mapData,marker,pointRange,
-		 *            shadow,stack
+		 * @excluding allAreas, dataParser, dataURL, joinBy, mapData, marker,
+		 *            pointRange, shadow, stack
 		 * @product   highcharts highmaps
 		 * @apioption series.tilemap
 		 */
 
-		 /**
-		  * An array of data points for the series. For the `tilemap` series
-		  * type, points can be given in the following ways:
-		  *
-		  * 1.  An array of arrays with 3 or 2 values. In this case, the values
-		  * correspond to `x,y,value`. If the first value is a string, it is
-		  * applied as the name of the point, and the `x` value is inferred.
-		  * The `x` value can also be omitted, in which case the inner arrays
-		  * should be of length 2\. Then the `x` value is automatically calculated,
-		  * either starting at 0 and incremented by 1, or from `pointStart`
-		  * and `pointInterval` given in the series options.
-		  *
-		  *  ```js
-		  *     data: [
-		  *         [0, 9, 7],
-		  *         [1, 10, 4],
-		  *         [2, 6, 3]
-		  *     ]
-		  *  ```
-		  *
-		  * 2.  An array of objects with named values. The objects are point
-		  * configuration objects as seen below. If the total number of data
-		  * points exceeds the series' [turboThreshold](#series.tilemap.turboThreshold),
-		  * this option is not available.
-		  *
-		  *  ```js
-		  *     data: [{
-		  *         x: 1,
-		  *         y: 3,
-		  *         value: 10,
-		  *         name: "Point2",
-		  *         color: "#00FF00"
-		  *     }, {
-		  *         x: 1,
-		  *         y: 7,
-		  *         value: 10,
-		  *         name: "Point1",
-		  *         color: "#FF00FF"
-		  *     }]
-		  *  ```
-		  *
-		  * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
-		  * coordinates are offset.
-		  *
-		  * @type {Array<Object|Array>}
-		  * @extends series.heatmap.data
-		  * @excluding marker
-		  * @sample maps/series/tilemap-gridoffset Offset grid coordinates
-		  * @sample {highcharts} highcharts/chart/reflow-true/
-		  *         Numerical values
-		  * @sample {highcharts} highcharts/series/data-array-of-arrays/
-		  *         Arrays of numeric x and y
-		  * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/
-		  *         Arrays of datetime x and y
-		  * @sample {highcharts} highcharts/series/data-array-of-name-value/
-		  *         Arrays of point.name and y
-		  * @sample {highcharts} highcharts/series/data-array-of-objects/
-		  *         Config objects
-		  * @product highcharts highmaps
-		  * @apioption series.tilemap.data
-		  */
-
-		  /**
-		   * The color of the point. In tilemaps the point color is rarely set
-		   * explicitly, as we use the color to denote the `value`. Options for
-		   * this are set in the [colorAxis](#colorAxis) configuration.
-		   *
-		   * @type {Color}
-		   * @product highcharts highmaps
-		   * @apioption plotOptions.tilemap.data.color
-		   */
-
-		  /**
-		   * The x coordinate of the point.
-		   *
-		   * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
-		   * coordinates are offset.
-		   *
-		   * @type {Number}
-		   * @product highcharts highmaps
-		   * @sample maps/series/tilemap-gridoffset Offset grid coordinates
-		   * @apioption plotOptions.tilemap.data.x
-		   */
-
-		  /**
-		   * The y coordinate of the point.
-		   *
-		   * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
-		   * coordinates are offset.
-		   *
-		   * @type {Number}
-		   * @default undefined
-		   * @product highcharts highmaps
-		   * @sample maps/series/tilemap-gridoffset Offset grid coordinates
-		   * @apioption plotOptions.tilemap.data.y
-		   */
+		/**
+		 * An array of data points for the series. For the `tilemap` series
+		 * type, points can be given in the following ways:
+		 *
+		 * 1.  An array of arrays with 3 or 2 values. In this case, the values
+		 * correspond to `x,y,value`. If the first value is a string, it is
+		 * applied as the name of the point, and the `x` value is inferred.
+		 * The `x` value can also be omitted, in which case the inner arrays
+		 * should be of length 2\. Then the `x` value is automatically calculated,
+		 * either starting at 0 and incremented by 1, or from `pointStart`
+		 * and `pointInterval` given in the series options.
+		 *
+		 *  ```js
+		 *     data: [
+		 *         [0, 9, 7],
+		 *         [1, 10, 4],
+		 *         [2, 6, 3]
+		 *     ]
+		 *  ```
+		 *
+		 * 2.  An array of objects with named values. The objects are point
+		 * configuration objects as seen below. If the total number of data
+		 * points exceeds the series' [turboThreshold](#series.tilemap.turboThreshold),
+		 * this option is not available.
+		 *
+		 *  ```js
+		 *     data: [{
+		 *         x: 1,
+		 *         y: 3,
+		 *         value: 10,
+		 *         name: "Point2",
+		 *         color: "#00FF00"
+		 *     }, {
+		 *         x: 1,
+		 *         y: 7,
+		 *         value: 10,
+		 *         name: "Point1",
+		 *         color: "#FF00FF"
+		 *     }]
+		 *  ```
+		 *
+		 * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
+		 * coordinates are offset.
+		 *
+		 * @sample maps/series/tilemap-gridoffset
+		 *         Offset grid coordinates
+		 * @sample {highcharts} highcharts/chart/reflow-true/
+		 *         Numerical values
+		 * @sample {highcharts} highcharts/series/data-array-of-arrays/
+		 *         Arrays of numeric x and y
+		 * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/
+		 *         Arrays of datetime x and y
+		 * @sample {highcharts} highcharts/series/data-array-of-name-value/
+		 *         Arrays of point.name and y
+		 * @sample {highcharts} highcharts/series/data-array-of-objects/
+		 *         Config objects
+		 *
+		 * @type      {Array<Array<number>|*>}
+		 * @extends   series.heatmap.data
+		 * @excluding marker
+		 * @product   highcharts highmaps
+		 * @apioption series.tilemap.data
+		 */
+
+		/**
+		 * The color of the point. In tilemaps the point color is rarely set
+		 * explicitly, as we use the color to denote the `value`. Options for
+		 * this are set in the [colorAxis](#colorAxis) configuration.
+		 *
+		 * @type      {Highcharts.ColorString}
+		 * @product   highcharts highmaps
+		 * @apioption series.tilemap.data.color
+		 */
+
+		/**
+		 * The x coordinate of the point.
+		 *
+		 * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
+		 * coordinates are offset.
+		 *
+		 * @sample maps/series/tilemap-gridoffset
+		 *         Offset grid coordinates
+		 *
+		 * @type      {number}
+		 * @product   highcharts highmaps
+		 * @apioption series.tilemap.data.x
+		 */
+
+		/**
+		 * The y coordinate of the point.
+		 *
+		 * Note that for some [tileShapes](#plotOptions.tilemap.tileShape) the grid
+		 * coordinates are offset.
+		 *
+		 * @sample maps/series/tilemap-gridoffset
+		 *         Offset grid coordinates
+		 *
+		 * @type      {number}
+		 * @product   highcharts highmaps
+		 * @apioption series.tilemap.data.y
+		 */
 
 	}(Highcharts));
 	return (function () {