GeolocationCoordinates

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The GeolocationCoordinates interface represents the position and altitude of the device on Earth, as well as the accuracy with which these properties are calculated. The geographic position information is provided in terms of World Geodetic System coordinates (WGS84).

Instance properties

The GeolocationCoordinates interface doesn't inherit any properties.

GeolocationCoordinates.latitude Read only

Returns a double representing the position's latitude in decimal degrees.

GeolocationCoordinates.longitude Read only

Returns a double representing the position's longitude in decimal degrees.

GeolocationCoordinates.altitude Read only

Returns a double representing the position's altitude in meters, relative to nominal sea level. This value can be null if the implementation cannot provide the data.

GeolocationCoordinates.accuracy Read only

Returns a double representing the accuracy of the latitude and longitude properties, expressed in meters.

GeolocationCoordinates.altitudeAccuracy Read only

Returns a double representing the accuracy of the altitude expressed in meters. This value can be null if the implementation cannot provide the data.

GeolocationCoordinates.heading Read only

Returns a double representing the direction towards which the device is facing. This value, specified in degrees, indicates how far off from heading true north the device is. 0 degrees represents true north, and the direction is determined clockwise (which means that east is 90 degrees and west is 270 degrees). If speed is 0, heading is NaN. If the device is unable to provide heading information, this value is null.

GeolocationCoordinates.speed Read only

Returns a double representing the velocity of the device in meters per second. This value can be null.

Instance methods

The GeolocationCoordinates interface doesn't inherit any methods.

GeolocationCoordinates.toJSON()

Returns a JSON representation of the GeolocationCoordinates object and enables serialization with JSON.stringify().

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
GeolocationCoordinates 795–78 7912–79 723.5–71 1610.6–15 13.15–13.1 7918–78 794–79 1611–14 13.4≤3–13.4 1.0 79≤37–78
accuracy 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
altitude 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
altitudeAccuracy 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
heading 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
latitude 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
longitude 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
secure_context_required 47 79 55 34 10 47 55 34 10 5.0 No
speed 5 12 3.5 1610.6–15 5 18 4 1611–14 ≤3 1.0 ≤37
toJSON 126 126 129 112 18 126 129 83 18 No 126

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates