Skip to content

TransistorAuthorizationService

Client for the Transistor Software demo tracking server.

Transistor Software hosts a public demo server at tracker.transistorsoft.com that consumes location data from devices running the Background Geolocation SDK. You can also run a local instance — see background-geolocation-console.

The demo server is useful for evaluating the SDK or for sharing tracking results with Transistor Support when debugging.

Viewing results

To view tracking results in a browser, visit:

http://tracker.transistorsoft.com/<your-organization-name>

final url = "http://tracker.transistorsoft.com";
final orgname = "my-company-name";
final username = "my-username";

// Fetch a token from the server (the SDK caches it automatically).
final token = await BackgroundGeolocation.findOrCreateTransistorAuthorizationToken(
  orgname, username, url
);

BackgroundGeolocation.ready(Config(
  transistorAuthorizationToken: token
));

Members

destroy

static Future<bool?> destroy(String url)

Remove the cached token associated with the given tracker URL.

// defaults to http://tracker.transistorsoft.com
await TransistorAuthorizationToken.destroy();

// If using a custom instance of Demo Server:
/// await TransistorAuthorizationToken.destroy("http://192.168.0.100:9000");

findOrCreate

static Future<TransistorAuthorizationToken> findOrCreate( String orgname, String username, [String url = _DEFAULT_TRANSISTOR_URL])

Find or create an authorization token for the given organization and username.

If a token already exists in the local cache for this orgName + url combination, the cached token is returned. Otherwise a new token is requested from the server and cached for future calls.

String orgname = "my-company-name";
String usernmae = "my-username";

// Fetch an authoriztion token from server.  The SDK will cache the received token.
TransistorAuthorizationToken token = await
  TransistorAuthorizationToken.findOrCreate(orgname, username);

BackgroundGeolocation.ready(Config(
  transistorAuthorizationToken: token
))