location_reader

location_reader is a Flutter package designed to simplify the process of retrieving and handling location-related data. It supports features such as obtaining the current location, converting coordinates to city names or country codes, managing location permissions, and performing nearby location queries with GeoFirePoint and Firebase.

Features

• 🌍 Get current location using Geolocator
• 🏙️ Convert latitude and longitude to city name and country code using geocoding
• 📍 Retrieve GeoFirePoint objects for use in Firebase
• 📡 Nearby location query support via geoflutterfire2
• 🔐 Seamless location permission handling
• 💡 Clean architecture with services, repositories, use cases, and cubits

Installation

Add the following to your pubspec.yaml:

dependencies:
  location_reader: ^<latest_version>

Then run:

flutter pub get

Getting Started

1. Register Dependencies

Ensure you call the DI registration method before using the services:

registerLocationServiceGetItDi();

2. Use Cases

You can access location-related use cases like this:

final getCurrentLocation = sl<GetCurrentLocation>();
final location = await getCurrentLocation();

3. UI Integration

Use LocationPicker and CountryCodeLoader widgets:

LocationPicker(
  onTap: () => // pick location logic,
)

CountryCodeLoader(
  page: (code) => Text("Country: $code"),
)

Dependencies

• geolocator
• geocoding
• geoflutterfire2
• flutter_bloc
• get_it
• dartz
• json_serializable

Example Use Cases

• GetCityName
• GetCountryCode
• GetCurrentLocation

All of these use cases internally handle permissions, errors, and edge cases.

JSON Support

The LocationModel class supports JSON serialization using json_serializable.

Error Handling

Utilizes Either from dartz and custom IFailure/LocationError for structured error handling.

Contributing

Feel free to open issues and contribute pull requests for enhancements or bug fixes.

License

MIT License. See LICENSE file for details.