Cooperative Gesture Handling

This example uses thecooperativevalue for the gestureHandlingoption to control the panning and scrolling behavior of a map when viewed on a mobile device.

Read thedocumentation.

TypeScript

/**
* This sample sets the gesture handling mode to 'cooperative',
* which means that on a mobile device, the user must swipe with one
* finger to scroll the page and two fingers to pan the map.
*/
function initMap(): void {
const center = { lat: -25.363, lng: 131.044 };
const zoom = 4;

new google.maps.Map(document.getElementById( "map" )!, {
zoom,
center,
gestureHandling: "cooperative",
});
}

declare global {
interface Window {
initMap: () => void;
}
}
window.initMap = initMap;

JavaScript

/**
* This sample sets the gesture handling mode to 'cooperative',
* which means that on a mobile device, the user must swipe with one
* finger to scroll the page and two fingers to pan the map.
*/
function initMap() {
const center = { lat: -25.363, lng: 131.044 };
const zoom = 4;

new google.maps.Map(document.getElementById( "map" ), {
zoom,
center,
gestureHandling: "cooperative",
});
}

window.initMap = initMap;

CSS

/*
* Always set the map height explicitly to define the size of the div element
* that contains the map.
*/
#map {
height: 100%;
}

/*
* Optional: Makes the sample page fill the window.
*/
html,
body {
height: 100%;
margin: 0;
padding: 0;
}

HTML

<html>
<head>
<title>Cooperative Gesture Handling</title>

<link rel= "stylesheet" type= "text/css" href= "./style.css" />
<script type= "module" src= "./index.js" ></script>
</head>
<body>
<div id= "map" ></div>

<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google /maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src= "https://maps.googleapis /maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
defer
></script>
</body>
</html>

Try Sample

Clone Sample

Git and Node.js are required to run this sample locally. Follow theseinstructionsto install Node.js and NPM. The following commands clone, install dependencies and start the sample application.

git clone -b sample-interaction-cooperative https://github /googlemaps/js-samples.git
cd js-samples
npm i
npm start

Other samples can be tried by switching to any branch beginning withsample-SAMPLE_NAME.

git checkout sample-SAMPLE_NAME
npm i
npm start