import{Easing,Tween,update}from"@tweenjs/tween.js";letmap:google.maps.Map;constcameraOptions:google.maps.CameraOptions={tilt:0,heading:0,zoom:3,center:{lat:35.6594945,lng:139.6999859},};constmapOptions={...cameraOptions,mapId:"15431d2b469f209e",};functioninitMap():void{map=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,mapOptions);// install Tweenjs with npm i @tweenjs/tween.jsnewTween(cameraOptions)// Create a new tween that modifies 'cameraOptions'..to({tilt:65,heading:90,zoom:18},15000)// Move to destination in 15 second..easing(Easing.Quadratic.Out)// Use an easing function to make the animation smooth..onUpdate(()=>{map.moveCamera(cameraOptions);}).start();// Start the tween immediately.// Setup the animation loop.functionanimate(time:number){requestAnimationFrame(animate);update(time);}requestAnimationFrame(animate);}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
import{Easing,Tween,update}from"@tweenjs/tween.js";letmap;constcameraOptions={tilt:0,heading:0,zoom:3,center:{lat:35.6594945,lng:139.6999859},};constmapOptions={...cameraOptions,mapId:"15431d2b469f209e",};functioninitMap(){map=newgoogle.maps.Map(document.getElementById("map"),mapOptions);// install Tweenjs with npm i @tweenjs/tween.jsnewTween(cameraOptions)// Create a new tween that modifies 'cameraOptions'..to({tilt:65,heading:90,zoom:18},15000)// Move to destination in 15 second..easing(Easing.Quadratic.Out)// Use an easing function to make the animation smooth..onUpdate(()=>{map.moveCamera(cameraOptions);}).start();// Start the tween immediately.// Setup the animation loop.functionanimate(time){requestAnimationFrame(animate);update(time);}requestAnimationFrame(animate);}window.initMap=initMap;
/** 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>
<head>
<title>Move Camera Easing</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="map" class="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.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
defer
></script>
</body>
</html>
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis example demonstrates how to smoothly animate camera movement on a Google Map using Tween.js and \u003ccode\u003emoveCamera\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe animation adjusts the camera's tilt, heading, and zoom level over a 15-second duration with a quadratic easing function for a smooth transition.\u003c/p\u003e\n"],["\u003cp\u003eThe code utilizes an animation loop with \u003ccode\u003erequestAnimationFrame\u003c/code\u003e and Tween.js's \u003ccode\u003eupdate\u003c/code\u003e function to continuously update the camera position.\u003c/p\u003e\n"],["\u003cp\u003eThe sample provides both TypeScript and JavaScript code snippets for implementation.\u003c/p\u003e\n"],["\u003cp\u003eTo run the sample locally, you need Git and Node.js installed, and then follow the provided instructions to clone, install dependencies, and start the application.\u003c/p\u003e\n"]]],["This code utilizes the `tween.js` library to animate a Google Map's camera movement. It initializes a map and defines `cameraOptions`, specifying the initial `tilt`, `heading`, `zoom`, and `center`. A tween is created to modify these options over 15 seconds, smoothly transitioning to a new state using `Quadratic.Out` easing. An animation loop continuously updates the map using `map.moveCamera` with the current `cameraOptions`. CSS sets the map's height. HTML loads the script and map API.\n"],null,["This example uses [tween.js](https://github.com/tweenjs/tween.js/) to\nsmoothly [`moveCamera`](/maps/documentation/javascript/reference/map#Map.moveCamera) in an animation loop. \n\nTypeScript \n\n```typescript\nimport { Easing, Tween, update } from \"@tweenjs/tween.js\";\n\nlet map: google.maps.Map;\n\nconst cameraOptions: google.maps.CameraOptions = {\n tilt: 0,\n heading: 0,\n zoom: 3,\n center: { lat: 35.6594945, lng: 139.6999859 },\n};\n\nconst mapOptions = {\n ...cameraOptions,\n mapId: \"15431d2b469f209e\",\n};\n\nfunction initMap(): void {\n map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n mapOptions\n );\n\n // install Tweenjs with npm i @tweenjs/tween.js\n new Tween(cameraOptions) // Create a new tween that modifies 'cameraOptions'.\n .to({ tilt: 65, heading: 90, zoom: 18 }, 15000) // Move to destination in 15 second.\n .easing(Easing.Quadratic.Out) // Use an easing function to make the animation smooth.\n .onUpdate(() =\u003e {\n map.moveCamera(cameraOptions);\n })\n .start(); // Start the tween immediately.\n\n // Setup the animation loop.\n function animate(time: number) {\n requestAnimationFrame(animate);\n update(time);\n }\n\n requestAnimationFrame(animate);\n}\n\ndeclare global {\n interface Window {\n initMap: () =\u003e void;\n }\n}\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/samples/move-camera-ease/index.ts#L8-L53\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\nimport { Easing, Tween, update } from \"@tweenjs/tween.js\";\nlet map;\nconst cameraOptions = {\n tilt: 0,\n heading: 0,\n zoom: 3,\n center: { lat: 35.6594945, lng: 139.6999859 },\n};\nconst mapOptions = {\n ...cameraOptions,\n mapId: \"15431d2b469f209e\",\n};\n\nfunction initMap() {\n map = new google.maps.Map(document.getElementById(\"map\"), mapOptions);\n // install Tweenjs with npm i @tweenjs/tween.js\n new Tween(cameraOptions) // Create a new tween that modifies 'cameraOptions'.\n .to({ tilt: 65, heading: 90, zoom: 18 }, 15000) // Move to destination in 15 second.\n .easing(Easing.Quadratic.Out) // Use an easing function to make the animation smooth.\n .onUpdate(() =\u003e {\n map.moveCamera(cameraOptions);\n })\n .start(); // Start the tween immediately.\n\n // Setup the animation loop.\n function animate(time) {\n requestAnimationFrame(animate);\n update(time);\n }\n\n requestAnimationFrame(animate);\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/move-camera-ease/docs/index.js#L7-L40\n```\n| **Note:** The JavaScript is compiled from the TypeScript snippet.\n\nCSS \n\n```css\n/* \n * Always set the map height explicitly to define the size of the div element\n * that contains the map. \n */\n#map {\n height: 100%;\n}\n\n/* \n * Optional: Makes the sample page fill the window. \n */\nhtml,\nbody {\n height: 100%;\n margin: 0;\n padding: 0;\n}\nhttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/move-camera-ease/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eMove Camera Easing\u003c/title\u003e\n\n \u003clink rel=\"stylesheet\" type=\"text/css\" href=\"./style.css\" /\u003e\n \u003cscript type=\"module\" src=\"./index.js\"\u003e\u003c/script\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003cdiv id=\"map\" class=\"map\"\u003e\u003c/div\u003e\n\n \u003c!-- \n The `defer` attribute causes the script to execute after the full HTML\n document has been parsed. For non-blocking uses, avoiding race conditions,\n and consistent behavior across browsers, consider loading using Promises. See\n https://developers.google.com/maps/documentation/javascript/load-maps-js-api\n for more information.\n --\u003e\n \u003cscript\n src=\"https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly\"\n defer\n \u003e\u003c/script\u003e\n \u003c/body\u003e\n\u003c/html\u003ehttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/move-camera-ease/docs/index.html#L8-L30\n```\n\nTry Sample \n[Google Cloud Shell](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fgooglemaps%2Fjs-samples&cloudshell_git_branch=sample-move-camera-ease&cloudshell_tutorial=cloud_shell_instructions.md&cloudshell_workspace=.)\n\nClone Sample\n\n\nGit and Node.js are required to run this sample locally. Follow these [instructions](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to install Node.js and NPM. The following commands clone, install dependencies and start the sample application. \n\n git clone -b sample-move-camera-ease https://github.com/googlemaps/js-samples.git\n cd js-samples\n npm i\n npm start\n\n\nOther samples can be tried by switching to any branch beginning with `sample-`\u003cvar translate=\"no\"\u003eSAMPLE_NAME\u003c/var\u003e. \n\n git checkout sample-\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nx\"\u003eSAMPLE_NAME\u003c/span\u003e\u003c/var\u003e\n npm i\n npm start"]]
