react-map-gl/docs/whats-new.md

react-map-gl v3.2

Under development

• Support for Map Reuse: A new property reuseMaps is provided for applications that create and destroy maps, to help work around a mapbox-gl resource leak issue that can lead to a browser crash in certain situations.
• Viewport transition: feature equivalent to Mapbox's flyTo and easeTo; smooth transition when using keyboard navigation or the NavigationControl.

react-map-gl v3.1

Release date: October 19, 2017

Highlights

• Event handling
  • Support right mouse drag to rotate
  • Support keyboard navigation
  • Allow controls and overlays to block map interactions
• React 16 - react-map-gl is now being tested with React 16, but the React peer dependency requirement is unchanged at >=15.4.x.
• mapbox-gl v0.40.1
• No Token warning: react-map-gl now renders an HTML message if no mapbox token is supplied.

react-map-gl v3.0

Release date: July 27th, 2017

Highlights

• Latest Mapbox GL JS: Bumps Mapbox GL JS to 0.38.
• Multi-Touch Support: Full support for multi-touch gestures such as pinch-to-zoom and rotate.
• New Components: The MapGL component has been split into StaticMap and InteractiveMap (the default). Also, Popup, Marker, NavigationControl have been added to provide better React parity with the Mapbox GL JS API.
• Improved Overlay Components: Supplying viewport props (width height zoom longitude and latitude) are no longer required if you render SVGOverlay, CanvasOverlay or HTMLOverlay as a child of the map. Perspective mode is now supported in all overlays.
• New Props: maxPitch, minPitch, dragPan, doubleClickZoom, touchZoomRotate, scrollZoom are now provided to allow granular control of map interactivity.
• Documentation: Significantly expanded and linked with our other geospatial frameworks.
• Examples: New stand-alone examples to get you started instantly with the new features.
• Event Handling: New event handling architecture that enables full customization of event handling (experimental).

Components

InteractiveMap (New, MapGL replacement)

This is a wrapper on top of StaticMap. It takes all the props of StaticMap and additional ones such as onViewportChange, scrollZoom, dragRotate, etc. to control interactivity on the map. See Source Code for more information.

StaticMap (New)

This is the React wrapper around Mapbox GL JS and takes in viewport properties such as width, height, latitude, longitude. Style diffing and updating logic also live here. See Source Code for more information.

Overlays

• Three overlays (ScatterplotOverlay, DraggablePointsOverlay, ChoroplethOverlay), have been moved out of the library and are now only provided as examples.

Property Changes

• Property Names - some prop names have been modernized, the old ones will still work for now with a warning.
• Internal Properties such as isHovering, isDragging, startDragLngLat have been removed. These were never meant to be useful publicly and have caused confusions in the past.

Utilities

• fitBounds: fitBounds has been moved to another repository and has been rewritten to provide a more logical interface.

For more information, see the Upgrade Guide.

react-map-gl v2.0

Date: Jan 17, 2017

Highlights

• Latest mapbox-gl: Bump mapbox-gl to v0.31.0
• new maxZoom prop - Add maxZoom prop and defaults to 20
• New onLoad prop - Add onLoad event handler
• new onClick prop - Add onClick prop handler (#140)

react-map-gl v1.0

• Perspective Mode - Now supports bearing and pitch properties, per mapbox-gl-js api documentation. These props default to 0 which means that maps will still be rendered in flat/ortographic mode when they are not provided
• Support for ES6 imports - The map overlay components (HTMLOverlay, CanvasOverlay, SVGOverlay etc) previously had to be imported via their relative source paths can now be imported directly using `import {SVGOverlay} from 'react-map-gl'.

react-map-gl v0.6

Initial public version