DeviceMotionEvent.accelerationIncludingGravity

The accelerationIncludingGravity property returns the amount of acceleration recorded by the device, in meters per second squared (m/s2). Unlike DeviceMotionEvent.acceleration which compensates for the influence of gravity, its value is the sum of the acceleration of the device as induced by the user and the acceleration caused by gravity.

This value is not typically as useful as DeviceMotionEvent.acceleration, but may be the only value available on devices that aren't able of removing gravity from the acceleration data, such as on devices that don't have a gyroscope.

Syntax

var acceleration = deviceMotionEvent.accelerationIncludingGravity;

Value

The accelerationIncludingGravity property is an object providing information about acceleration on three axis. Each axis is represented with its own property:

x
Represents the acceleration upon the x axis which is the west to east axis
y
Represents the acceleration upon the y axis which is the south to north axis
z
Represents the acceleration upon the z axis which is the down to up axis

Specifications

Specification Status Comment
DeviceOrientation Event Specification Editor's Draft Initial definition.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
accelerationIncludingGravity
Experimental
Chrome Full support YesEdge Full support 12Firefox Full support 6IE No support NoOpera Full support YesSafari ? WebView Android Full support YesChrome Android Full support YesFirefox Android Full support 6Opera Android Full support YesSafari iOS Full support 4.2Samsung Internet Android Full support Yes

Legend

Full support
Full support
No support
No support
Compatibility unknown
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also