location_crud_service #

A lightweight and extensible Dart package for updating user location data in Firebase Firestore using GeoFirePoint. This service is ideal for Flutter apps requiring geolocation tracking, real-time location updates, or location-based features with Firestore.

Features #

• Update Firestore documents with current geolocation.
• Uses GeoFirePoint format for location storage.
• Built with clean architecture and dependency injection principles.

Getting Started #

Installation #

Add this to your pubspec.yaml:

dependencies:
  location_crud_service: <latest_version>

Then run:

flutter pub get

Prerequisites #

This package requires:

• A Firestore service implementing IFireStoreDbService
• A location provider implementing ILocationServiceGeoFirePointProvider

Register the Service #

Use dependency injection to register the service:

sl.registerLazySingleton<ILocationCrudService>(
  () => LocationCrudServiceGeoFirePointFireStoreDataSourceImpl(
    fireStoreDbService: sl(),
    iGeoFireLocationService: sl(),
  ),
);

Usage #

final locationService = sl<ILocationCrudService>();

final success = await locationService.updateLocation(
  id: "user_123",
  path: "users",
);

if (success) {
  print("Location updated successfully!");
} else {
  print("Failed to update location.");
}

API #

updateLocation #

Future<bool> updateLocation({
  required String id,
  required String path,
  String field = "position",
});

Updates the document at the specified path and ID with the current GeoFirePoint location.

Contributing #

Contributions are welcome! Please open issues or submit pull requests.

License #

MIT License. See LICENSE for details.