repository·master·Indexed 41 days ago
https://github.com/amanullahgit/live-location-tracker-flutterA Flutter application for real-time location tracking using Google Maps, Firebase Firestore, and the location package. It enables users to synchronize GPS coordinates to a Firestore 'location' collection and visualize live movements across multiple devices via the MyMap widget.
The project relies on the following key packages and services to function:
To change the image displayed during the app's launch on iOS, you can either replace the image files directly in the file system or use Xcode.
Navigate to the ios/Runner/Assets.xcassets/LaunchImage.imageset/ directory and replace the existing image files with your own assets. Ensure the filenames and formats match what the project expects.
open ios/Runner.xcworkspace.Runner/Assets.xcassets.open ios/Runner.xcworkspaceTo use this project, ensure Firebase is initialized in your main() function. The application relies on FirebaseFirestore for data persistence and the location package for device coordinates.
Key operations include:
Permission.location.request() to handle location access. If denied, you may need to prompt the user to open app settings.location.getLocation() to fetch the current coordinates and write them to a Firestore collection (e.g., location/user1).location.onLocationChanged to receive a stream of LocationData. Each update should be written to Firestore using SetOptions(merge: true) to update existing documents without overwriting other fields.StreamBuilder listening to FirebaseFirestore.instance.collection('location').snapshots() to reactively update the UI as location data changes in the database.void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();
runApp(MaterialApp(home: MyApp()));
}
// Example of updating location to Firestore
_getLocation() async {
final loc.LocationData _locationResult = await location.getLocation();
await FirebaseFirestore.instance.collection('location').doc('user1').set({
'latitude': _locationResult.latitude,
'longitude': _locationResult.longitude,
'name': 'john'
}, SetOptions(merge: true));
}The MyMap widget is a StatefulWidget used to display a Google Map that tracks a specific user's live location. It listens to a real-time stream from the Firebase Firestore location collection.
To use it, instantiate MyMap and provide the user_id of the user you wish to track. The widget will automatically find the document in the location collection where the document ID matches the provided user_id and use its latitude and longitude fields to position the map marker and camera.
// Example usage of MyMap
MyMap('TARGET_USER_ID');The application expects a Firestore collection named location. Each document in this collection represents a user's current position. Based on the implementation, a document should contain the following fields:
| Field | Type | Description |
|---|---|---|
name | String | The identifier or name of the user |
latitude | Number | The current latitude coordinate |
longitude | Number | The current longitude coordinate |
When updating locations, use SetOptions(merge: true) to ensure that existing fields (like name) are preserved when only coordinates are updated.
{
"name": "john",
"latitude": 0.0,
"longitude": 0.0
}For MyMap to function correctly, your Firebase Firestore database must satisfy the following schema requirements:
location must exist.location collection must match the user_id passed to the MyMap constructor.latitude: A numeric value representing the latitude.longitude: A numeric value representing the longitude.If the document or the required fields are missing, the widget will fail to locate the user's position.