This directory contains an example project to get started building a Digital Wellbeing experiment with geolocation APIs. These building block projects could be used as the starting point for a new experiment, a reference for adding new functionality to another app, or just to learn more about the API.
You can learn more about the Google Maps Places SDK and the Location & GeoFence APIs in the developer documentation.
In this example project, a user can enter a location name in the text field to create a geofence, which is added to the main list view. Location names are resolved with the Google Maps Places SDK.
Using the Location & GeoFence APIs from Google Play Services, the Geofence is scheduled as a PendingIntent object. The app has a BroadcastReceiver class that the system will call when the device has entered that location. The application will automatically highlight the list element for the triggered geofence.
Note that you may need to leave and re-enter a location to trigger a location change event.
In order to run the example code, you'll need to create a new API key for the Google Maps API using the Google Developer Console and add it to the Android project in the google_maps_api.xml file. The package name for this example is com.digitalwellbeingexperiments.toolkit.geofence. You will also need to add the SHA-1 certificate fingerprint of your debug key to the cloud project.
There is more information available on the process key creation and app registration in the Google Maps API Documentation.