Map3DElement([options])

When set, restricts the position of the camera within the specified lat/lng bounds. Note that objects outside the bounds are still rendered. Bounds can restrict both longitude and latitude, or can restrict either latitude or longitude only. For latitude-only bounds use west and east longitudes of -180 and 180, respectively. For longitude-only bounds use north and south latitudes of 90 and -90, respectively.

The position of the camera given as a LatLngAltitude. Will be derived if omitted. If center is omitted but cameraPosition is specified, center will derive from cameraPosition. If both are updated in the same run loop, cameraPosition will be favored. The fields cameraPosition and center can be one-to-one-derived from each other in context of the given shared heading, range, roll, and tilt.

The center of the map given as a LatLngAltitude, where altitude is in meters above ground level. Note that this is not necessarily where the camera is located, as the range field affects the camera's distance from the map center. If not set, defaults to {lat: 0, lng: 0, altitude: 63170000}. 63170000 meters is a maximum allowed altitude (Earth radius multiplied by 10).

Type:  boolean optional

Default: false

When true, all default UI buttons are hidden.

Type:  string optional

If provided, an accessibility description (e.g. for use with screen readers) will be added to the map with the provided value.

Type:  number optional

Specifies the vertical field of view in degrees. Valid values range from 5.0 to 80.0. Higher values increase the visible area but may introduce perspective distortion. Default: 35.0.

Controls cooperative gesture handling. When set to COOPERATIVE, modifier keys or two-finger gestures are required to scroll the map. When set to GREEDY, the host page cannot be scrolled from user events on the map element. When set to AUTO, the gesture handling is determined by the scrollability of the host page.

Type:  number optional

The compass heading of the map, in degrees, where due north is zero. When there is no tilt, any roll will be interpreted as heading.

Adds a usage attribution ID to the initializer, which helps Google understand which libraries and samples are helpful to developers, such as usage of a marker clustering library. To opt out of sending the usage attribution ID, it is safe to delete this property. Only unique values will be sent. Changes to this value after instantiation may be ignored.

Type:  string optional

Language in which to attempt to render the base map's language. Will default to the language requested by the developer when loading the Maps JS API.

Type:  string optional

Specifies a map ID which will be used to fetch cloud-based map style for the map. This should not be set after the map has been initialized. Therefore we ensure the mapId is only set during initialization and do not publish this attribute to public-facing channels.

Type:  number optional

The maximum altitude above the ground which will be displayed on the map. A valid value is between 0 and 63170000 meters (Earth radius multiplied by 10).

Type:  number optional

The maximum angle of heading (rotation) of the map. A valid value is between 0 and 360 degrees. minHeading and maxHeading represent an interval of <= 360 degrees in which heading gestures will be allowed. minHeading = 180 and maxHeading = 90 will allow heading in [0, 90] and heading in [180, 360]. minHeading = 90 and maxHeading = 180 will allow heading in [90, 180].

Type:  number optional

The maximum angle of incidence of the map. A valid value is between 0 and 90 degrees.

Type:  number optional

The minimum altitude above the ground which will be displayed on the map. A valid value is between 0 and 63170000 meters (Earth radius multiplied by 10).

Type:  number optional

The minimum angle of heading (rotation) of the map. A valid value is between 0 and 360 degrees. minHeading and maxHeading represent an interval of <= 360 degrees in which heading gestures will be allowed. minHeading = 180 and maxHeading = 90 will allow heading in [0, 90] and heading in [180, 360]. minHeading = 90 and maxHeading = 180 will allow heading in [90, 180].

Type:  number optional

The minimum angle of incidence of the map. A valid value is between 0 and 90 degrees.

Specifies a mode the map should be rendered in. If not set, the map won't be rendered.

Type:  number optional

The distance from camera to the center of the map, in meters.

Type:  string optional

Region with which to attempt to render the base map's POIs. Will default to the region requested by the developer when loading the Maps JS API.

Type:  number optional

The roll of the camera around the view vector in degrees. To resolve ambiguities, when there is no tilt, any roll will be interpreted as heading.

Type:  number optional

The tilt of the camera's view vector in degrees. A view vector looking directly down at the earth would have a tilt of zero degrees. A view vector pointing away from the earth would have a tilt of 180 degrees.

Type:  boolean optional

Default: false

When true, all default UI buttons are disabled. Does not disable the keyboard and gesture controls.

addEventListener(type, listener[, options])

Return Value:  void

Sets up a function that will be called whenever the specified event is delivered to the target. See addEventListener.

flyCameraAround(options)

Return Value:  None

flyCameraTo(options)

Return Value:  None

removeEventListener(type, listener[, options])

Return Value:  void

Removes an event listener previously registered with addEventListener from the target. See removeEventListener.

stopCameraAnimation()

Parameters:  None

Return Value:  None

function(animationEndEvent)

This event is fired when the fly animation ends. This event bubbles up through the DOM tree.

function(cameraPositionChangeEvent)

This event is fired when the Map3DElement's cameraPosition property changes.

function(centerChangeEvent)

This event is fired when the Map3DElement's center property changes.

function(clickEvent)

This event is fired when the Map3DElement element is clicked.

function(mapInitializationErrorEvent)

This event is fired when the map fails to initialize.

function(fovChangeEvent)

This event is fired when the Map3DElement's fov property changes.

function(headingChangeEvent)

This event is fired when the Map3DElement's heading property changes.

function(mapIdErrorEvent)

This event is fired when the Map3DElement's mapId property is invalid.

function(rangeChangeEvent)

This event is fired when the Map3DElement's range property changes.

function(rollChangeEvent)

This event is fired when the Map3DElement's roll property changes.

function(steadyChangeEvent)

This event is fired when the steady state of Map3DElement changes.

function(tiltChangeEvent)

This event is fired when the Map3DElement's tilt property changes.

This will cause the map to enter cooperative mode if the map is dominating its scroll parent (usually the host page) to where the user cannot scroll away from the map to other content.

The central point at which the camera should look at during the orbit animation. Note that the map heading will change as the camera orbits around this center point.

Type:  number optional

The duration of one animation cycle in milliseconds.

Type:  number optional

Specifies the number of times an animation should repeat. If the number is zero, the animation will complete immediately after it starts.

Type:  number optional

The number of rounds to rotate around the center in the given duration. This controls the overall speed of rotation. Passing a negative number to rounds will cause the camera to rotate in a counter-clockwise direction instead of the default clockwise direction.

The location at which the camera should point at the end of the animation.

Type:  number optional

The duration of the animation in milliseconds. A duration of 0 will teleport the camera straight to the end position.

Type:  boolean

Indicates whether Map3DElement is steady (i.e. all rendering for the current scene has completed) or not.

The latitude/longitude/altitude that was below the cursor when the event occurred. Please note, that at coarser levels, less accurate data will be returned. Also, sea floor elevation may be returned for the altitude value when clicking at the water surface from higher camera positions. This event bubbles up through the DOM tree.

Type:  string

The place id of the map feature.

fetchPlace()

Parameters:  None

Fetches a Place for this place id. In the resulting Place object, the id property will be populated. Additional fields can be subsequently requested via Place.fetchFields() subject to normal Places API enablement and billing. The promise is rejected if there was an error fetching the Place.