location_picker_plus 2.0.0

location_picker_plus: ^2.0.0 copied to clipboard

🚀 Major New Features - Live Location Detection #

New Components

• ✅ LocationDetectorWidget: Live GPS location detection with geocoding
• ✅ LocationDetectorService: Comprehensive location services
• ✅ LocationModel: Enhanced location data with full address breakdown
• ✅ Flexible Detection Modes: GPS detection, address search, or both

Live Location Features

• 🌍 GPS Location Detection: Get current location with one tap
• 🔍 Address Geocoding: Search any address and get coordinates
• 🏠 Reverse Geocoding: Convert coordinates to readable addresses
• 📍 Forward Geocoding: Convert addresses to coordinates
• 🔐 Auto Permission Handling: Handles all location permissions automatically
• ⚡ High Accuracy GPS: Configurable accuracy levels
• 🌐 Multi-locale Support: Address detection in multiple languages
• 📱 Cross-platform: Full Android and iOS support

New Dependencies

• geolocator: ^14.0.2 - GPS location services
• geocoding: ^4.0.0 - Address geocoding services
• permission_handler: ^12.0.1 - Location permission management

Enhanced API

// Live location detection
LocationDetectorWidget(
  mode: LocationDetectorMode.both,
  showCoordinates: true,
  onLocationChanged: (location) {
    print('Lat: ${location?.latitude}, Lng: ${location?.longitude}');
    print('Address: ${location?.fullAddress}');
  },
)

// Service usage
LocationModel? location = await LocationDetectorService.instance
    .getCurrentLocationWithAddress();

Breaking Changes

• Minimum Flutter version remains >=3.3.0
• New permissions required for location features
• Added new dependencies (geolocator, geocoding, permission_handler)

Migration Guide

• Existing LocationPickerWidget usage unchanged
• New LocationDetectorWidget is separate - no migration needed
• Add location permissions to your app if using location detection

Platform Support

• Android: Requires location permissions in AndroidManifest.xml
• iOS: Requires NSLocationWhenInUseUsageDescription in Info.plist
• Web: Limited location support (browser-dependent)
• Desktop: Windows, macOS, Linux supported

Documentation Update #

• Updated repository URLs to point to new GitHub repository
• Fixed package name references in README documentation

Initial Release #

Features

• ✅ Two Input Modes: Dropdown with search OR Real-time autocomplete
• ✅ Instant Suggestions: See suggestions as you type (no Enter key needed)
• ✅ Debounced Performance: Optimized for smooth typing experience (50ms debounce)
• ✅ Smart Search: Built-in search with relevance sorting (exact matches first)
• ✅ Customizable Themes: Multiple pre-built themes and full customization support
• ✅ Flag Emojis & Phone Codes: Display country flags and phone codes
• ✅ Flexible Layouts: Horizontal/vertical layouts with responsive design
• ✅ Asset-based Data: Load location data from JSON assets
• ✅ Enhanced Models: Rich data models with additional properties (lat/lng, state codes, capitals)
• ✅ Animation Support: Smooth transitions and animations
• ✅ Accessibility: Screen reader support and keyboard navigation

Components Included

• LocationPickerWidget: Main widget with full customization
• AutocompleteDropdown: Real-time suggestions as you type
• CustomDropdown: Traditional dropdown with search
• LocationPickerTheme: Comprehensive theming system
• LocationService: Efficient data loading and caching
• Enhanced models: CountryModel, StateModel, CityModel

Customization Options

• 25+ theme properties for complete UI control
• 3 pre-built themes: Default, Material, Cupertino
• Individual component control: Show/hide country, state, city
• Custom hints and labels for each field
• Flexible positioning and spacing options
• Custom asset paths for your own location data

Technical Features

• Efficient caching with singleton pattern
• Optimized filtering with smart relevance sorting
• Debounced input for better performance
• Overlay positioning with screen edge detection
• Memory efficient list handling
• Error handling with user-friendly messages

Assets Included

• Complete country list with flags and phone codes
• State/province data for major countries
• City data with geographic information
• JSON format for easy customization

Example Usage #

// Autocomplete mode
LocationPickerWidget(
  useAutocomplete: true,
  onCountryChanged: (country) => print(country?.name),
)

// Dropdown mode
LocationPickerWidget(
  useAutocomplete: false,
  theme: LocationPickerTheme.materialTheme(),
  onCountryChanged: (country) => print(country?.name),
)