> For the complete documentation index, see [llms.txt](https://brixxbox.gitbook.io/brixxbox-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brixxbox.gitbook.io/brixxbox-documentation/client-api-reference/functions/getgeolocation.md).

# getGeoLocation

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.

The Result looks like this:

```
   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 brixxApi.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>) for possible url parameters, You could use the following commands in an event:

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