# @deck.gl/google-maps Use deck.gl layers as a custom Google Maps overlay. ## Installation ### Include the Standalone Bundle ```html ``` ### Install from NPM ```bash npm install deck.gl # or npm install @deck.gl/core @deck.gl/google-maps ``` ```js import {GoogleMapsOverlay} from '@deck.gl/google-maps'; ``` ## Vector/Raster maps Starting with Google Maps v3.45 there are two modes of rendering [Vector and Raster](https://developers.google.com/maps/documentation/javascript/vector-map). To control which rendering mode is used, you need to configure the Google Map using the [Google Cloud Platform](https://developers.google.com/maps/documentation/javascript/webgl). From v8.6, the `GoogleMapsOverlay` class automatically detects at runtime which rendering type is used. The Vector rendering mode is in general more performant, and the `GoogleMapsOverlay` class offers several features not available when using Raster rendering: - Shared 3D space: objects drawn by the `GoogleMapsOverlay` class appear inside the Google Maps scene, correctly intersecting with 3D buildings and behind the contextual labels drawn by Google Maps - Tilting and rotating the view is supported - Rendering uses the same WebGL2 context as Google Maps, improving performance ## Supported Features and Limitations Supported deck.gl features: - Layers - Effects - Auto-highlighting - Attribute transitions - `onHover` and `onClick` callbacks - Tooltip - Tilting & Rotation (Vector maps only) Not supported features: - Views - Controller - React integration - Gesture event callbacks (e.g. `onDrag*`)