https://github.com/abdularis/track-my-location

Android real-time location tracker app (learn using Firebase :fire:, Google Maps & Location Api) :globe_with_meridians:
https://github.com/abdularis/track-my-location

android google-maps google-play-services location-tracker mvvm-architecture

Last synced: 2 months ago
JSON representation

Android real-time location tracker app (learn using Firebase :fire:, Google Maps & Location Api) :globe_with_meridians:

• Host: GitHub
• URL: https://github.com/abdularis/track-my-location
• Owner: abdularis
• License: gpl-3.0
• Created: 2018-03-13T05:19:54.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2018-03-25T08:14:47.000Z (about 7 years ago)
• Last Synced: 2025-02-27T14:31:18.692Z (3 months ago)
• Topics: android, google-maps, google-play-services, location-tracker, mvvm-architecture
• Language: Java
• Homepage:
• Size: 1.75 MB
• Stars: 183
• Watchers: 19
• Forks: 96
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Track My Location

This is a simple android app where you can brodcast your location and everyone who has your dynamically generated unique key can track you in near real-time.

I created this project just for learning puposes particularly about firebase (firestore db), google maps api and google location api.

- [Backend (Firebase Cloud Functions)](https://github.com/abdularis/Track-My-Location_Cloud-Functions)

***

### Screenshots

![](images/screenshots.jpg)

***

### References

- [Set Up Google Play Services](https://developers.google.com/android/guides/setup)

- [Getting Started - Google Maps](https://developers.google.com/maps/documentation/android-api/start)

- [Get API Key](https://developers.google.com/maps/documentation/android-api/signup)

- [Add Marker in Maps](https://developers.google.com/maps/documentation/android-api/map-with-marker)

- Firebase Documentation (Guides) ([Link](https://firebase.google.com/docs/guides/))

- [Get Started with Firebase Firestore](https://firebase.google.com/docs/firestore/quickstart)

- [Firestore Data Model](https://firebase.google.com/docs/firestore/data-model)

- [Firestore - Get Data](https://firebase.google.com/docs/firestore/query-data/get-data)

- [Firestore - Structure Data](https://firebase.google.com/docs/firestore/manage-data/structure-data)

***

### How it works?

![](images/hiw.png)

- The first device get continous location update from gps, network etc. then

- Write and update the location data to a specific firebase firestore document

- Last, the second device read that firebase firestore document and show the marker in that location

***

### Hot to integrate Google Maps & Location API

To use google maps in an android app you can use `SupportMapFragment` or `MapView`

- Using google maps fragment (inside a layout or as a root tag)

 

```xml

```

- Then you have to add permissions and google maps api key in the *AndroidManifest.xml* file

![](images/as_1.png)

> Add permisions for coase and fine location also add meta-data tag for API key

***

### Integrate Google Play Services for Firebase into android project

- Add this gradle plugin `'com.google.gms:google-services:3.1.1'` into dependencies block of the top-level gradle build file

![](images/gr_1.png)

- Apply the google play services plugin in the app level gradle build file (app project)

![](images/gr_2.png)

- Then you can add google play services library for maps, location, places etc. (firebase needs google play services to operate)

![](images/gr_3.png)

- You need to download and add `google-services.json` file to your `project_name/app/` directory from firebase console when you add an android app to your firebase project

- Here are the complete figure

![](images/fb_4.png)

![](images/fb_1.png)

> enter the app package name & SHA-1 key (optional for firebase auth)

![](images/fb_2.png)

![](images/fb_3.png)

***

### Getting API Key for Google Maps & Location

- Go to the google cloud console page and click credentials submenu (or [Get API Key](https://developers.google.com/maps/documentation/android-api/signup) )

![](images/ga_1.png)

- Then create a new credential

![](images/ga_2.png)

- New API key has been created, you can copy the key and paste in the manifest file. To restrict access of the key click the restrict button

![](images/ga_3.png)

- You can restrict api key usage by selecting the platform or IP address by which the api call would be requested (Application restrictions)

![](images/ga_4.png)

1. Select one of the application restrictions (in this case Android)

2. Insert your android app package name

3. Insert SHA-1 fingerprint of your app

4. Click Save button

___

> - To get SHA-1 key you can use your android studo by opening your particular project -> select signingReport gradle task -> copy & paste the SHA-1 key into the android app restriction form

![](images/as_2.png)