Location Picker Plus #

A comprehensive Flutter plugin for location selection with TWO POWERFUL WIDGETS:

1. Traditional Picker - Dropdown/autocomplete selection from predefined data
2. 🆕 Live Location Detection - GPS location detection with geocoding support

🚀 Two Widgets, Endless Possibilities #

📍 LocationPickerWidget (Traditional Selection) #

Select from predefined country, state, and city data with beautiful UI customization.

🌍 LocationDetectorWidget (NEW - Live Location) #

Detect current GPS location or search any address with real-time geocoding.

Features #

Traditional Location Picker #

• ✓ 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
• ✓ Customizable Themes - Multiple pre-built themes and full customization support
• ✓ Smart Search - Built-in search with relevance sorting
• ✓ 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
• ✓ Animation Support - Smooth transitions and animations
• ✓ Accessibility - Screen reader support and keyboard navigation

🆕 Live Location Detection #

• 🌍 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
• 🎛️ Flexible Modes - GPS only, search only, or both
• 🎨 Full UI Customization - Match your app's design

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  location_picker_plus: ^2.0.0

📱 Platform Setup (for Live Location Features) #

Android

Add to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />

iOS

Add to ios/Runner/Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs location access to detect your current location.</string>

Usage #

🆕 Live Location Detection #

Quick Start

import 'package:location_picker_plus/location_picker_plus.dart';

LocationDetectorWidget(
  mode: LocationDetectorMode.both, // GPS + Address search
  showCoordinates: true,
  onLocationChanged: (location) {
    print('Lat: ${location?.latitude}, Lng: ${location?.longitude}');
    print('Address: ${location?.fullAddress}');
    print('City: ${location?.locality}');
    print('State: ${location?.administrativeArea}');
    print('Country: ${location?.country}');
  },
)

GPS Detection Only

LocationDetectorWidget(
  mode: LocationDetectorMode.currentLocation,
  onCoordinatesChanged: (lat, lng) {
    print('Coordinates: $lat, $lng');
  },
)

Address Search Only

LocationDetectorWidget(
  mode: LocationDetectorMode.addressSearch,
  addressSearchHint: 'Enter address, city, or landmark...',
  onLocationChanged: (location) {
    // Use detected location data
  },
)

Advanced Usage with Service

// Direct service usage for custom UI
LocationDetectorService service = LocationDetectorService.instance;

// Get current location
LocationModel? location = await service.getCurrentLocationWithAddress();
print('Current city: ${location?.locality}');

// Search address
LocationModel? searched = await service.getCoordinatesFromAddress('New York');
print('NYC coordinates: ${searched?.latitude}, ${searched?.longitude}');

📍 Traditional Location Picker #

Basic Usage

LocationPickerWidget(
  onCountryChanged: (country) {
    print('Selected country: ${country?.name}');
  },
  onStateChanged: (state) {
    print('Selected state: ${state?.name}');
  },
  onCityChanged: (city) {
    print('Selected city: ${city?.name}');
    // Access latitude/longitude from city data
    if (city?.latitude != null) {
      print('City coordinates: ${city?.latitude}, ${city?.longitude}');
    }
  },
)

Autocomplete Mode (Real-time suggestions as you type)

LocationPickerWidget(
  useAutocomplete: true, // Enable autocomplete mode
  countryHint: 'Type country name...',
  stateHint: 'Type state name...',
  cityHint: 'Type city name...',
  onCountryChanged: (country) {
    // Handle country selection
  },
)

Dropdown Mode (Traditional dropdown with search) #

LocationPickerWidget(
  useAutocomplete: false, // Traditional dropdown mode
  theme: LocationPickerTheme.materialTheme().copyWith(
    showFlags: true,
    showPhoneCodes: true,
    borderRadius: BorderRadius.circular(12),
  ),
  countryLabel: 'Country',
  stateLabel: 'State/Province',
  cityLabel: 'City',
  onCountryChanged: (country) {
    // Handle country selection
  },
)

Country Only Picker #

LocationPickerWidget(
  useAutocomplete: true, // Or false for dropdown
  showState: false,
  showCity: false,
  countryHint: 'Type country name...',
  onCountryChanged: (country) {
    // Handle country selection
  },
)

Horizontal Layout #

Row(
  children: [
    Expanded(
      child: LocationPickerWidget(
        showState: false,
        showCity: false,
        countryLabel: 'Country',
      ),
    ),
    SizedBox(width: 16),
    Expanded(
      child: LocationPickerWidget(
        showCountry: false,
        showCity: false,
        stateLabel: 'State',
      ),
    ),
  ],
)

🔄 Combining Both Widgets #

You can use both widgets together for maximum flexibility:

Column(
  children: [
    // Live location detection
    LocationDetectorWidget(
      mode: LocationDetectorMode.currentLocation,
      onLocationChanged: (location) {
        // Auto-fill traditional picker based on detected location
      },
    ),

    SizedBox(height: 20),

    // Traditional picker for manual selection
    LocationPickerWidget(
      useAutocomplete: true,
      onCountryChanged: (country) {
        // Handle manual selection
      },
    ),
  ],
)

Customization #

Available Themes #

// Default theme
LocationPickerTheme.defaultTheme()

// Material Design theme
LocationPickerTheme.materialTheme()

// Cupertino theme
LocationPickerTheme.cupertinoTheme()

// Custom theme
LocationPickerTheme(
  inputDecoration: InputDecoration(
    border: OutlineInputBorder(),
    contentPadding: EdgeInsets.all(16),
  ),
  dropdownBackgroundColor: Colors.white,
  itemHighlightColor: Colors.blue.withOpacity(0.1),
  borderRadius: BorderRadius.circular(8),
  elevation: 4,
  showFlags: true,
  showPhoneCodes: false,
  maxHeight: 250,
  animationDuration: Duration(milliseconds: 200),
)

Input Modes #

Autocomplete Mode (useAutocomplete: true) #

• Real-time suggestions appear as you type
• No Enter key required - suggestions show instantly
• Debounced for performance - optimized for smooth typing
• Smart relevance sorting - exact matches first, then starts-with, then contains
• Auto-clear functionality - click X to clear selection

Dropdown Mode (useAutocomplete: false) #

• Traditional dropdown with search functionality inside
• Click to open dropdown with search box
• Keyboard navigation support
• More familiar UX for users expecting dropdowns

Widget Parameters #

Models #

CountryModel #

CountryModel(
  id: '1',
  sortName: 'US',
  name: 'United States',
  phoneCode: '1',
  flagEmoji: '🇺🇸',
  capital: 'Washington, D.C.',
  currency: 'USD',
)

StateModel #

StateModel(
  id: '1',
  name: 'California',
  countryId: '1',
  stateCode: 'CA',
  type: 'State',
)

CityModel #

CityModel(
  id: '1',
  name: 'Los Angeles',
  stateId: '1',
  latitude: '34.0522',
  longitude: '-118.2437',
  isCapital: false,
)

🆕 LocationModel (Live Location) #

LocationModel(
  latitude: 34.0522,
  longitude: -118.2437,
  address: '123 Main St, Los Angeles, CA 90210, USA',
  street: '123 Main St',
  locality: 'Los Angeles',        // City
  administrativeArea: 'CA',       // State
  country: 'United States',
  postalCode: '90210',
  countryCode: 'US',
)

📊 LocationDetectorWidget Parameters #

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License.