---
description: >-
  Returns the geo location and additional information like speed and altitude if
  available. Be aware, that this is an asynchronous function and you have to use
  await.
---

# getGeoLocation

The Result looks like this:

```javascript
coords;
accuracy: 33;
altitude: null;
altitudeAccuracy: null;
heading: null;
latitude: 51.073834399999996;
longitude: 6.0768204;
speed: null;
timestamp: 1557477072518;
```

## Example Usages

```javascript
let myGeoLocation = await app.getGeoLocation();
console.log(myGeoLocation.coords.latitude);
console.log(myGeoLocation.coords.longitude);
```

To Visualize a geo location in google maps, see this documentation([http://www.joerg-buchwitz.de/temp/googlemapssyntax.htm](http://www.joerg-buchwitz.de/temp/googlemapssyntax.htm)) for possible url parameters, You could use the following commands in an event:

```javascript
let myLocation = await app.getGeoLocation();
window.open(
  "http://maps.google.de/maps?q=" +
    myLocation.coords.latitude +
    "," +
    myLocation.coords.longitude,
  "_blank"
);
```

### Return Values

The getGeoLocation function returns the current geographical location (latitude and longitude) asynchronously. It (internally) utilizes the getCurrentPosition function to retrieve the current position. It returns a Promise that resolves to the current geographic location (latitude and longitude).
