

Change Log
==========

### v6.1.4

* Fixed a bug that could cause the workbench to appear narrower than expected on some systems, and the map to be off-center when collapsing the workbench on all systems.

### v6.1.3

* When clicking a `Split` button on the workbench, the new catalog item will no longer be attached to the timeline even if the original was. This avoids a confusing situation where both catalog items would be locked to the same time.
* Added KMZ to the whitelisted formats for `MagdaCatalogItem`.
* Fixed a bug that caused a crash when switching to 2D with vector data already on the map, including when visiting a share link with vector data when the map ends up being 2D.
* The "Hide Workbench" button is now attached to the side of the Workbench, instead of on the opposite side of the screen from it.

### v6.1.2

* Fixed a bug that prevented `BingMapsSearchProviderViewModel` and other uses of `loadJsonp` from working correctly.

### v6.1.1

* Upgraded to terriajs-server v2.7.4.

### v6.1.0

* The previous default terrain provider, STK World Terrain, has been deprecated by its provider. *To continue using terrain in your deployed applications, you _must_ obtain a Cesium Ion key and add it to `config.json`*. See https://cesium.com/ to create an Ion account. New options are available in `config.json` to configure terrain from Cesium Ion or from another source. See https://terria.io/Documentation/guide/customizing/client-side-config/#parameters for configuration details.
* Upgraded to Cesium v1.48.
* Added `Cesium3DTilesCatalogItem` for visualizing [Cesium 3D Tiles](https://github.com/AnalyticalGraphicsInc/3d-tiles) datasets.
* Added `IonImageryCatalogItem` for accessing imagery assets on [Cesium Ion](https://cesium.com/).
* Added support for Cesium Ion terrain assets to `CesiumTerrainProvider`. To use an asset from Ion, specify the `ionAssetId` and optionally the `ionAccessToken` and `ionServer` properties instead of specifying a `url`.
* Fixed a bug that could cause legends to be missing from `WebMapServiceCatalogItems` that had `isEnabled` set to true.

### v6.0.5

* Added `rel="noreferrer noopener"` to all `target="_blank"` links. This prevents the target page from being able to navigate the source tab to a new page.
* Fixed a bug that caused the order of items on the Workbench to change when visiting a share link.

### v6.0.4

* Changed `CesiumSelectionIndicator` to no longer use Knockout binding. This will avoid a problem in some environments, such as when a Content Security Policy (CSP) is in place.

### v6.0.3

* Fixed a bug that prevented users from being able to enter coordinates directly into catalog function point parameter fields.

### v6.0.2

* Fixed a bug that prevented interaction with the 3D map when the splitter was active.

### v6.0.1

* Added `parameters` property to `ArcGisMapServerCatalogItem`, allowing arbitrary parameters to be passed in tile and feature info requests.

### v6.0.0

* Breaking Changes:
   * An application-level polyfill suite is now required for Internet Explorer 9 and 10 compatibility. The easiest approach is to add `<script src="https://cdn.polyfill.io/v2/polyfill.min.js"></script>` to the `<head>` element of your application's HTML page.
   * In TerriaJS v7.0.0 (the _next_ major release), a polyfill suite may be required for Internet Explorer 11 as well. Adopting the approach above now will ensure you don't need to worry about it then.
* Overhauled support for printing. There is now a Print button on the Share panel that will provide a much better printable form of the map than the browser's built-in print feature. If a user uses the browser's print button instead, a message at the top will suggest using the TerriaJS Print feature and open the Share panel. Calling `window.print` (e.g. on a TerriaJS instance inside an iframe) will invoke the new TerriaJS print feature directly.
* Fixed a bug that caused `Leaflet.captureScreenshot` to show all layers on both sides even with the splitter active.
* Fixed a bug that prevented some vector features from appearing in `Leaflet.captureScreenshot`.
* Added ability to move the splitter thumb position vertically so that users can move it to prevent occlusions.
* Added `TerriaJsonCatalogFunction`. This catalog function allows an arbitrary HTTP GET to be invoked with user-provided parameters and return TerriaJS catalog JSON.
* Fixed a bug that could cause the feature info panel to sometimes be nearly transparent in Internet Explorer 11.
* Fixed a bug that caused an expanded preview chart's workbench item to erroneously show the date picker.
* Updated `MagdaCatalogItem` to match Magda project

### 5.7.0

* Added `MagdaCatalogItem` to load details of a catalog item from [Magda](https://github.com/TerriaJS/magda).
* Fixed a bug that could cause a time-dynamic WMS layer to fail to ever show up on the map if the initial time on the timeline was outside the intervals where the layer had data.
* Fixed a bug which could cause a crash during load from share link when the layer default is to not `useOwnClock` but the share link has `useOwnClock` set.
* Fixed an issue that caused a 'This data source is already shown' error in particular circumstances.

### 5.6.4

* Fixed a bug causing an error message when adding tabular data to the workbench before it was loaded.

### 5.6.3

* Display of Lat Lon changed from 3 deciml places to 5 decimal places - just over 1m precision at equator.
* Fixed a bug that caused the timeline to appear when changing the time on the workbench for a layer not attached to the timeline.
* The workbench date/time picker is now available for time varying point and region CSVs.
* Fixed a bug that caused the workbench date picker controls to disappear when the item was attached to the timeline and the timeline's current time was outside the valid range for the item.

### 5.6.2

* Renamed search marker to location marker.
* Added the clicked coordinates to the bottom of the feature info panel. Clicking the marker icon will cause the location to be indicated on the map.
* The location marker is now included in shared map views.
* Fixed a bug that could cause split WMS layers to show the incorrect layer data for the date shown in the workbench.
* Refactored current time handling for `CatalogItem` to reduce the complexity and number of duplicated current time states.
* Fixed feature info updating when the time is changed from the workbench for `TableCatalogItem`.
* Change the workbench catalog item date picker so that updating the date does not disable the timeslider.
* Fix a bug that meant that, when the current time was updated on an `ImageryCatalogItem` while the layer wasn't shown, the old time was still shown when the layer was re-enabled.
* Added `{{terria.currentTime}}` to feature info template.
* Added a way to format times within a feature info tempate. E.g. `{{#terria.formatDateTime}}{"format": "dd-mm-yyyy HH:MM:ss"}{{terria.currentTime}}{{/terria.formatDateTime}}`.
* Fixed a bug that caused the selection indicator to float strangely when visiting a share link with a selected feature.
* Fixed a bug that caused a region to be selected even when clicking on a hole in that region.
* Fixed a bug that prevented the selection indicator from following moving features on the 2D map.
* Fixed a bug that caused Leaflet to stop rendering further points in a layer and throw errors when calculating extent when one point had invalid characters in the latitude or longitude field.
* We now default to `autoPlay: false` if it's not specified in `config.json`.
* Changed search box placeholders to more precisely reflect their functionality.
* CartoDB basemaps are now always loaded over HTTPS.

### 5.6.1

* Fixed a bug that could cause the workbench UI to hang when toggling concepts, particularly for an `SdmxJsonCatalogItem`.
* Added previous and next buttons to workbench catalog item date picker.

### 5.6.0

* Upgraded to Cesium 1.41.

### 5.5.7

* Added support for using tokens to access WMS layers, particularly using the WMS interface to ArcGIS servers.

### 5.5.6

* Tweaked the sizing of the feature info panel.
* Fixed a bug that caused `ArcGisMapServerCatalogItem` to always use the server's single fused map cache, if available. Now, if the `layers` property is specified, we request individual dynamic layers and ignore the fused map cache.

### 5.5.5

* Fixed a bug that caused the feature info panel to stop working after clicking on a location search marker.
* Added support for ArcGIS tokens on the 2D map. Previously, tokens only worked reliably in 3D.
* Improved handling of tile errors, making it more consistent between 2D and 3D.
* Fixed a bug that prevented the Add Data button from working Internet Explorer 9 unless the DevTools were also open.
* Improved the sizing of the feature info panel so it is less likely to completely obscure the map.

### 5.5.4

* Fixed a serious bug that prevented opening the Data Catalog in Internet Explorer.
* Fixed some problems with the Terria Spatial Analytics `CatalogFunctions`.

### 5.5.3

* Fixed a bug in SDMX-JSON when using `cannotSum`.

### 5.5.2

* Deprecated SDMX-JSON catalog items' `cannotDisplayPercentMap` in favour of `cannotSum`.
* Updated `cannotSum` so that it does not display a total in some cases, as well as suppressing the regional-percentage checkbox.  `cannotSum` can be either a mapping of concept ids to the values that prevent summing, or simply `true` to always prevent summing.
* Fixed a bug that caused an error when Splitting a layer that does not have a `clock`.

### 5.5.1

* Added `cannotDisplayPercentMap` to SDMX-JSON catalog items, to optionally turn off the "display as a percentage of regional total" checkbox when the data is not a count (eg. a rate or an average).

### 5.5.0

* Added the ability to split the screen into a left-side and right-side, and show raster and region mapped layers on only one side of the splitter.
* Added the ability to use a tabbed catalog in the explorer panel on desktop site. Setting `tabbedCatalog` parameter to `true` in `config.json` causes top-level groups in the catalog to list items in separate explorer panel tabs.
* Added the ability to use vector tile properties in feature info templates when using region mapping (data row attributes will overwrite vector tile properties with the same name)
* Properties available in feature info templates are now JSON parsed and replaced by their javascript object if they start with `[` or `{` and parse successfully
* Decreased flickering of time-varying region mapped layers by pre-rendering the next time interval.
* Fixed a bug in `WebMapServiceCatalogItem` that could cause a WMS time time dimension to be interpreted incorrectly if it was specified only using dates (not times) and with a periodicity of less than a day.

### 5.4.5

* Improved behaviour of SDMX-JSON items when no data is available.

### 5.4.4

* Added support for specifying namespaced layer names in the `WebMapServiceCatalogItem` `layers` property.
* Made TerriaJS tolerant of XML/HTML inside text elements in WMS GetCapabilities without being properly wrapped in `CDATA`.

### 5.4.3

* Fixed a build problem on case-sensitive file systems (e.g. most Linux systems).

### 5.4.2

* We no longer show the Zoom To button on the workbench when there is no rectangle to zoom to.

### 5.4.1

* Fixed a bug when sharing SDMX-JSON catalog items.
* Improved display of "Add Data" panel on small screens when Feedback and Feature Info panels are open.
* Added "search in data catalog" link to mobile search.
* Added a button to automatically copy share url into clipboard in share panel.
* Added `initFragmentPaths` property to the `parameters` section of `config.json`.  It can be used to specify an array of base paths for resolving init fragments in the URL.
* Modified `CkanCatalogItem` to exclude files that advertise themselves as KML files but have the file extension .ZIP.
* Removed "View full size image" link on the share panel.  Chrome 60 removed the ability to navigate to a data URI, and other browsers are expected to follow this lead.

### 5.4.0

* Breaking change: removed some old types that haven't been used since the new React-based user interface in v4.0.0, specifically `KnockoutHammerBinding`, `KnockoutMarkdownBinding`, `PopupMessageConfirmationViewModel`, `PopupMessageViewModel`, and `PopupViewModel`.
* Added the ability to use tokens from terriajs-server for layers requiring ESRI tokens.
* Catalog group items are now sorted by their in-catalog name

### 5.3.0

* Added the ability to use the analytics region picker with vector tile region mapping by specifiying a WMS server & layer for analytics only.
* Updated the client side validation to use the server-provided file size limit when drag/dropping a file requiring the conversion service.
* `zoomOnEnable` now works even for a catalog item that is initially enabled in the catalog.  Previously, it only worked for catalog items enabled via the user interface or otherwise outside of the load process.
* Added `initialTimeSource` property to `CsvCatalogItem` so it is possible to specify the value of the animation timeline at start from init files.
* Added to documentation for customizing data appearance.
* Added `CatalogShortcut` for creating tool items for linking to a `CatalogItem`.
* Renamed `ViewState.viewCatalogItem()` to `viewCatalogMember` to reflect that it can be used for all `CatalogMembers`, not just `CatalogItems`.
* Fixed a bug that could cause a crash when switching to 2D when the `initialView` was just a `Rectangle` instead of a `CameraView`.
* Fixed a bug that caused multiple layers with generated, gradient legends to all show the same legend on the Workbench.

### 5.2.11

* Pinned `urijs` to v1.18.10 to work around a breaking change in v1.18.11.

### 5.2.10

* Improved the conversion of Esri polygons to GeoJSON by `featureDataToGeoJson`.  It now correctly handles polygons with holes and with multiple outer rings.
* Added some fields to the dataset info page for `CkanCatalogItem`.
* Fixed a bug that could cause some layers, especially the Bing Maps basemap, to occasionally be missing from the 2D map.
* Fixed a bug that could cause the selected time to move to the end time when sharing a map with a time-dynamic layer.

### 5.2.9

* A catalog item's `cacheDuration` property now takes precedence over the cache duration specified by the code.  Previously, the `cacheDuration` would only override the default duration (2 weeks).

### 5.2.8

* Added option to expand the HTML embed code and toggle URL shorting for the share link.
* The Share feature now includes the current time selected on the timeline, so that anyone visiting a share link will see the map at the intended time.

### 5.2.7

* Added the Latitude and Longitude to the filename for the Feature Information file download.
* Added the time to the timeline labels when zoomed in to a single day. Previously, the label sometimes only showed the date.

### 5.2.6

* Added the ability to disable the conversion service so that no user data is sent outside of the client by setting `conversionServiceBaseUrl` to `false` in the `parameters` section of `config.json`.
* Added the ability to disable the location button by setting `disableMyLocation` to `true` in the `parameters` section of `config.json`.
* Fixed a bug that caused the share functionality to fail (both screenshot and share link) in 2d mode.
* Fixed a bug with explicitly styled enum columns in Internet Explorer.
* Fixed a bug that caused the selected column in a csv to be the second column when a time column is present.

### 5.2.5

* Fixed a bug with `forceProxy: true` which meant that vector tiles would try, and fail, to load over the proxy.
* Added documentation for customizing data appearance, and folded in existing but orphaned documentation for creating feature info templates.
* Changed the LocateMe button so that it toggles and continuously updates the location when Augmented Reality is enabled.
* Added the ability to set SDMX-JSON region names from a region type dimension, using a Mustache template. This was required so regions can be mapped to specific years, even if not specified by the SDMX-JSON server.
* Added `viewermode` to the users persistent local storage to remember the last `ViewerMode` used.
* Added the ability to customize the preamble text on the feedback form ("We would love to hear from you!") by setting `feedbackPreamble` in the `parameters` section of `config.json`.

### 5.2.4

* Fixed a bug that prevented error messages, such as when a dataset fails to load, from being shown to the user. Instead, the errors were silently ignored.

### 5.2.3

* Fixed a bug that gave expanded Sensor Observation Service charts poor names.
* Fixed a bug that prevented some table-based datasets from loading.

### 5.2.2

* Fixed download of selected dataset (as csv) so that quotes are handled in accordance with https://tools.ietf.org/html/rfc4180. As a result, more such downloads can be directly re-loaded in Terria by dragging and dropping them.

### 5.2.1

* Changed the default opacity for points from CSV files without a value column to 1.0 (previously it was 0.6).  This is a workaround for a Cesium bug (https://github.com/AnalyticalGraphicsInc/cesium/issues/5307) but really a better choice anyway.
* Fixed a bug which meant non-standard properties of some table data sources (eg. csv, SOS, SDMX-JSON) were missing in the feature info panel, because of a breaking change in Cesium 1.33.

### 5.2.0

* Fixed a bug that caused layer disclaimers to fail to appear when the layer was enabled via a share link.  Since the user was unable to accept the disclaimer, the layer also failed to appear.
* Added `AugmentedVirtuality` (user facing feature name Augmented Reality) to allow users to use their mobile device's orientation to set the camera view.
* Added the `showFeaturesAtAllTimes` option to Sensor Observation Service items. This improves the user experience if the server returns
  some features starting in 1990, say, and some starting in 1995, so that the latter still appear (as grey points with no data) in 1990.
* Fixed a bug that prevented preview charts in the feature info panel from updating when the user changed the Sensor Observation Service frequency.
* Fixed a bug that allowed the user to de-select all the display choices for Sensor Observation Service items.
* Improved the appearance of charts where all the y-values are null. (It now shows "No preview available".)
* Upgraded to Leaflet 1.0.3 for the 2D and preview maps.
* Upgraded to [Cesium 1.33](https://github.com/AnalyticalGraphicsInc/cesium/blob/1.33/CHANGES.md) for the 3D view.

### 5.1.1

* Fixed a bug that caused an 'added' and a 'shown' event for "Unnamed Item" to be logged to Google Analytics when previewing an item in the catalog.
* Added a 'preview' Google Analytics event when a catalog item is shown on the preview map in the catalog.
* Fixed a bug that prevented csv files with missing dates from loading.
* Fixed a bug that could cause an error when adding a layer without previewing it first.

### 5.1.0

* Fixed a bug that prevented `WebMapServiceCatalogItem` from acting as a time-dynamic layer when the time dimension was inherited from a parent layer.
* `WebMapServiceCatalogItem` now supports WMS 1.1.1 style dimensions (with an `Extent` element) in addition to the 1.3.0 style (`Dimension` only).
* `WebMapServiceCatalogItem` now passes dates only (rather than dates and times) to the server when the TIME dimension uses the `start/stop/period` form, `start` is a date only, and `period` does not include hours, minutes, or seconds.
* `WebMapServiceCatalogItem` now supports years and months (in addition to days, hours, minutes, and seconds) in the period specified of a TIME dimension.
* `WebMapServiceCatalogItem` now ignores [leap seconds](https://en.wikipedia.org/wiki/Leap_second) when evaluating ISO8601 periods in a time dimension.  As a result, 2 hours after `2016-06-30T23:00:00Z` is now `2016-07-01T01:00:00Z` instead of `2016-07-01T00:59:59Z` even though a leap second at the end of June 2016 makes that technically 2 hours and 1 second.  We expect that this is more likely to align with the expectations of WMS server software.
* Added option to specify `mobileDefaultViewerMode` in the `parameters` section of `config.json` to specify the default view mode when running on a mobile platform.
* Added support for `itemProperties` to `CswCatalogGroup`.
* Added `terria.urlEncode` function for use in feature info templates.
* Fixed a layout problem that caused the coordinates on the location bar to be displayed below the bar itself in Internet Explorer 11.
* Updated syntax to remove deprecation warnings with React version 15.5.

### 5.0.1

* Breaking changes:
  * Starting with this release, TerriaJS is meant to be built with Webpack 2.  The best way to upgrade your application is to merge from [TerriaMap](https://github.com/TerriaJS/TerriaMap).  If you run into trouble, post a message on the [TerriaJS forum](https://groups.google.com/forum/#!forum/terriajs).
  * Removed the following previously-deprecated modules: `registerKnockoutBindings` (no replacement), `AsyncFunctionResultCatalogItem` (now `ResultPendingCatalogItem`), `PlacesLikeMeFunction` (now `PlacesLikeMeCatalogFunction`), `SpatialDetailingFunction` (now `SpatialDetailingCatalogFunction`), and `WhyAmISpecialFunction` (now `WhyAmISpecialCatalogFunction`).
  * Removed `lib/Sass/StandardUserInterface.scss`.  It is no longer necessary to include this in your application.
  * Removed the previously-deprecated third pararameter, `getColorCallback`, of `DisplayVariablesConcept`.  Pass it inside the `options` parameter instead.
  * Removed the following previously-deprecated properties from `TableColumn`: `indicesIntoUniqueValues` (use `uniqueValues`), `indicesOrValues` (use `values`), `indicesOrNumericalValues` (use `uniqueValues` or `numericalValues`), and `usesIndicesIntoUniqueValues` (use `isEnum`).
  * Removed the previously-deprecated `dataSetID` property from `AbsIttCatalogItem`.  Use `datasetId` instead.
  * Removed the previously-deprecated `allowGroups` property from `CkanCatalogItem`.   Use `allowWmsGroups` or `allowWfsGroups` instead.
  * Removed the previously-deprecated `RegionMapping.setRegionColumnType` function.  Use the `setRegionColumnType` on an _instance_ of `RegionMapping` instead.
  * Removed the previously-deprecated `regionMapping.regionDetails[].column` and `.disambigColumn`. Use `.columnName` and `.disambigColumnName` instead.
  * Removed the previously-deprecated `options.regionMappingDefinitionsUrl` parameter from the `Terria` constructor.  Set the `regionMappingDefinitionsUrl` inside `parameters` in `config.json` instead.
* Fixed a bug in `WebMapServiceCatalogItem` that prevented TerriaJS from correctly determining the projections supported by a WMS layer when supported projections are inherited from parent layers.
* Changed "no value" colour of region-mapped data to fully transparent, not black.
* Fixed an issue where expanding a chart from an SDMX-JSON or SOS feature twice, with different data choices selected, would overwrite the previous chart.
* Improved SDMX-JSON items to still show properly, even if the `selectedInitially` property is invalid.
* Added `Score` column to `GNAFAddressGeocoder` to indicate relative quality, which maps as default variable.

### 4.10.5

* Improved error message when accessing the user's location under http with Chrome.
* When searching locations, the button to instead search the catalog is now above the results instead of below them.
* Changed "go to full screen mode" tooltip to "Hide workbench", and "Exit Full Screen" button to "Show Workbench".  The term "full screen" was misleading.
* Fixed a bug where a chartable (non-geo-spatial) CSV file with a column including the text "height" would not let the user choose the "height" column as the y-axis of a chart.
* Added support for non-default x-axes for charts via `<chart x-column="x">` and the new `tableStyle.xAxis` parameter.
* Added support for a `charSet` parameter on CSV catalog items, which overrides the server's mime-type if present.

### 4.10.4

* Added the ability for `CkanCatalogGroup` to receive results in pages, rather than all in one request.  This will happen automatically when the server returns partial results.
* Improved the performance of the catalog UI by not creating React elements for the contents of a group until that group is opened.
* Close polygons used as input to a `CatalogFunction` by making the last position the same as the first one.
* Added support for a new `nameInCatalog` property on all catalog members which overrides `name` when displayed in the catalog, if present.
* Added `terria.urlEncodeComponent` function for use in feature info templates.
* `yAxisMin` and `yAxisMax` are now honored when multiple charts are active, by using the minimum `yAxisMin` and the maximum `yAxisMax` of all charts.

### 4.10.3

* Locked third-party dependency proj4 to v2.3.x because v2.4.0 breaks our build.

### 4.10.2

* New sections are now merged info `CatalogMember.info` when `updateFromJson` is called multiple times, rather than the later `info` completely replacing the earlier one.  This is most useful when using `itemProperties` to override some of the info sections in a child catalog item.
* Fixed a bug where csv files with a date column would sometimes fail if a date is missing.

### 4.10.1

* Improved the SDMX-JSON catalog item to handle huge dimensions, allow a blacklist, handle bad responses better, and more.
* Fixed a bug that prevented the proxy from being used for loading legends, even in situations where it is necessary such as an `http` legend accessed from an `https` site.
* Added link to re-download local files, noting that TerriaJS may have done additional processing (eg. geocoding).

### 4.10.0

* Changed defaults:
  * `WebProcessingServiceCatalogFunction` now defaults to invoking the `Execute` service via an HTTP POST with XML encoding rather than an HTTP GET with KVP encoding.  This is a more sensible default because the WPS specification requires that servers support POST/XML while GET/KVP is optional.  Plus, POST/XML allows large input parameters, such as a polygon descibing all of Australia, to be successfully passed to the WPS process.  To force use of GET/KVP, set the `executeWithHttpGet` property to `true`.
* Fixed problems with third-party dependencies causing `npm install` and `npm run gulp` to fail.

### 4.9.0

* Added a help overlay system. A TerriaJS application can define a set of help sequences that interactively walk the user through a task, such as adding data to the map or changing map settings. The help sequences usually appear as a drop-down Help menu in the top-right corner.
* Fixed a bug with calculating bounding rectangles in `ArcGisCatalogItem` caused by changes to `proj4` package.
* Fixed a bug preventing chart axis labels from being visible on a white background.
* Fixed a bug that caused the Feedback panel to appear below the chart panel, making it difficult to use.

### 4.8.2

* Fixed a bug that prevented a `shareUrl` specified in `config.json` from actually being used by the `ShareDataService`.
* Adding a JSON init file by dropping it on the map or selecting it from the My Data tab no longer adds an entry to the Workbench and User-Added Data catalog.
* WPS return type can now be `application/vnd.terriajs.catalog-member+json` which allows a json catalog member to be returned in WPS along with the usual attributes to control display.
* `chartLineColor` tableStyle attribute added, allowing per column specification of chart line color.
* Fixed a bug that caused a `WebMapServiceCatalogItem` inside a `WebMapServiceCatalogGroup` to revert to defaults from GetCapabilities instead of using shared properties.
* Fix a bug that prevented drawing the marker and zooming to the point when searching for a location in 2D.
* Fixed a bug where `WebMapTileServiceCatalogItem` would incorrectly interpret a bounding box and return only the lower left corner causing Cesium to crash on render.
* Fixed a bug that caused the feedback form to be submitted when unchecking "Share my map view".

### 4.8.1

* `CkanCatalogGroup` now automatically adds the type of the resource (e.g. `(WMS)`) after the name when a dataset contains multiple resources that can be turned into catalog items and `useResourceName` is false.
* Added support for ArcGIS FeatureServers to `CkanCatalogGroup` and `CkanCatalogItem`.  In order for `CkanCatalogGroup` to include FeatureServers, `includeEsriFeatureServer` must be set to true.
* Changed default URL for the share service from `/share` to `share` and made it configurable by specifying `shareUrl` in config.json.  This helps with deployments in subdirectories.

### 4.8.0

* Fixed a bug that prevented downloading data from the chart panel if the map was started in 2D mode.
* Changed the default opacity of table data to 0.8 from 0.6.
* Added the ability to read dates in the format "2017-Q2".
* Improved support for SDMX-JSON, including showing values as a percent of regional totals, showing the selected conditions in a more concise format, and fixing some bugs.
* Updated `TableCatalogItem`s to show a download URL in About This Dataset, which downloads the entire dataset as csv, even if the original data was more complex (eg. from an API).
* The icon specified to the `MenuPanel` / `DropdownPanel` theme can now be either the identifier of an icon from `Icon.GLYPHS` or an actual SVG `require`'d via the `svg-sprite-loader`.
* Fixed a bug that caused time-varying points from a CSV file to leave a trail on the 2D map.
* Add `Terria.filterStartDataCallback`.  This callback gives an application the opportunity to modify start (share) data supplied in a URL before TerriaJS loads it.
* Reduced the size of the initial TerriaJS JavaScript code by about 30% when starting in 2D mode.
* Upgraded to [Cesium 1.29](https://github.com/AnalyticalGraphicsInc/cesium/blob/1.29/CHANGES.md).

### 4.7.4

* Renamed `SpatialDetailingFunction`, `WhyAmISpecialFunction`, and `PlacesLikeMeFunction` to `SpatialDetailingCatalogFunction`, `WhyAmISpecialCatalogFunction`, and `PlacesLikeMeCatalogFunction`, respectively.  The old names will be removed in a future release.
* Fixed incorrect tooltip text for the Share button.
* Improved the build process and content of the user guide documentation.

### 4.7.3

* Canceled pending tile requests when removing a layer from the 2D map.  This should drastically improve the responsiveness when dragging the time slider of a time-dynamic layer in 2D mode.
* Added the data source and data service details to the "About this dataset" (preview) panel.
* Fixed a bug introduced in 4.7.2 which made the Feature Info panel background too pale.

### 4.7.2

* Updated GNAF API to new Lucene-based backend, which should improve performance.
* Updated custom `<chart>` tag to allow a `colors` attribute, containing comma separated css strings (one per column), allowing users to customize chart colors. The `colors` attribute in charts can also be passed through from a WPS ComplexData response.
* Updated styling of Give Feedback form.
* Improved consistency of "Search" and "Add Data" font sizes.
* Improved flexibility of Feature Info Panel styling.
* Fixed a bug that could cause an extra `/` to be added to end of URLs by `ArcGisMapServerCatalogItem`, causing some servers to reject the request.
* Added a workaround for a bug in Internet Explorer 11 on Windows 7 that could cause the user interface to hang.

### 4.7.1

* Fixed a bug where providing feedback did not properly share the map view.
* Updated to terriajs-server 2.6.2.
* Fixed a bug leading to oversized graphics being displayed from WPS calls.

### 4.7.0

* Added the ability for users to share their view of the map when providing feedback.
* Extra components can now be added to FeatureInfoSection.
* Updated "Download Data" in FeatureInfoSection to "Download Data for this Feature".
* Fixed the color of visited links in client apps with their own css variables.
* Fixed a bug that prevented the scale bar from displaying correctly.

### 4.6.1

* Added support for creating custom WPS types, and for reusing `Point`, `Polygon`, and `Region` editors in custom types.
* Fixed a bug that caused the legend to be missing for WMS catalog items where the legend came from GetCapabilities but the URL did not contain `GetLegendGraphic`.

### 4.6.0

* Changed defaults:
  * The `clipToRectangle` property of raster catalog items (`WebMapServiceCatalogItem`, `ArcGisMapServerCatalogItem`, etc.) now defaults to `true`.  It was `false` in previous releases.  Using `false` prevents features (especially point features) right at the edge of the layer's rectangle from being cut off when the server reports too tight a rectangle, but also causes the layer to load much more slowly in many cases.  Starting in this version, we favour performance and the much more common case that the rectangle can be trusted.
* Made `WebMapServiceCatalogItem` tolerant of a `GetCapabilities` where a `LegendURL` element does not have an `OnlineResource` or a `Dimension` does not have any values.
* Added support for 'Long' type hint to CSV data for specifying longitude.
* The marker indicating the location of a search result is now placed correctly on the terrain surface.
* `CatalogFunction` region parameters are now selected on the main map rather than the preview map.
* Some regions that were previously not selectable in Analytics, except via autocomplete, are now selectable.
* Added hover text that shows the position of data catalog search results in the full catalog.
* Widened scrollbars and improve their contrast.
* Removed the default maximum number of 10 results when searching the data catalog.
* Allow users to browse for JSON configuration files when adding "Local Data".
* Made it easier to use custom fonts and colors in applications built on TerriaJS, via new SCSS variables.
* Fixed a bug that caused a `CswCatalogGroup` to fail to load if the server had a `references` element without a `protocol`.

### 4.5.1

* The order of the legend for an `ArcGisMapServerCatalogItem` now matches the order used by ArcGIS itself.
* Large legends are now scaled down to fit within the width of the workbench panel.
* Improved the styling of links inside the Feature Information panel.
* Fixed a bug that could cause the Feature Information panel's close button to initially appear in the wrong place, and then jump to the right place when moving the mouse near it.

### 4.5.0

* Added support for the Sensor Observation Service format, via the `SensorObservationServiceCatalogItem`.
* Added support for end date columns in CSV data (automatic with column names containing `end_date`, `end date`, `end_time`, `end time`; or set in json file using `isEndDate` in `tableStyle.columns`.
* Fixed calculation of end dates for moving-point CSV files, which could lead to points disappearing periodically.
* Fixed a bug that prevented fractional seconds in time-varying WMS periodicity.
* Added the ability to the workbench UI to select the `style` to use to display a Web Map Service (WMS) layer when multiple styles are available.
* Added the ability to the workbench UI to select from among the available dimensions of a Web Map Service (WMS) layer.
* Improved the error reporting and handling when specifying invalid values for the WMS COLORSCALERANGE parameter in the UI.
* Added the ability to drag existing points when creating a `UserDrawing`.
* Fixed a bug that could cause nonsensical legends for CSV columns with all null values.
* Fixed a bug that prevented the Share panel from being used at all if the URL shortening service encountered an error.
* Fixed a bug that could cause an error when adding multiple catalog items to the map quickly.
* Tweaked the z-order of the window that appears when hovering over a chart series, so that it does not appear on top of the Feature Information panel.
* Fixed a bug that could lead to incorrect colors in a legend for a CSV file with explicit `colorBins` and cut off at a minimum and maximum.
* We now show the feature info panel the first time a dataset is added, containing a suggestion to click the map to learn more about a location.  Also improved the wording for the feature info panel when there is no data.
* Fixed support for time-varying feature info for vector tile based region mapping.
* `updateApplicationOnMessageFromParentWindow` now also allows messages from the `opener` window, i.e. the window that opened the page by calling `window.open`.  The parent or opener may now also send a message with an `allowOrigin` property to specify an origin that should be allowed to post messages.
* Fixed a bug that prevented charts from loading http urls from https.
* The `isNcWMS` property of `WebMapServiceCatalogItem` is now set to true, and the COLORSCALERANGE controls are available in the UI, for ncWMS2 servers.
* Added the ability to prevent CSVs with time and `id` columns from appearing as moving points, by setting `idColumns` to either `null` or `[]`.
* Fixed a bug that prevented default parameters to `CatalogFunction`s from being shown in the user interface.
* Fixed a problem that made `BooleanParameter`s show up incorrectly in the user interface.
* Embedded `<chart>` elements now support two new optional attributes:
   * `title`: overrides the title that would otherwise be derived from the name of the feature.
   * `hide-buttons`: If `"true"`, the Expand and Download buttons are hidden from the chart.
* Fixed a bug in embedded `<collapsible>` elements that prevented them from being expandable.
* Improved SDMX-JSON support to make it possible to change region type in the UI.
* Deprecated `RegionMapping.setRegionColumnType` in favour of `RegionMapping.prototype.setRegionColumnType`. `regionDetails[].column` and `.disambigColumn` have also been deprecated.

### 4.4.1

* Improved feature info display of time-varying region-mapped csvs, so that chart is still shown at times with no data.
* Fix visual hierarchy of groups and items in the catalog.

### 4.4.0

* Fixed a bug that caused Cesium (3D view) to crash when plotting a CSV with non-numerical data in the depth column.
* Added automatic time-series charts of attributes to the feature info of time-varying region-mapped csvs.
* Refactored Csv, AbsItt and Sdmx-Json catalog items to depend on a common `TableCatalogItem`. Deprecated `CsvCatalogItem.setActiveTimeColumn` in favour of `tableStructure.setActiveTimeColumn`.
* Error in geocoding addresses in csv files now shows in dialog box.
* Fixed CSS styling of the timeline and added padding to the feature info panel.
* Enhanced JSON support to recognise JSON5 format for user-added files.
* Deprecated `indicesIntoUniqueValues`, `indicesOrValues`, `indicesOrNumericalValues` and `usesIndicesIntoUniqueValues` in `TableColumn` (`isEnum` replaces `usesIndicesIntoUniqueValues`).
* Added support for explicitly colouring enum columns using a `tableStyle.colorBins` array of `{"value":v, "color":c}` objects
* Improved rendering speed when changing the display variable for large lat/lon csv files.
* Default to moving feature CSVs if a time, latitude, longitude and a column named `id` are present.
* Fixed a bug so units flow through to charts of moving CSV features.
* Fixed a bug that prevented the `contextItem` of a `CatalogFunction` from showing during location selection.
* Fixed a bug that caused `&amp;` to appear in some URLs instead of simply `&`, leading to an error when visiting the link.
* Added the ability to pass a LineString to a Web Processing Service.
* Fixed a bug that prevented `tableStyle.dataVariable` = `null` from working.
* Uses a smarter default column for CSV files.
* Fixed a bug that caused an error message to appear repeatedly when there was an error downloading tiles for a base map.
* Fixed a bug that caused WMS layer names and WFS type names to not be displayed on the dataset info page.
* We now preserve the state of the feature information panel when sharing.  This was lost in the transition to the new user interface in 4.0.0.
* Added a popup message when using region mapping on old browsers without an `ArrayBuffer` type (such as Internet Explorer 9).  These browsers won't support vector tile based region mapping.
* Fixed bug where generic parameters such as strings were not passed through to WPS services.
* Fixed a bug where the chart panel did not update with polled data files.
* Removed the Australian Hydrography layer from `createAustraliaBaseMapOptions`, as the source is no longer available.
* Fixed a bug that caused the GetCapabilities URL of a WMS catalog item to be shown even when `hideSource` was set to true.
* Newly-added user data is now automatically selected for the preview map.
* Fixed a bug where selecting a new column on a moving point CSV file did not update the chart in the feature info panel.
* Fixed dropdowns dropping from the bounds of the screen in Safari.
* Fixed a bug that prevented the feature info panel from updating with polled lat/lon csvs.
* Improved handing of missing data in charts, so that it is ignored instead of shown as 0.

### 4.3.3

* Use react-rangeslider 1.0.4 because 1.0.5 was published incorrectly.

### 4.3.2

* Fixed css styling of shorten URL checkbox.

### 4.3.1

* Added the ability to specify the URL to the `serverConfig` service in `config.json` as `parameters.serverConfigUrl`.

### 4.3.0

* Added `Terria.batchGeocoder` property.  If set, the batch geocoder is used to resolve addresses in CSV files so that they can be shown as points on the map.
* Added `GnafAddressGeocoder` to resolve Australian addresses using the GNAF API.
* Added a loading indicator for user-added files.
* Fixed a bug that prevented printing the map in the 2D mode.
* Fixed a bug when changing between x-axis units in the chart panel.
* Moved all Terria styles into CSS-modules code (except Leaflet) - `lib/Sass/StandardUserInterface.scss` no longer needs to be imported and now only includes styles for backwards compatibility.

### 4.2.1

* Fixed bug that prevented the preview map displaying on mobile devices.

### 4.2.0

* There is a known bug in this version which prevents the user from being able to choose a region for some Analytics functions.
* Added support for ArcGis FeatureServers, using the new catalog types `esri-featureServer` and `esri-featureServer-group`. Catalog type `esri-group` can load REST service, MapServer and FeatureServer endpoints. (For backwards compatibility, catalog type `esri-mapServer-group` continues to work for REST service as well as MapServer endpoints.)
* Enumeration parameter now defaults to what is shown in UI, and if parameter is optional, '' is default.
* Adds bulk geocoding capability for Australian addresses. So GnafAPI can be used with batches of addresses, if configured.
* Fixed a bug that caused the selection indicator to get small when near the right edge of the map and to overlap the side panel when past the left edge.
* Map controls and menus now become translucent while the explorer window (Data Catalog) is visible.
* Removed find-and-replace for cesium workers from the webpack build as it's done in terriajs-cesium now.
* Legend images that fail to load are now hidden entirely.
* Improved the appearance of the opacity slider and added a percentage display.
* AllowedValues for LiteralData WPS input now works even if only one value specified.
* Fixed bug in WPS polygon datatype to return valid polygon geojson.
* Fix regression: cursor changes in UserDrawing now functions in 2D as well as 3D.
* Updated to [Cesium](http://cesiumjs.org) 1.23 (from 1.20).  See the [change log](https://github.com/AnalyticalGraphicsInc/cesium/blob/1.23/CHANGES.md) for details.
* Fixed a bug which prevented feature info showing for Gpx-, Ogr-, WebFeatureService-, ArcGisFeatureServer-, and WebProcessingService- CatalogItems.
* Added support for a wider range of SDMX-JSON data files, including the ability to sum over dimensions via `aggregatedDimensionIds`.
* Added support for `tableStyle.colorBins` as array of values specifying the boundaries between the color bins in the legend, eg. `[3000, 3500, 3900, 4000]`. `colorBins` can still be an integer specifying the number of bins, in which case Terria determines the boundaries.
* Made explorer panel not rendered at all when hidden and made the preview map destroy itself when unmounted - this mitigates performance issues from having Leaflet running in the background on very busy vector datasets.
* Fixed a bug which prevented time-varying CZML feature info from updating.
* Added support for moving-point csv files, via an `idColumns` array on csv catalog items. By default, feature positions, color and size are interpolated between the known time values; set `isSampled` to false to prevent this. (Color and size are never interpolated when they are drawn from a text column.)
* Added support for polling csv files with a partial update, and by using `idColumns` to identify features across updates.
* Added a time series chart to the Feature Info Panel for sampled, moving features.
* Fixed a bug which sometimes prevented feature info from appearing when two region-mapped csv files were displayed.
* Fixed the preview map extent being one item behind what was actually selected.

### 4.1.2

* Fixed a bug that prevented sharing from working in Internet Explorer.

### 4.1.1

* Stopped IE9 from setting bizarre inline dimensions on custom branding images.
* Fixed workbench reordering in browsers other than Chrome.
* URLs on the dataset info page are now auto-selected by clicked, making them easier to copy.

### 4.1.0

* Made the column title for time-based CSV exports from chart default to 'date'
* Stopped the CSV creation webworker from being run multiple times on viewing a chart.
* Removed the empty circles from non-selected base maps on the Map settings panel.
* Prevented text from being selected when dragging the compass control.
* Added the `MeasureTool` to allow users to interactively measure the distance between points.
* Worked around a problem in the Websense Web Filter that caused it to block access to some of the TerriaJS Web Workers due to a URL in the license text in a comment in a source file.

### 4.0.2

* Fixed a bug that prevented opening catalog groups on iOS.
* Fixed a CSS warning.

### 4.0.1

* Fixed a bug that caused an error message to be formatted incorrectly when displayed to the user.

### 4.0.0

* Rewrote the TerriaJS user interface using React.  We believe the new interface is a drastic improvement, incorporating user feedback and the results of usability testing.  Currently, it is a bit harder to customize than our old user interface, so if your application has extensive customizations, we suggest delaying upgrading to this version for a little while logner.
* Added support for non-geospatial CSV files, which display in a new chart panel.
* Added support for customisable tags in Feature Info templates.
* Implemented [`<chart>` and `<collapsible>`](https://github.com/TerriaJS/terriajs/blob/4.0.0/lib/ReactViews/Custom/registerCustomComponentTypes.js#L52-L106) tags in Feature Info templates.
* Added support for [polling](https://github.com/TerriaJS/terriajs/blob/4.0.0/lib/Models/Polling.js) for updates to CSV files.
* `CswCatalogGroup` will now include Web Processing Services from the catalog if configured with `includeWps` set to true.
* `WebMapServiceCatalogItem` will now detect ncWMS servers and set isNcWMS to true.
* New `ShareDataService` which can store and resolve data. Currently it is used as a replacement for Google URL Shortener, which can't handle long URLs.
* New `ServerConfig` object which provides configuration information about the server, including which domains can be proxied for. This changes the way CorsProxy is initialised.
* Added partial support for the SDMX-JSON format.
* `UserDrawing` added for drawing lines and polygons on the map.
* CkanCatalogGroup's `filterQuery` items can now be specified as objects instead of URL-encoded strings.

### 3.5.0

* Ungrouped items in CKAN catalog items are now grouped under an item whose title is determined by .ungroupedTitle (default: "No group").
* CKAN's default search regex for KMLs also includes KMZ.
* Add documentation of camera properties.

### 3.4.0

* Support JSON5 (http://json5.org/) use in init files and config files, so comments can be used and object keys don't need to be quoted.
* Fixed a bug that caused the `corsProxyBaseUrl` specified in `config.json` to be ignored.
* Fixed a bug preventing downloading feature info data in CSV format if it contained nulls.
* Added support for the WMS Style/MetadataURL tag in layer description.
* Long titles in locally-generated titles now word-wrap in most web browsers.
* Long auto-generated legend titles now word wrap in most web browsers.

### 3.3.0

* Support `parameters` property in WebFeatureServiceCatalogItem to allow accessing URLs that need additional parameters.
* Fixed a bug where visiting a shared link with a time-series layer would crash load.
* Added a direct way to format numbers in feature info templates, eg. `{{#terria.formatNumber}}{"useGrouping": true, "maximumFractionDigits": 3}{{value}}{{/terria.formatNumber}}`. The quotes around the keys are optional.
* When the number of unique values in a CSV column exceeds the number of color bins available, the legend now displays "XX other values" as the label for the last bucket rather than simply "Other".
* CSV columns with up to 21 unique values can now be fully displayed in the legend.  Previously, the number of bins was limited to 9.
* Added `cycle` option to `tableColumnStyle.colorBinMethod` for enumeration-type CSV columns.  When the number of unique values in the column exceeds the number of color bins available, this option makes TerriaJS color all values by cycling through the available colors, rather than coloring only the most common values and lumping the rest into an "Other" bucket.
* Metadata and single data files (e.g. KML, GeoJSON) are now consistently cached for one day instead of two weeks.
* `WebMapServiceCatalogItem` now uses the legend for the `style` specified in `parameters` when possible.  It also now includes the `parameters` when building a `GetLegendGraphic` URL.
* Fixed a bug that prevented switching to the 3D view after starting the application in 2D mode.

### 3.2.1

* Fixed a bug on IE9 which prevented shortened URLs from loading.
* Fixed a map started with smooth terrain being unable to switch to 3D terrain.
* Fixed a bug in `CkanCatalogItem` that prevented it from using the proxy for dataset URLs.
* Fixed feature picking when displaying a point-based vector and a region mapped layer at the same time.
* Stopped generation of WMS intervals being dependent on JS dates and hence sensitive to DST time gaps.
* Fixed a bug which led to zero property values being considered time-varying in the Feature Info panel.
* Fixed a bug which prevented lat/lon injection into templates with time-varying properties.

### 3.2.0

* Deprecated in this version:
  - `CkanCatalogItem.createCatalogItemFromResource`'s `options` `allowGroups` has been replaced with `allowWmsGroups` and `allowWfsGroups`.
* Added support for WFS in CKAN items.
* Fixed bug which prevented the terria-server's `"proxyAllDomains": true` option from working.
* Added support in FeatureInfoTemplate for referencing csv columns by either their name in the csv file, or the name they are given via `TableStyle.columns...name` (if any).
* Improved CSV handling to ignore any blank lines, ie. those containing only commas.
* Fixed a bug in `CswCatalogGroup` that prevented it from working in Internet Explorer.

### 3.1.0

* Only trigger a search when the user presses enter or stops typing for 3 seconds.  This will greatly reduce the number of times that searches are performed, which is important with a geocoder like Bing Maps that counts each geocode as a transaction.
* Reduced the tendency for search to lock up the web browser while it is in progress.
* Include "engines" attribute in package.json to indicate required Node and NPM version.
* For WMS catalog items that have animated data, the initial time of the timeslider can be specified with `initialTimeSource` as `start`, `end`, `present` (nearest date to present), or with an ISO8601 date.
* Added ability to remove csv columns from the Now Viewing panel, using `"type": "HIDDEN"` in `tableStyle.columns`.

### 3.0.0

* TerriaJS-based application are now best built using Webpack instead of Browserify.
* Injected clicked lat and long into templates under `{{terria.coords.latitude}}` and `{{terria.coords.longitude}}`.
* Fixed an exception being thrown when selecting a region while another region highlight was still loading.
* Added `CesiumTerrainCatalogItem` to display a 3D surface model in a supported Cesium format.
* Added support for configuration of how time is displayed on the timeline - catalog items can now specify a dateFormat hash
    in their configuration that has formats for `timelineTic` (what is displayed on the timeline itself) and `currentTime`
    (which is the current time at the top-left).
* Fixed display when `tableStyle.colorBins` is 0.
* Added `fogSettings` option to init file to customize fog settings, introduced in Cesium 1.16.
* Improved zooming to csvs, to include a small margin around the points.
* Support ArcGis MapServer extents specified in a wider range of projections, including GDA MGA zones.
* WMS legends now use a bigger font, include labels, and are anti-aliased when we can determine that the server is Geoserver and supports these options.
* Updated to [Cesium](http://cesiumjs.org) 1.20.  Significant changes relevant to TerriaJS users include:
    * Fixed loading for KML `NetworkLink` to not append a `?` if there isn't a query string.
    * Fixed handling of non-standard KML `styleUrl` references within a `StyleMap`.
    * Fixed issue in KML where StyleMaps from external documents fail to load.
    * Added translucent and colored image support to KML ground overlays
    * `GeoJsonDataSource` now handles CRS `urn:ogc:def:crs:EPSG::4326`
    * Fix a race condition that would cause the terrain to continue loading and unloading or cause a crash when changing terrain providers. [#3690](https://github.com/AnalyticalGraphicsInc/cesium/issues/3690)
    * Fix issue where the `GroundPrimitive` volume was being clipped by the far plane. [#3706](https://github.com/AnalyticalGraphicsInc/cesium/issues/3706)
    * Fixed a reentrancy bug in `EntityCollection.collectionChanged`. [#3739](https://github.com/AnalyticalGraphicsInc/cesium/pull/3739)
    * Fixed a crash that would occur if you added and removed an `Entity` with a path without ever actually rendering it. [#3738](https://github.com/AnalyticalGraphicsInc/cesium/pull/3738)
    * Fixed issue causing parts of geometry and billboards/labels to be clipped. [#3748](https://github.com/AnalyticalGraphicsInc/cesium/issues/3748)
    * Fixed bug where transparent image materials were drawn black.
    * Fixed `Color.fromCssColorString` from reusing the input `result` alpha value in some cases.
* Added support for time-series data sets with gaps - these are skipped when scrubbing on the timeline or playing.

### 2.3.0

* Share links now contain details about the picked point, picked features and currently selected feature.
* Reorganised the display of disclaimers so that they're triggered by `CatalogGroup` and `CatalogItem` models, which trigger `terria.disclaimerEvent`, which is listened to by DisclaimerViewModel`. `DisclaimerViewModel` must be added by the map that's using Terria.
* Added a mechanism for hiding the source of a CatalogItem in the view info popup.
* Added the `hideSource` flag to the init json for hiding the source of a CatalogItem in the View Info popup.
* Fixed a bug where `CatalogMember.load` would return a new promise every time it was called, instead of retaining the one in progress.
* Added support for the `copyrightText` property for ArcGis layers - this now shows up in info under "Copyright Text"
* Showed a message in the catalog item info panel that informs the user that a catalog item is local and can't be shared.
* TerriaJS now obtains its list of domains that the proxy will proxy for from the `proxyableDomains/` service.  The URL can be overridden by setting `parameters.proxyableDomainsUrl` in `config.json`.
* Updated to [Cesium](http://cesiumjs.org) 1.19.  Significant changes relevant to TerriaJS users include:
    * Improved KML support.
        * Added support for `NetworkLink` refresh modes `onInterval`, `onExpire` and `onStop`. Includes support for `viewboundScale`, `viewFormat`, `httpQuery`.
        * Added partial support for `NetworkLinkControl` including `minRefreshPeriod`, `cookie` and `expires`.
        * Added support for local `StyleMap`. The `highlight` style is still ignored.
        * Added support for `root://` URLs.
        * Added more warnings for unsupported features.
        * Improved style processing in IE.

### 2.2.1

* Improved legend and coloring of ENUM (string) columns of CSV files, to sort first by frequency, then alphabetically.

### 2.2.0

* Warn user when the requested WMS layer doesn't exist, and try to provide a suggestion.
* Fixed the calculation of a CSV file's extent so that missing latitudes and longitudes are ignored, not treated as zero.
* Improved the user experience around uploading files in a format not directly supported by TerriaJS and optionally using the conversion service.
* Improved performance of large CSV files, especially the loading time, and the time taken to change the display variable of region-mapped files.
* Added support for CSV files with only location (lat/lon or region) columns, and no value columns, using a file-specific color. Revised GeoJSON display to draw from the same palette of colors.
* Fixed a bug that prevented GeoJSON styles from being applied correctly in some cases.
* Fixed an error when adding a CSV with one line of data.
* Fixed error when adding a CSV file with numeric column names.
* Polygons and polylines are now highlighted on click when the geometry is available.
* Improved legend and coloring of ENUM (string) columns of CSV files; only the most common values are colored differently, with the rest shown as 'Other'.
* Added support for running the automated tests on the local system (via `gulp test`), on BrowserStack (via `gulp test-browserstack`), and on Sauce Labs (via `gulp test-saucelabs`).
* Changed `tableStyle`'s `format` to only accept `useGrouping`, `maximumFractionDigits` and `styling: "percent"` options. Previously some other options may have worked in some browsers.
* Improved color palette for string (ENUM) columns of CSV files.
* Improved CSV loading to ignore any completely blank lines after the header row (ie. lines which do not even have commas).
* Added support for grouping catalog items retrieved from a CSW server according to criteria specified in the init file (via the `metadataGroups` property) or from a `domainSpecification` and a call to the `GetDomain` service on the CSW server.
* Added `UrlTemplateCatalogItem`, which can be used to access maps via a URL template.
* Improved ABS display (to hide the regions) when a concept is deselected.
* Improved readability of ArcGIS catalog items and legends by replacing underscores with spaces.
* `ArcGisMapServerCatalogItem` metadata is now cached by the proxy for only 24 hours.
* Improved the feature info panel to update the display of time-varying region-mapped CSV files for the current time.
* Updated to [Cesium](http://cesiumjs.org) 1.18.  Significant changes relevant to TerriaJS users include:
  * Improved terrain performance by up to 35%. Added support for fog near the horizon, which improves performance by rendering less terrain tiles and reduces terrain tile requests. [#3154](https://github.com/AnalyticalGraphicsInc/cesium/pull/3154)
  * Reduced the amount of GPU and CPU memory used by terrain by using compression. The CPU memory was reduced by up to 40%, and approximately another 25% in Chrome.
  * Fixed an issue where the sun texture is not generated correctly on some mobile devices. [#3141](https://github.com/AnalyticalGraphicsInc/cesium/issues/3141)
  * Cesium now honors window.devicePixelRatio on browsers that support the CSS imageRendering attribute. This greatly improves performance on mobile devices and high DPI displays by rendering at the browser-recommended resolution. This also reduces bandwidth usage and increases battery life in these cases.

### 2.1.1

* Fixed sharing of time-varying czml files; the timeline was not showing on the shared link.
* Fixed sharing of user-added time-varying csv files.
* Fixed a bug in `CkanCatalogItem` that made it build URLs incorrectly when given a base URL ending in a slash.

### 2.1.0

* Moved `TableColumn`, `TableStructure`, and the classes based on `Concept` to `lib/Map`. Moved `LegendHelper` to `lib/Models`.
* Added column-specific styling to CSV files, using a new `tableStyle.columns` json parameter. This is an object whose keys are column names or indices, and whose values are objects of column-specific tableStyle parameters. See the CSV column-specific group in `wwwroot/test/init/test-tablestyle.json` for an example. [#1097](https://github.com/TerriaJS/terriajs/issues/1097)
* Added the following column-specific `tableStyle` parameters:
  - `name`: renames the column.
  - `type`: sets the column type; can be one of LON, LAT, ALT, TIME, SCALAR, or ENUM.
  - `format`: sets the column number format, using the format of the [Javascript Intl options parameter](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString), eg. `{"format": {"useGrouping": true, "maximumFractionDigits": 2}}` to add thousands separators to numbers and show only two decimal places. Only the `useGrouping`, `maximumFractionDigits` and `styling: "percent"` options are guaranteed to work in all browsers.
* Added column-specific formatting to the feature info panel for all file types, eg. `"featureInfoTemplate" : {"template": "{{SPEED}} m/s", "formats": {"SPEED": {"maximumFractionDigits": 2}}}`. The formatting options are the same as above.
* Changed the default number format in the Feature Info Panel to not separate thousands with commas.
* Fixed a bug that caused the content on the feature info panel to be rendered as pure HTML instead of as mixed HTML / Markdown.
* Changed the default for `tableStyle.replaceWithZeroValues` to `[]`, ie. nothing.
* Changed the default for `tableStyle.replaceWithNullValues` to `["-", "na", "NA"]`.
* Changed the default for `tableStyle.nullLabel` to '(No value)'.
* Application name and support email can now be set in config.json's "parameters" section as "appName" and "supportEmail".
* Fixed showWarnings in config json not being respected by CSV catalog items.
* Fixed hidden region mapped layers being displayed when variable selection changes.
* Fixed exporting raw data as CSV not escaping commas in the data itself.

### 2.0.1

* Fixed a bug that caused the last selected ABS concept not to appear in the feature info panel.

### 2.0.0

* The following previously-deprecated functionality was removed in this version:
  - `ArcGisMapServerCatalogGroup`
  - `CatalogItemControl`
  - `CatalogItemDownloadControl`
  - Calling `BrandBarViewModel.create` with more than one parameter.
  - `CatalogMemberControl.leftSideItemControls`
  - `CatalogMemberControl.rightSideItemControls`
  - `DataCatalogTabViewModel.getRightSideItemControls`
  - `DataCatalogTabViewModel.getLeftSideItemControls`
  - `registerCatalogItemControls`
  - `AusGlobeViewer`
* Streamlined CSV handling framework. Breaking changes include the APIs of (not including those which begin with `_`):
  - `CsvCatalogItem`: `rowProperties`, `rowPropertiesByCode`, `dynamicUpdate` have been removed.
  - `AbsIttCatalogItem`: Completely rewritten. The `dataSetID` json parameter has been deprecated in favor of `datasetId` (different capitalization).
  - For the 2011 Australian Census data, requires `sa4_code_2011` to appear as an alias in `regionMapping.json` (it was previously missing in NationalMap).
  - `TableDataSource`: Completely rewritten and moved from `Map` to `Models` directory. Handles csvs with latitude & longitude columns.
  - `RegionMapping`: Used instead of TableDataSource for region-mapped csvs.
  - `DataTable` and `DataVariable` have been replaced with new classes, `TableStructure` and `TableColumn`.
  - `RegionProvider`: `loadRegionsFromWfs`, `processRegionIds`, `applyReplacements`, `findRegionIndex` have been made internal functions.
  - `RegionProviderList`: `chooseRegionProvider` has been changed and renamed `getRegionDetails `.
  - `ColorMap`: `fromArray` and `fromString` have been removed, with the constructor taking on that functionality.
  - `LegendUrl` has been moved to the `Map` directory.
  - `TableStyle`: `loadColorMap` and `chooseColorMap` have been removed. Moved from `Map` to `Models` directory.
  - `FeatureInfoPanelSectionViewModel`: its constructor now takes a `FeatureInfoPanelViewModel` as its first argument, instead of `Terria`.
  - `Models/ModelError` has been replaced with `Core/TerriaError`.
* Removed blank feature info sections for uncoloured regions of region-mapped CSVs.
* Recognises the CSV datetime formats: YYYY, YYYY-MM and YYYY-MM-DD HH:MM(:SS).
* Introduced five new json tableStyle parameters:
  - `replaceWithZeroValues`: Defaults to `[null, "-"]`. These values are coloured as if they were zero if they appear in a list with numbers. `null` catches missing values.
  - `replaceWithNullValues`: Defaults to `["na", "NA"]`. These values are coloured as if they were null if they appear in a list with numbers.
  - `nullColor`: A css string. Defaults to black. This colour is used to display null values. It is also used to colour points when no variable is selected.
  - `nullLabel`: A string used to label null or blank values in the legend. Defaults to ''.
  - `timeColumn`: Provide the name or index (starting at 0) of a csv column, if any. Defaults to the first time column found, if any. Use `null` to explicitly disregard all time columns.
* Removed variables consisting only of html tags from the Now Viewing panel.
* Added support for the csv datetime formats: YYYY, YYYY-MM and YYYY-MM-DD HH:MM(:SS).
* Improved formatting of datetimes from csv files in the feature info panel.
* Removed variables consisting only of html tags from the Now Viewing panel.
* Improved handling of rows with missing dates in csv time columns.
* Introduced four new json tableStyle parameters:
  - `replaceWithZeroValues`: Defaults to `[null, '-']`. These values are coloured as if they were zero if they appear in a csv column with numbers. `null` catches missing values. These rows are ignored if they appear in a csv time column.
  - `replaceWithNullValues`: Defaults to `['na', 'NA']`. These values are coloured as if they were null if they appear in a csv column with numbers. These rows are ignored if they appear in a csv time column.
  - `nullColor`: A css string. Defaults to a dark blue. This colour is used to display null values (but it does not appear on the legend). It is also used to colour points when no variable is selected.
  - `timeColumn`: Provide the name or index (starting at 0) of a csv column, if any. Defaults to the first time column found, if any. Use `null` to explicitly disregard all time columns.
* Added id matching for catalog members:
* Improved formatting of datetimes from csv files in the feature info panel.
* Removed variables consisting only of HTML tags from the Now Viewing panel.
* Added ID matching for catalog members:
  - An `id` field can now be set in JSON for catalog members
  - When sharing an enabled catalog item via a share link, the share link will reference the catalog item's ID
    rather than its name as is done currently.
  - The ID of an item should be accessed via `uniqueId` - if a catalog member doesn't have an ID set, this returns a
    default value of the item's name plus the ID of its parent. This means that if all the ancestors of a catalog
    member have no ID set, its ID will be its full path in the catalog.
  - This means that if an item is renamed or moved, share links that reference it will still work.
  - A `shareKeys` property can be also be set that contains an array of all ids that should lead to this item. This means
    that a share link for an item that didn't previously have an ID set can still be used if it's moved, as long as it
    has its old default ID set in `shareKeys`
  - Old share links will still work as long as the items they lead to aren't renamed or moved.
  - Refactor of JSON serialization - now rather than passing a number of flags that determine what should and shouldn't be
    serialized, an `itemFilter` and `propertyFilter` are passed in options. These are usually composed of multiple filters,
    combined using `combineFilters`.
  - An index of all items currently in the catalog against all of that item's shareKeys is now maintained in `Catalog`
    and can be used for O(1) lookups of any item regardless of its location.
  - CatalogMembers now contain a reference to their parent CatalogGroup - this means that the catalog tree can now be
    traversed in both directions.
  - When serializing user-added items in the catalog, the children of `CatalogGroup`s with the `url` property set are
    not serialized. Settings like `opacity` for their descendants that need to be preserved are serialized separately.
* Generated legends now use SVG (vector) format, which look better on high resolution devices.
* Created new Legend class, making it easy to generate client-side legends for different kinds of data.
* Generate client-side legends for ArcGIS MapServer catalog items, by fetching JSON file, instead of just providing link to external page.
* Fix Leaflet feature selection when zoomed out enough that the world is repeated.
* Improved handling of lat/lon CSV files with missing latitude or longitude values.
* Fixed a bug that prevented `SocrataCataloGroup` from working in Internet Explorer 9.
* Added `CkanCatalogItem`, which can be used to reference a particular resource of any compatible type on a CKAN server.
* Fixed a bug that caused the Now Viewing tab to display incorrectly in Internet Explorer 11 when switching directly to it from the Data Catalogue tab.

### 1.0.54

* Fixed a bug in `AbsIttCatalogItem` that caused no legend to be displayed.

### 1.0.53

* Improved compatibility with Internet Explorer 9.
* Made `CswCatalogGroup` able to find geospatial datasets on more CSW servers.
* Allow WMS parameters to be specified in json in uppercase (eg. STYLES).

### 1.0.52

* Added `MapBoxMapCatalogItem`, which is especially useful for base maps. A valid access token must be provided.
* Added a `getContainer()` method to Terria's `currentViewer`.
* Dramatically improved the performance of region mapping.
* Introduced new quantisation (color binning) methods to dramatically improve the display of choropleths (numerical quantities displayed as colors) for CSV files, instead of always using linear. Four values for `colorBinMethod` are supported:
  * "auto" (default), usually means "ckmeans"
  * "ckmeans": use "CK means" method, an improved version of Jenks Even Breaks to form clusters of values that are as distinct as possible.
  * "quantile": use quantiles, evenly distributing values between bins
  * "none": use the previous linear color mapping method.
* The default style for CSV files is now 7 color bins with CK means method.
* Added support for color palettes from Color Brewer (colorbrewer2.org). Within `tableStyle`, use a value like `"colorPalette": "10-class BrBG"`.
* Improved the display of legends for CSV files, accordingly.
* URLs for legends are now encapsulated in a `LegendUrl` model, which accepts a mime type that will affect how the
  legend is rendered in the sidebar.
* Added support for the Socrata "new backend" with GeoJSON download to `SocrataCatalogGroup`.
* Moved URL config parameters to config.json, with sensible defaults. Specifically:
  *   regionMappingDefinitionsUrl: 'data/regionMapping.json',
  *   conversionServiceBaseUrl: '/convert/',
  *   proj4ServiceBaseUrl: '/proj4/',
  *   corsProxyBaseUrl: '/proxy/'
* Deprecated terria.regionMappingDefinitionsUrl (set it in config.json or leave it as default).

### 1.0.51

* Fixed a typo that prevented clearing the search query
* Added support for Nominatim search API hosted by OpenStreetMap (http://wiki.openstreetmap.org/wiki/Nominatim) with `NominatimSearchProviderViewModel`. This works by merging to 2 queries : one with the bounding parameter for the nearest results, and the other without the bounding parameter. The `countryCodes` property can be set to limit the result to a set of specific countries.
* Added `MapProgressBarViewModel`.  When added to the user interface with `MapProgressBarViewModel.create`, it shows a bar at the top of the map window indicating tile load progress.
* We no longer show the entity's ID (which is usually a meaningless GUID) on the feature info panel when the feature does not have a name.  Instead, we leave the area blank.
* Fixed a bug with time-dynamic imagery layers that caused features to be picked from the next time to be displayed, in addition to the current one.
* Replace `.` and `#` with `_` in property names meant to be used with `featureInfoTemplate`, so that these properties can be accessed by the [mustache](https://mustache.github.io/) templating engine.
* Added support for time-varying properties (e.g. from a CZML file) on the feature info panel.
* `Cesium.zoomTo` now takes the terrain height into account when zooming to a rectangle.

### 1.0.50

* Put a white background behind legend images to fix legend images with transparent background being nearly invisible.
* Search entries are no longer duplicated for catalog items that appear in multiple places in the Data Catalogue
* Fixed the layer order changing in Cesium when a CSV variable is chosen.
* Layer name is now shown in the catalog item info panel for ESRI ArcGIS MapServer layers.
* Retrieve WFS or WCS URL associated with WMS data sources using DescribeLayer if no dataUrl is present.
* Downgrade Leaflet to 0.7.3 to fix specific feature clicking problems with 2D maps.
* Use `PolylineGraphics` instead of `PolygonGraphics` for unfilled polygons with an outline width greater than 1.  This works around the fact that Cesium does not support polygons with outline width great than 1 on Windows due to a WebGL limitation.
* Sorted ABS age variables numerically, not alphabetically.
* Removed extra space at the bottom of base map buttons.
* Share links now remember the currently active tab in the `ExplorerPanelViewModel`.
* Fixed a bug that prevented region mapping from working over HTTPS.
* The proxy is now used to avoid a mixed content warning when accessing an HTTP dataset from an HTTPS deployment of TerriaJS.
* Added `CameraView.fromLookAt` and `CameraView.fromPositionHeadingPitchRoll` functions.  These functions can be used to position the camera in new ways.

### 1.0.49

* Fixed a bug that caused poor performance when clicking a point on the map with lots of features and then closing the feature information panel.
* Apply linkify, instead of markdown, to properties shown in the Feature Info Panel.
* Fixed a bug that prevented feature scaling by value.
* Fixed a bug that prevented the csv `displayDuration` from working.
* Fixed a bug that ignored which column of the csv file to show as the legend initially.
* `NowViewingTabViewModel` is now composed of a number of sections.  Each section is given the opportunity to determine whether it applies to each catalog item.  Custom sections may be added by adding them to NowViewingTabViewModel.sections`.
* `CsvCatalogItem` and `AbsIttCatalogItem` now expose a `concepts` property that can be used to adjust the display.
* Added `Terria.cesiumBaseUrl` property.
* The user interface container DOM element may now be provided to `TerriaViewer` by specifying `uiContainer` in its options.  Previously it always used an element named `ui`.
* Legend URLs are now accessed via the proxy, if applicable.
* Fixed a bug that prevented feature scaling by value.
* Added support for [Urthecast](https://www.urthecast.com/) with `UrthecastCatalogGroup`.
* Fixed a bug that caused a `TypeError` on load when the share URL included enabled datasets with an order different from their order in the catalog.
* Improved the message that is shown to the user when their browser supports WebGL but it has a "major performance caveat".
* Fixed a bug that could cause an exception in some browsers (Internet Explorer, Safari) when loading a GeoJSON with embedded styles.
* Fixed a bug with Leaflet 2D map where clicks on animation controls or timeline would also register on the map underneath causing undesired feature selection and, when double clicked, zooming (also removed an old hack that disabled dragging while using the timeline slider)
* Changed Australian Topography base map server and updated the associated thumbnail.
* Added `updateApplicationOnMessageFromParentWindow` function.  After an app calls this function at startup, TerriaJS can be controlled by its parent window when embedded in an `iframe` by messages sent with `window.postMessage`.

### 1.0.48

* Added the ability to disable feature picking for `ArcGisMapServerCatalogItem`.
* Disabled feature picking for the Australian Topography and Australian Hydrography base layers created by `createAustraliaBaseMapOptions`.

### 1.0.47

* Make it possible to disable CSV region mapping warnings with the `showWarnings` init parameter.
* The `name` of a feature from a CSV file is now taken from a `name` or `title` column, if it exists.  Previously the name was always "Site Data".
* Fixed a bug that caused time-dynamic WMS layers with just one time to not be displayed.
* Underscores are now replaced with spaces in the feature info panel for `GeoJsonCatalogItem`.
* Added Proj4 projections to the location bar. Clicking on the bar switches between lats/longs and projected coordinates. To enable this, set `useProjection` to `true`
* Show information for all WMS features when a location is clicked.
* Fixed a bug that caused an exception when running inside an `<iframe>` and the user's browser blocked 3rd-party cookies.
* HTML and Markdown text in catalog item metadata, feature information, etc. is now formatted in a more typical way.  For example, text inside `<h1>` now looks like a heading.  Previously, most HTML styling was stripped out.
* Supports FeatureInfoTemplates on all catalog item types (previously only available on ImageryLayers).
* Apply markdown to properties shown in the Feature Info Panel.
* Add `includeCzml` option to CkanCatalogGroup.
* Fixed a bug that caused `WebMapServiceCatalogItem` to incorrectly populate the catalog item's metadata with data from GetCapabilities when another layer had a `Title` with the same value as the expected layer's `Name`.
* Update the default Australian topography basemap to Geoscience Australia's new worldwide layer (http://www.ga.gov.au/gisimg/rest/services/topography/National_Map_Colour_Basemap/MapServer)
* Allow color maps in CSV catalog items to be expressed as strings: colorMapString: "red-white-blue".
* Updated to [Cesium](http://cesiumjs.org) 1.15.  Significant changes relevant to TerriaJS users include:
  * Added support for the [glTF 1.0](https://github.com/KhronosGroup/glTF/blob/master/specification/README.md) draft specification.
  * Added support for the glTF extensions [KHR_binary_glTF](https://github.com/KhronosGroup/glTF/tree/master/extensions/Khronos/KHR_binary_glTF) and [KHR_materials_common](https://github.com/KhronosGroup/glTF/tree/KHR_materials_common/extensions/Khronos/KHR_materials_common).
  * `ImageryLayerFeatureInfo` now has an `imageryLayer` property, indicating the layer that contains the feature.
  * Make KML invalid coordinate processing match Google Earth behavior. [#3124](https://github.com/AnalyticalGraphicsInc/cesium/pull/3124)

### 1.0.46

* Fixed an incorrect require (`URIjs` instead of `urijs`).

### 1.0.45

* Major refactor of `CsvCatalogItem`, splitting region-mapping functionality out into `RegionProvider` and `RegionProviderList`. Dozens of new test cases. In the process, fixed a number of bugs and added new features including:
  * Regions can be matched using regular expressions, enabling matching of messy fields like local government names ("Baw Baw", "Baw Baw Shire", "Baw Baw (S)", "Shire of Baw Baw" etc).
  * Regions can be matched using a second field for disambiguation (eg, "Campbelltown" + "SA")
  * Drag-and-dropped datasets with a time column behave much better: rather than a fixed time being allocated to each row, each row occupies all the time up until the next row is shown.
  * Enumerated fields are colour coded in lat-long files, consist with region-mapped files.
  * Feedback is now provided after region mapping, showing which regions failed to match, and which matched more than once.
  * Bug: Fields with names starting with 'lon', 'lat' etc were too aggressively matched.
  * Bug: Numeric codes beginning with zeros (eg, certain NT 08xx postcodes) were treated as numbers and failed to match.
  * Bug: Fields with names that could be interpreted as regions weren't available as data variables.
* Avoid mixed content warnings when using the CartoDB basemaps.
* Allow Composite catalog items
* Handle WMS time interval specifications (time/time and time/time/periodicity)
* Moved `url` property to base CatalogItem base class.  Previously it was defined separately on most derived catalog items.
* Most catalog items now automatically expose a `dataUrl` that is the same as their `url`.
* Added custom definable controls to `CatalogMember`s.
  * To define a control, subclass `CatalogMemberControl` and register the control in `ViewModels/registerCatalogMemberControl` with a unique control name, control class and required property name.
  * If a `CatalogMember` has a property with the required property name either directly on the member or in its `customProperties` object, the control will appear in the catalog with the member and will fire the `activate` function when clicked.
  * Controls can be registered to appear on both the left and right side using `registerLeftSideControl` and `registerRightSideControl` respectively.
  * An example can be seen in the `CatalogMemberDownloadControl`
  * Currently top level members do not show controls.
* The `LocationBarViewModel` now shows the latitude and longitude coordinates of the mouse cursor in 2D as well as 3D.
* The `LocationBarViewModel` no longer displays a misleading elevation of 0m when in "3D Smooth" mode.
* Added `@menu-bar-right-offset` LESS parameter to control the right position of the menu bar.
* Added `forceProxy` flag to all catalog members to indicate that an individual item should use the proxy regardless of whether the domain is in the list of domains to proxy.
* Allow a single layer of an ArcGIS MapServer to be added through the "Add Data" interface.
* Added `WfsFeaturesCatalogGroup`.  This group is populated with a catalog item for each feature queried from a WFS server.
* The Feature Info panel now shows all selected features in an accordion control.  Previously it only showed the first one.
* Added `featureInfoTemplate` property to `CatalogItem`.  It is used to provide a custom Markdown or HTML template to display when a feature in the catalog item is clicked.  The template is parameterized on the properties of the feature.
* Updated to [Cesium](http://cesiumjs.org) 1.14.  Significant changes relevant to TerriaJS users include:
  * Fixed issues causing the terrain and sky to disappear when the camera is near the surface. [#2415](https://github.com/AnalyticalGraphicsInc/cesium/issues/2415) and [#2271](https://github.com/AnalyticalGraphicsInc/cesium/issues/2271)
  * Fixed issues causing the terrain and sky to disappear when the camera is near the surface. [#2415](https://github.com/AnalyticalGraphicsInc/cesium/issues/2415) and [#2271](https://github.com/AnalyticalGraphicsInc/cesium/issues/2271)
  * Provided a workaround for Safari 9 where WebGL constants can't be accessed through `WebGLRenderingContext`. Now constants are hard-coded in `WebGLConstants`. [#2989](https://github.com/AnalyticalGraphicsInc/cesium/issues/2989)
  * Added a workaround for Chrome 45, where the first character in a label with a small font size would not appear. [#3011](https://github.com/AnalyticalGraphicsInc/cesium/pull/3011)
  * Fixed an issue with drill picking at low frame rates that would cause a crash. [#3010](https://github.com/AnalyticalGraphicsInc/cesium/pull/3010)

### 1.0.44

* Fixed a bug that could cause timeseries animation to "jump" when resuming play after it was paused.
* Make it possible for catalog item initialMessage to require confirmation, and to be shown every time.
* When catalog items are enabled, the checkbox now animates to indicate that loading is in progress.
* Add `mode=preview` option in the hash portion of the URL.  When present, it is assumed that TerriaJS is being used as a previewer and the "small screen warning" will not be shown.
* Added `maximumLeafletZoomLevel` constructor option to `TerriaViewer`, which can be used to force Leaflet to allow zooming closer than its default of level 18.
* Added the `attribution` property to catalog items.  The attribution is displayed on the map when the catalog item is enabled.
* Remove an unnecessary instance of the Cesium InfoBox class when viewing in 2D
* Fixed a bug that prevented `AbsIttCatalogGroup` from successfully loading its list of catalog items.
* Allow missing URLs on embedded data (eg. embedded czml data)
* Fixed a bug loading URLs for ArcGIS services names that start with a number.
* Updated to [Cesium](http://cesiumjs.org) 1.13.  Significant changes relevant to TerriaJS users include:
  * The default `CTRL + Left Click Drag` mouse behavior is now duplicated for `CTRL + Right Click Drag` for better compatibility with Firefox on Mac OS [#2913](https://github.com/AnalyticalGraphicsInc/cesium/pull/2913).
  * Fixed an issue where non-feature nodes prevented KML documents from loading. [#2945](https://github.com/AnalyticalGraphicsInc/cesium/pull/2945)

### 1.0.43

* Fixed a bug that prevent the opened/closed state of groups from being preserved when sharing.

### 1.0.42

* Added a `cacheDuration` property to all catalog items.  The new property is used to specify, using Varnish-like notation (e.g. '1d', '10000s') the default length of time to cache URLs related to the catalog item.
* Fix bug when generating share URLs containing CSV items.
* Improve wording about downloading data from non-GeoJSON-supporting WFS servers.

### 1.0.41

* Improvements to `AbsIttCatalogItem` caching from the Tools menu.

### 1.0.40

* `ArcGisMapServerCatalogItem` now shows "NoData" tiles by default even after showing the popup message saying that max zoom is exceeded.  This can be disabled by setting its `showTilesAfterMessage` property to false.

### 1.0.39

* Fixed a race condition in `AbsIttCatalogItem` that could cause the legend and map to show different state than the Now Viewing UI suggested.
* Fixed a bug where an ABS concept with a comma in its name (e.g. "South Eastern Europe,nfd(c)" in Country of Birth) would cause values for concept that follow to be misappropriated to the wrong concepts.

### 1.0.38

* `AbsIttCatalogItem` now allows the region type to be set on demand rather than only at load time.
* `CsvCatalogItem` can now have no display variable selected, in which case all points are the same color.

### 1.0.37

* Added `CswCatalogGroup` for populating a catalog by querying an OGC CSW service.
* Added `CatalogMember.infoSectionOrder` property, to allow the order of info sections to be configured per catalog item when necessary.
* Fixed a bug that prevented WMTS layers with a single `TileMatrixSetLink` from working correctly.
* Added support for WMTS layers that can only provide tiles in JPEG format.
* Fixed testing and caching of ArcGis layers from tools and added More information option for imagery layers.
* TerriaJS no longer requires Google Analytics.  If a global `ga` function exists, it is used just as before.  Otherwise, events are, by default, logged to the console.
* The default event analytics behavior can be specified by passing an instance of `ConsoleAnalytics` or `GoogleAnalytics` to the `Terria` constructor.  The API key to use with `GoogleAnalytics` can be specified explicitly to its constructor, or it can be specified in the `parameter.googleAnalyticsKey` property in `config.json`.
* Made polygons drastically faster in 2D.
* TerriaJS now shortens share URLs by default when a URL shortener is available.
* Added Google Analytics reporting of the application URL.  This is useful for tracking use of share URLs.
* Added the ability to specify a specific dynamic layer of an ArcGIS Server using just a URL.

### 1.0.36

* Calculate extent of TopoJSON files so that the viewer correctly pans+zooms when a TopoJSON file is loaded.
* Fixed a bug that caused the `Terria#clock` to keep ticking (and therefore using CPU / battery) once started even after selecting a non-time-dynamic dataset.
* Fixed a bug that caused the popup message to appear twice when a dataset failed to load.
* Added layer information to the Info popup for WMS datasets.
* Added ability to filter catalog search results by:
  * type: `is:wms`, `-is:esri-mapserver`. A result must match any 'is:' and no '-is:'.
  * url: `url:vic.gov.au`, `-url:nicta.com.au`. A result must match any 'url:', and no '-url:'.
* Added ability to control the number of catalog search results: `show:20`, `show:all`

### 1.0.35

* Polygons from GeoJSON datasets are now filled.
* Left-aligned feature info table column and added some space between columns.
* Added `EarthGravityModel1996`.
* Extended `LocationBarViewModel` to show heights relative to a geoid / mean sea level model.  By default, EGM96 is used.
* Added support for styling GeoJSON files, either in catalog (add .style{} object) or embedded directly in the file following the [SimpleStyle spec](https://github.com/mapbox/simplestyle-spec).
* Fixed a bug that caused the 3D view to use significant CPU time even when idle.
* Added CartoDB's Positron and Dark Matter base maps to `createGlobalBaseMapOptions`.
* Added support for subdomains to `OpenStreetMapCatalogItem`.

### 1.0.34

* Fixed a bug that prevented catalog items inside groups on the Search tab from being enabled.
* Added `PopupMessageConfirmationViewModel`. It prevents the Popup from being closed unless the confirm button is pressed. Can also optionally have a deny button with a custom action.
* Added support for discovering GeoJSON datasets from CKAN.
* Added support for zipped GeoJSON files.
* Made `KmlCatalogItem` use the proxy when required.
* Made `FeatureInfoPanelViewModel` use the white panel background in more cases.
* Significantly improved the experience on devices with small screens, such as phones.
* Fixed a bug that caused only the portion of a CKAN group name before the first comma to be used.

### 1.0.33

* Added the `legendUrls` property to allow a catalog item to optionally have multiple legend images.
* Added a popup message when zooming in to the "No Data" scales of an `ArcGisMapServerCatalogItem`.
* Added `CatalogGroup.sortFunction` property to allow custom sorting of catalog items within a group.
* Added `ImageryLayerCatalogItem.treat403AsError` property.
* Added a title text when hovering over the label of an enabled catalog item.  The title text informs the user that clicking will zoom to the item.
* Added `createBingBaseMapOptions` function.
* Added an option to `KnockoutMarkdownBinding` to optionally skip HTML sanitization and therefore to allow unsafe HTML.
* Upgraded to Cesium 1.11.
* `CatalogItem.zoomTo` can now zoom to much smaller bounding box rectangles.

### 1.0.32

* Fixed CKAN resource format matching for KML, CSV, and Esri REST.

### 1.0.31

* Added support for optionally generating shorter URLs when sharing by using the Google URL shortening service.

### 1.0.30

* `WebMapServiceCatalogItem` and `ArcGisMapServerCatalogItem` now augment directly-specified metadata with metadata queried from the server.
* "Data Details" and "Service Details" on the catalog item info panel are now collapsed by default.  This improves the performance of the panel and hides some overly technical details.
* `ArcGisMapServerCatalogItem.layers` can now specify layer names in addition to layer IDs.  Layer names are matched in a case-insensitive manner and only if a direct ID match is not found.
* `itemProperties` are now applied through the normal JSON loading mechanism, so properties that are represented differently in code and in JSON will now work as well.
* Added support for `csv-geo-*` (e.g. csv-geo-au) to `CkanCatalogGroup`.
* The format name used in CKAN can now be specified to `CkanCatalogGroup` using the `wmsResourceFormat`, `kmlResourceFormat`, `csvResourceFormat`, and `esriMapServerResourceFormat` properties.  These properties are all regular expressions.  When the format of a CKAN resource returned from `package_search` matches one of these regular expressions, it is treated as that type within TerriaJS.
* `CkanCatalogGroup` now fills the `dataUrl` property of created items by pointing to the dataset's page on CKAN.
* The catalog item information panel now displays `info` sections in a consistent order.  The order can be overridden by setting `CatalogItemInfoViewModel.infoSectionOrder`.
* An empty `description` or `info` section is no longer shown on the catalog item information panel.  This can be used to remove sections that would otherwise be populated from dataset metadata.

### 1.0.29

* Add support for loading init files via the proxy when necessary.
* Switched to using the updated URL for STK World Terrain, `//assets.agi.com/stk-terrain/v1/tilesets/world/tiles`.

### 1.0.28

* Fixed a bug that prevented links to non-image (e.g. ArcGIS Map Server) legends from appearing on the Now Viewing panel.

### 1.0.27

* Use terriajs-cesium 1.10.7, fixing a module load problem in really old browers like IE8.

### 1.0.25

* Fixed incorrect date formatting in the timeline and animation controls on Internet Explorer 9.
* Add support for CSV files with longitude and latitude columns but no numeric value column.  Such datasets are visualized as points with a default color and do not have a legend.
* The Feature Information popup is now automatically closed when the user changes the `AbsIttCatalogItem` filter.

### 1.0.24

* Deprecated:
  * Renamed `AusGlobeViewer` to `TerriaViewer`.  `AusGlobeViewer` will continue to work until 2.0 but using it will print a deprecation warning to the browser console.
  * `BrandBarViewModel.create` now takes a single `options` parameter.  The container element, which used to be specified as the first parameter, should now be specified as the `container` property of the `options` parameter.  The old function signature will continue to work until 2.0 but using it will print a deprecation warning to the browser console.
* `WebMapServiceCatalogItem` now determines its rectangle from the GetCapabilities metadata even when configured to use multiple WMS layers.
* Added the ability to specify the terrain URL or the `TerrainProvider` to use in the 3D view when constructing `TerriaViewer`.
* `AbsIttCatalogItem` styles can now be set using the `tableStyle` property, much like `CsvCatalogItem`.
* Improved `AbsIttCatalogItem`'s tolerance of errors from the server.
* `NavigationViewModel` can now be constructed with a list of `controls` to include, instead of the standard `ZoomInNavigationControl`, `ResetViewNavigationControl`, and `ZoomOutNavigationControl`.
* Fixed a bug that caused the brand bar to slide away with the explorer panel on Internet Explorer 9.

### 1.0.23

* Fixed a bug that prevented features from being pickable from ABS datasets on the 2D map.
* Fixed a bug that caused the Explorer Panel tabs to be missing or misaligned in Firefox.

### 1.0.22

* Changed to use JPEG instead of PNG format for the Natural Earth II basemap.  This makes the tile download substantially smaller.

### 1.0.21

* Added an `itemProperties` property to `AbsIttCatalogGroup`.
* Added a `nowViewingMessage` property to `CatalogItem`.  This message is shown by the `NowViewingAttentionGrabberViewModel` when the item is enabled.  Each unique message is shown only once.

### 1.0.20

* Added the ability to specify SVG icons on Explorer Panel tabs.
* Added an icon to the Search tab.
* Added support for accessing Australian Bureau of Statistics data via the ABS-ITT API, using `AbsIttCatalogGroup` and `AbsIttCatalogItem`.
* The Now Viewing panel now contains controls for selecting which column to show in CSV datasets.

### 1.0.19

* Added `NowViewingAttentionGrabberViewModel`.  It calls attention the Now Viewing tab the first time a catalog item is enabled.
* Added `isHidden` property to catalog items and groups.  Hidden items and groups do not show up in the catalog or in search results.

### 1.0.18

* Added `featureInfoFields` property to `CsvCatalogItem.tableStyle`.  It allows setting which fields to show in the Feature Info popup, and the name to use for each.
* Added `OpenStreetMapCatalogItem` for connecting to tile servers using the OpenStreetMap tiling scheme.
* Added `CkanCatalogGroup.allowEntireWmsServers` property.  When set and the group discovers a WMS resource without a layer parameter, it adds a catalog item for the entire server instead of ignoring the resource.
* Added `WebMapTileServiceCatalogGroup` and `WebMapTileServiceCatalogItem` for accessing WMTS servers.
* Handle the case of an `ArcGisMapServerCatalogItem` with an advertised extent that is outside the valid range.
* We now pass ArcGIS MapServer metadata, when it's available, through to Cesium's `ArcGisMapServerImageryProvider` so that it doesn't need to re-request the metadata.
* Changed the style of the Menu Bar to have visually-separate menu items.
* Added support for SVG menu item icons to `MenuBarViewModel`.
* Improved popup message box sizing.

### 1.0.17

* Upgraded to TerriajS Cesium 1.10.2.
* Added `ImageryLayerCatalogItem.isRequiredForRendering`.  This is set to false by default and to true for base maps.  Slow datasets with `isRequiredForRendering=false` are less likely to prevent other datasets from appearing in the 3D view.
* The "Dataset Testing" functionality (on the hidden Tools menu accessible by adding `#tools=1` to the URL) now gives up tile requests and considers them failed after two seconds.  It also outputs some JSON that can be used as the `blacklist` property to blacklist all of the datasets that timed out.
* Added a feature to count the total number of datasets from the hidden Tools menu.
* Fixed a bug that caused the 2D / 3D buttons the Maps menu to get out of sync with the actual state of the map after switching automatically to 2D due to a performance problem.

### 1.0.16

* Deprecated:
  * `ArcGisMapServerCatalogGroup` has been deprecated.  Please use `ArcGisCatalogGroup` instead.
* Replaced Cesium animation controller with TerriaJS animation controller.
* Replaced Cesium Viewer widget with the CesiumWidget when running Cesium.
* Added the ability to turn a complete ArcGIS Server, or individual folders within it, into a catalog group using `ArcGisCatalogGroup`.

### 1.0.15

* Fix imagery attribution on the 2D map.

### 1.0.14

* Fixed share URL generation when the application is not running at the root directory of its web server.
* Fixed a bug that caused Internet Explorer 8 users to see a blank page instead of a message saying their browser is incompatible.

### 1.0.13

* Breaking changes:
  * Added a required `@brand-bar-height` property.
* `ExplorerPanelViewModel` can now be created with `isOpen` initially set to false.
* TerriaJS now raises an error and hides the dataset when asked to show an `ImageryLayerCatalogItem` in Leaflet and that catalog item does not use the Web Mercator (EPSG:3857) projection.  Previously, the dataset would silently fail to display.
* Improved error handling in `CzmlCatalogItem`, `GeoJsonCatalogItem`, and `KmlCatalogItem`.
* Made the `clipToRectangle` property available on all `ImageryProvider`-based catalog items, not just `WebMapServiceCatalogItem`.
* Added `CatalogMember.isPromoted` property.  Promoted catalog groups and items are displayed above non-promoted groups and items.
* Add support for ArcGIS MapServer "Raster Layers" in addition to "Feature Layers".

### 1.0.12

* Allow Esri ArcGIS MapServers to be added via the "Add Data" panel.
* Adds `baseMapName` and `viewerMode` fields to init files and share links. `baseMapName` is any base map name in the map settings panel and `viewerMode` can be set to `'2d'` or `'3d'`.
* Added `tableStyle.legendTicks` property to `CsvCatalogItem`.  When specified, the generated legend will have the specified number of equally-spaced lines with labels in its legend.

### 1.0.11

* Fixed a bug that prevented HTML feature information from showing up with a white background in Internet Explorer 9 and 10.
* Fixed a bug that prevented WMS GetCapabilities properties, such as CRS, from being properly inherited from the root layer.
* Tweaked credit / attribution styling.

### 1.0.10

* Added support for a developer attribution on the map.
* Fixed a bug that could cause results from previous async catalog searches to appear in the search results.

### 1.0.9

* Show Cesium `ImageryProvider` tile credits / attribution in Leaflet when using `CesiumTileLayer`.

### 1.0.8

* `WebMapServiceCatalogGroup` now populates the catalog using the hierarchy of layers returned by the WMS server in GetCapabilities.  To keep the previous behavior, set the `flatten` property to true.
* Potentially breaking changes:
  * The `getFeatureInfoAsGeoJson` and `getFeatureInfoAsXml` properties have been removed.  Use `getFeatureInfoFormats` instead.
* Added support for text/html responses from WMS GetFeatureInfo.
* Make the `FeatureInfoPanelViewModel` use a white background when displaying a complete HTML document.
* `KnockoutMarkdownBinding` no longer tries to interpret complete HTML documents (i.e. those that contain an <html> tag) as Markdown.
* The feature info popup for points loaded from CSV files now shows numeric columns with a missing value as blank instead of as 1e-34.
* `ArcGisMapServerCatalogItem` now offers metadata, used to populate the Data Details and Service Details sections of the catalog item info panel.
* `ArcGisMapServerCatalogGroup` now populates a "Service Description" and a "Data Description" info section for each catalog item from the MapServer's metadata.
* The `metadataUrl` is now populated (and shown) from the regular MapServer URL.
* Added 'keepOnTop' flag support for imageryLayers in init file to allow a layer to serve as a mask.
* Added 'keepOnTop' support to region mapping to allow arbitrary masks based on supported regions.
* Checkboxes in the Data Catalogue and Search tabs now have a larger clickable area.

### 1.0.7

* `CatalogItemNameSearchProviderViewModel` now asynchronously loads groups so items in unloaded groups can be found, too.
* Do not automatically fly to the first location when pressing Enter in the Search input box.
* Changed `ArcGisMapServerCatalogItem` to interpret a `maxScale` of 0 from an ArcGIS MapServer as "not specified".
* Added an `itemProperties` property to `ArcGisMapServerCatalogGroup`, allowing properties of auto-discovered layers to be specified explicitly.
* Added `validDropElements`, `validDropClasses`, `invalidDropElements`, and `invalidDropClasses` properties to `DragDropViewModel` for finer control over where dropping is allowed.
* Arbitrary parameters can now be specified in `config.json` by adding them to the `parameters` property.


### 1.0.6

* Added support for region mapping based on region names instead of region numbers (example in `public/test/countries.csv`).
* Added support for time-dynamic region mapping (example in `public/test/droughts.csv`).
* Added the ability to specify CSV styling in the init file (example in `public/init/test.json`).
* Improved the appearance of the legends generated with region mapping.
* Added the ability to region-map countries (example in `public/test/countries.csv`).
* Elminated distracting "jumping" of the selection indicator when picking point features while zoomed in very close to the surface.
* Fixed a bug that caused features to be picked from all layers in an Esri MapServer, instead of just the visible ones.
* Added support for the WMS MinScaleDenominator property and the Esri MapServer maxScale property, preventing layers from disappearing when zoomed in to close to the surface.
* Polygons loaded from KML files are now placed on the terrain surface.
* The 3D viewer now shows Bing Maps imagery unmodified, matching the 2D viewer.  Previously, it applied a gamma correction.
* All catalog items now have an `info` property that allows arbitrary sections to be shown for the item in the info popup.
* `CkanCatalogGroup` now has a `groupBy` property to control whether catalog items are grouped by CKAN group ("group"), CKAN organization ("organization"), or not grouped at all ("none").
* `CkanCatalogGroup` now has a `useResourceName` property to control whether the name of the catalog item is derived from the resource (true), or the dataset itself (false).
* The catalog item info page now renders a much more complete set of Markdown and HTML elements.
