Skip to content

About

Android SDK for Radar, the leading geofencing and location tracking platform

Topics

Resources

Contributing

Stars

98 stars

Watchers

6 watching

Forks

Repository files navigation

Radar

Maven Central CircleCI

Radar is the leading geofencing and location tracking platform.

The Radar SDK abstracts away cross-platform differences between location services, allowing you to add geofencing, location tracking, trip tracking, geocoding, and search to your apps with just a few lines of code.

Documentation

See the full documentation here.

You can also see a detailed SDK reference here.

Migrating

See migration guides in MIGRATION.md.

Examples

See an example app in example/.

To run the example app, clone this repository, build the app, and set your publishable API key in the Tests tab under Settings → Environment. You can also set default keys in MainActivity.kt (DEFAULT_PUBLISHABLE_KEY for production, DEFAULT_STAGING_PUBLISHABLE_KEY for staging).

Setup Radar key check pre-commit hook to prevent accidental key leak when working with the Example app.

git config filter.radar-keys.clean hooks/clean-filter
git config filter.radar-keys.smudge hooks/smudge-filter

Switching environments (production, staging, local server)

In the example app, open the Tests tab, tap the settings gear, and pick Production, Staging, or Local under Environment. Each environment keeps its own publishable key. Apply & restart saves the choice and relaunches the app. On launch the app checks the key against production and staging, and a red strip across the top says so if no key is set or the key isn't valid on the selected environment. Local points both the regular and verified host at your machine's http:// URL, e.g. http://192.168.X.X:8081 (use your LAN IP, not localhost; use 10.0.2.2 on the emulator).

Note: the example enables cleartext (HTTP) traffic (cleartextTrafficPermitted="true" in network_security_config.xml) purely to support local testing. This is a convenience for the sample app only — do not enable cleartext in a real app, as it weakens your app's network security. Production apps should use HTTPS and leave cleartext disabled (the Android default).

Contributing

Interested in contributing? See CONTRIBUTING.md for how to build, test, and submit changes.

Support

Have questions? We're here to help! Email us at support@radar.com.

About

Android SDK for Radar, the leading geofencing and location tracking platform

Topics

Resources

Contributing

Stars

98 stars

Watchers

6 watching

Forks

Releases

Packages

Used by

Contributors

Languages