GeolocationPosition: toJSON() method

Baseline 2024
Newly available

Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The toJSON() method of the GeolocationPosition interface is a serializer; it returns a JSON representation of the GeolocationPosition object.

Syntax

js
toJSON()

Parameters

None.

Return value

A JSON object that is the serialization of the GeolocationPosition object.

Examples

Using the toJSON() method

In this example, calling position.toJSON() returns a JSON representation of the GeolocationPosition object.

js
navigator.geolocation.getCurrentPosition((position) => {
  console.log(position.toJSON());
});

This would log a JSON object like so:

json
{
  "timestamp": 1717509611840,
  "coords": {
    "accuracy": 13.0,
    "latitude": 53.0,
    "longitude": 8.0,
    "altitude": null,
    "altitudeAccuracy": null,
    "heading": null,
    "speed": null
  }
}

To get a JSON string, you can use JSON.stringify(position) directly; it will call toJSON() automatically.

Specifications

Specification
Geolocation
# tojson-method

Browser compatibility

See also