google.maps.MapOptions
interface
MapOptions object used to define the properties that can be set on a Map.
| Properties | |
|---|---|
backgroundColor |
Type:
string optionalColor used for the background of the Map div. This color will be visible when tiles have not yet loaded as the user pans. This option can only be set when the map is initialized. |
center |
Type:
LatLng|LatLngLiteral optionalThe initial Map center. Required. |
clickableIcons |
Type:
boolean optionalWhen false, map icons are not clickable. A map icon represents a point of interest, also known as a POI. By default map icons are clickable. |
controlSize |
Type:
number optionalSize in pixels of the controls appearing on the map. This value must be supplied directly when creating the Map, updating this value later may bring the controls into an undefined state. Only governs the controls made by the Maps API itself. Does not scale developer created custom controls. |
disableDefaultUI |
Type:
boolean optionalEnables/disables all default UI. May be overridden individually. |
disableDoubleClickZoom |
Type:
boolean optionalEnables/disables zoom and center on double click. Enabled by default. Note: This property is not recommended. To disable zooming on double click, you can use the |
draggable |
Type:
boolean optionalIf false, prevents the map from being dragged. Dragging is enabled by default. Note: This property is deprecated. To disable dragging on the map, you can use the |
draggableCursor |
Type:
string optionalThe name or url of the cursor to display when mousing over a draggable map. This property uses the css cursor attribute to change the icon. As with the css property, you must specify at least one fallback cursor that is not a URL. For example: draggableCursor: 'url(http://www.example.com/icon.png), auto;'. |
draggingCursor |
Type:
string optionalThe name or url of the cursor to display when the map is being dragged. This property uses the css cursor attribute to change the icon. As with the css property, you must specify at least one fallback cursor that is not a URL. For example: draggingCursor: 'url(http://www.example.com/icon.png), auto;'. |
fullscreenControl |
Type:
boolean optionalThe enabled/disabled state of the Fullscreen control. |
fullscreenControlOptions |
Type:
FullscreenControlOptions optionalThe display options for the Fullscreen control. |
gestureHandling |
Type:
string optionalThis setting controls how the API handles gestures on the map. Allowed values:
|
heading |
Type:
number optionalThe heading for aerial imagery in degrees measured clockwise from cardinal direction North. Headings are snapped to the nearest available angle for which imagery is available. |
keyboardShortcuts |
Type:
boolean optionalIf false, prevents the map from being controlled by the keyboard. Keyboard shortcuts are enabled by default. |
mapTypeControl |
Type:
boolean optionalThe initial enabled/disabled state of the Map type control. |
mapTypeControlOptions |
Type:
MapTypeControlOptions optionalThe initial display options for the Map type control. |
mapTypeId |
Type:
MapTypeId|string optionalThe initial Map mapTypeId. Defaults to ROADMAP. |
maxZoom |
Type:
number optionalThe maximum zoom level which will be displayed on the map. If omitted, or set to null, the maximum zoom from the current map type is used instead. Valid values: Integers between zero, and up to the supported maximum zoom level. |
minZoom |
Type:
number optionalThe minimum zoom level which will be displayed on the map. If omitted, or set to null, the minimum zoom from the current map type is used instead. Valid values: Integers between zero, and up to the supported maximum zoom level. |
noClear |
Type:
boolean optionalIf true, do not clear the contents of the Map div. |
panControl |
Type:
boolean optionalThe enabled/disabled state of the Pan control. Note: The Pan control is not available in the new set of controls introduced in v3.22 of the Google Maps JavaScript API. While using v3.22 and v3.23, you can choose to use the earlier set of controls rather than the new controls, thus making the Pan control available as part of the old control set. See What's New in the v3.22 Map Controls. |
panControlOptions |
Type:
PanControlOptions optionalThe display options for the Pan control. Note: The Pan control is not available in the new set of controls introduced in v3.22 of the Google Maps JavaScript API. While using v3.22 and v3.23, you can choose to use the earlier set of controls rather than the new controls, thus making the Pan control available as part of the old control set. See What's New in the v3.22 Map Controls. |
restriction |
Type:
MapRestriction optionalDefines a boundary that restricts the area of the map accessible to users. When set, a user can only pan and zoom while the camera view stays inside the limits of the boundary. |
rotateControl |
Type:
boolean optionalThe enabled/disabled state of the Rotate control. |
rotateControlOptions |
Type:
RotateControlOptions optionalThe display options for the Rotate control. |
scaleControl |
Type:
boolean optionalThe initial enabled/disabled state of the Scale control. |
scaleControlOptions |
Type:
ScaleControlOptions optionalThe initial display options for the Scale control. |
scrollwheel |
Type:
boolean optionalIf false, disables zooming on the map using a mouse scroll wheel. The scrollwheel is enabled by default. Note: This property is not recommended. To disable zooming using scrollwheel, you can use the |
streetView |
Type:
StreetViewPanorama optionalA StreetViewPanorama to display when the Street View pegman is dropped on the map. If no panorama is specified, a default StreetViewPanorama will be displayed in the map's div when the pegman is dropped. |
streetViewControl |
Type:
boolean optionalThe initial enabled/disabled state of the Street View Pegman control. This control is part of the default UI, and should be set to false when displaying a map type on which the Street View road overlay should not appear (e.g. a non-Earth map type). |
streetViewControlOptions |
Type:
StreetViewControlOptions optionalThe initial display options for the Street View Pegman control. |
styles |
Type:
Array<MapTypeStyle> optionalStyles to apply to each of the default map types. Note that for satellite/hybrid and terrain modes, these styles will only apply to labels and geometry. |
tilt |
Type:
number optionalControls the automatic switching behavior for the angle of incidence of the map. The only allowed values are 0 and 45. The value 0 causes the map to always use a 0° overhead view regardless of the zoom level and viewport. The value 45 causes the tilt angle to automatically switch to 45 whenever 45° imagery is available for the current zoom level and viewport, and switch back to 0 whenever 45° imagery is not available (this is the default behavior). 45° imagery is only available for satellite and hybrid map types, within some locations, and at some zoom levels. Note: getTilt returns the current tilt angle, not the value specified by this option. Because getTilt and this option refer to different things, do not bind() the tilt property; doing so may yield unpredictable effects. |
zoom |
Type:
number optionalThe initial Map zoom level. Required. Valid values: Integers between zero, and up to the supported maximum zoom level. |
zoomControl |
Type:
boolean optionalThe enabled/disabled state of the Zoom control. |
zoomControlOptions |
Type:
ZoomControlOptions optionalThe display options for the Zoom control. |