Options
All
  • Public
  • Public/Protected
  • All
Menu

MapOptions object used to define the properties that can be set on a Map.

Hierarchy

Index

Properties

backgroundColor?: null | string

Color 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?: null | LatLng | LatLngLiteral

The initial Map center.

clickableIcons?: null | boolean

When false, map icons are not clickable. A map icon represents a point of interest, also known as a POI.

defaultvalue

true

controlSize?: null | number

Size 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?: null | boolean

Enables/disables all default UI buttons. May be overridden individually. Does not disable the keyboard controls, which are separately controlled by the google.maps.MapOptions.keyboardShortcuts option. Does not disable gesture controls, which are separately controlled by the google.maps.MapOptions.gestureHandling option.

disableDoubleClickZoom?: null | boolean

Enables/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 gestureHandling property, and set it to "none".

draggable?: null | boolean

If false, prevents the map from being dragged. Dragging is enabled by default.

deprecated

Deprecated in 2017. To disable dragging on the map, you can use the gestureHandling property, and set it to "none".

draggableCursor?: null | string

The 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?: null | string

The 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?: null | boolean

The enabled/disabled state of the Fullscreen control.

fullscreenControlOptions?: null | FullscreenControlOptions

The display options for the Fullscreen control.

gestureHandling?: null | string

This setting controls how the API handles gestures on the map. Allowed values:

  • "cooperative": Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map.
    In this mode the map cooperates with the page.
  • "greedy": All touch gestures and scroll events pan or zoom the map.
  • "none": The map cannot be panned or zoomed by user gestures.
  • "auto": (default) Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe.

heading?: null | number

The 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.

isFractionalZoomEnabled?: null | boolean

Whether the map should allow fractional zoom levels. Listen to isfractionalzoomenabled_changed to know when the default has been set.

defaultvalue

true for vector maps and false for raster maps

keyboardShortcuts?: null | boolean

If false, prevents the map from being controlled by the keyboard. Keyboard shortcuts are enabled by default.

mapId?: null | string

The Map ID of the map. This parameter cannot be set or changed after a map is instantiated.

mapTypeControl?: null | boolean

The initial enabled/disabled state of the Map type control.

mapTypeControlOptions?: null | MapTypeControlOptions

The initial display options for the Map type control.

mapTypeId?: null | string

The initial Map mapTypeId. Defaults to ROADMAP.

maxZoom?: null | number

The 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 zoom values are numbers from zero up to the supported maximum zoom level.

minZoom?: null | number

The 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 zoom values are numbers from zero up to the supported maximum zoom level.

noClear?: null | boolean

If true, do not clear the contents of the Map div.

panControl?: null | boolean

The enabled/disabled state of the Pan control.

deprecated

The Pan control is deprecated as of September 2015.

panControlOptions?: null | PanControlOptions

The display options for the Pan control.

deprecated

The Pan control is deprecated as of September 2015.

restriction?: null | MapRestriction

Defines 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?: null | boolean

The enabled/disabled state of the Rotate control.

rotateControlOptions?: null | RotateControlOptions

The display options for the Rotate control.

scaleControl?: null | boolean

The initial enabled/disabled state of the Scale control.

scaleControlOptions?: null | ScaleControlOptions

The initial display options for the Scale control.

scrollwheel?: null | boolean

If 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 gestureHandling property, and set it to either "cooperative" or "none".

streetView?: null | StreetViewPanorama

A 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?: null | boolean

The 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?: null | StreetViewControlOptions

The initial display options for the Street View Pegman control.

styles?: null | MapTypeStyle[]

Styles 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?: null | number

For vector maps, sets the angle of incidence of the map. The allowed values are restricted depending on the zoom level of the map. For raster maps, controls 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?: null | number

The initial Map zoom level. Valid zoom values are numbers from zero up to the supported maximum zoom level. Larger zoom values correspond to a higher resolution.

zoomControl?: null | boolean

The enabled/disabled state of the Zoom control.

zoomControlOptions?: null | ZoomControlOptions

The display options for the Zoom control.

Generated using TypeDoc