Get a Maps Demo Key: Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Tilt and Rotation

Spark icon

Page Summary

This sample demonstrates how to programmatically adjust the tilt and rotation (heading) of a vector map using the Google Maps JavaScript API.
You can control the map's tilt using setTilt() and getTilt(), and the heading using setHeading() and getHeading().
The sample provides interactive buttons to adjust the map's tilt and rotation, allowing users to explore different perspectives.
The code includes examples in both TypeScript and JavaScript, showcasing how to implement this functionality in either language.

You can programmatically adjust tilt and rotation (heading) on a vector map. In this example, we add some buttons to programmatically adjust tilt and heading.

Understand the code

Setting tilt and heading

Call setTilt() to set the tilt angle of the map. Use getTilt() to get the current tilt value.
Call setHeading() to set the heading of the map. Use getHeading() to get the current heading value.

[フレーム]

TypeScript

functioninitMap():void{
constmap=newgoogle.maps.Map(
document.getElementById("map")asHTMLElement,
{
center:{
lat:37.7893719,
lng:-122.3942,
},
zoom:16,
heading:320,
tilt:47.5,
mapId:"90f87356969d889c",
}
);
constbuttons:[string,string,number,google.maps.ControlPosition][]=[
["Rotate Left","rotate",20,google.maps.ControlPosition.LEFT_CENTER],
["Rotate Right","rotate",-20,google.maps.ControlPosition.RIGHT_CENTER],
["Tilt Down","tilt",20,google.maps.ControlPosition.TOP_CENTER],
["Tilt Up","tilt",-20,google.maps.ControlPosition.BOTTOM_CENTER],
];
buttons.forEach(([text,mode,amount,position])=>{
constcontrolDiv=document.createElement("div");
constcontrolUI=document.createElement("button");
controlUI.classList.add("ui-button");
controlUI.innerText=`${text}`;
controlUI.addEventListener("click",()=>{
adjustMap(mode,amount);
});
controlDiv.appendChild(controlUI);
map.controls[position].push(controlDiv);
});
constadjustMap=function(mode:string,amount:number){
switch(mode){
case"tilt":
map.setTilt(map.getTilt()!+amount);
break;
case"rotate":
map.setHeading(map.getHeading()!+amount);
break;
default:
break;
}
};
}
declareglobal{
interfaceWindow{
initMap:()=>void;
}
}
window.initMap=initMap;index.ts

JavaScript

functioninitMap(){
constmap=newgoogle.maps.Map(document.getElementById("map"),{
center:{
lat:37.7893719,
lng:-122.3942,
},
zoom:16,
heading:320,
tilt:47.5,
mapId:"90f87356969d889c",
});
constbuttons=[
["Rotate Left","rotate",20,google.maps.ControlPosition.LEFT_CENTER],
["Rotate Right","rotate",-20,google.maps.ControlPosition.RIGHT_CENTER],
["Tilt Down","tilt",20,google.maps.ControlPosition.TOP_CENTER],
["Tilt Up","tilt",-20,google.maps.ControlPosition.BOTTOM_CENTER],
];
buttons.forEach(([text,mode,amount,position])=>{
constcontrolDiv=document.createElement("div");
constcontrolUI=document.createElement("button");
controlUI.classList.add("ui-button");
controlUI.innerText=`${text}`;
controlUI.addEventListener("click",()=>{
adjustMap(mode,amount);
});
controlDiv.appendChild(controlUI);
map.controls[position].push(controlDiv);
});
constadjustMap=function(mode,amount){
switch(mode){
case"tilt":
map.setTilt(map.getTilt()+amount);
break;
case"rotate":
map.setHeading(map.getHeading()+amount);
break;
default:
break;
}
};
}
window.initMap=initMap;index.js

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;
}
.ui-button{
background-color:#fff;
border:0;
border-radius:2px;
box-shadow:01px4px-1pxrgba(0,0,0,0.3);
margin:10px;
padding:00.5em;
font:40018pxRoboto,Arial,sans-serif;
overflow:hidden;
height:40px;
cursor:pointer;
}
.ui-button:hover{
background:rgb(235,235,235);
}
style.css

HTML

<html>
 <head>
 <title>Tilt and Rotation</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.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>index.html

Clone Sample

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

gitclone-bsample-webgl-tilt-rotationhttps://github.com/googlemaps/js-samples.git
cdjs-samples
npmi
npmstart

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

gitcheckoutsample-SAMPLE_NAME
npmi
npmstart