Important

This documentation is deprecated, and only kept here to support users of browser extension APIs. If you are using Trigger.io for iOS or Android, see https://trigger.io/docs/.

geolocation: Geolocation

Although geolocation APIs are part of the HTML5 specification, on some platforms, the default permissions dialogs can be cumbersome and annoying to your users.

For that reason, we offer an alternative way to get geolocation data.

Config

The geolocation module must be enabled in config.json

{
    "modules": {
        "geolocation": true
    }
}

API

geolocation.getCurrentPosition(options, success, error)

Arguments:

• options (object) -- request specific levels of service from the location provider, currently supports "enableHighAccuracy": true to request GPS location if available.
• success (function(position)) -- called with an object matching the W3C Position specification
• error (function(error)) -- called when the user chooses not to share their location with your app

Note

To enable easy porting from existing HTML5 code onto Forge, we also accept parameters in the order (success, error, options)

Permissions

On Android this module will add the ACCESS_FINE_LOCATION permission to your app, users will be prompted to accept this when they install your app.