google_places_suggestions 0.0.2

GooglePlacesSuggestions is a Flutter package that delivers real-time location suggestions using the Google Places API.

GooglePlacesSuggestions

GooglePlacesSuggestions is a Flutter package that delivers real-time location suggestions using the Google Places API. It enhances user experience by providing instant search results as users type.

Features

• Real-time place suggestions using Google Places API
• Easy integration with Flutter
• Customizable search input and results display
• Recent searches and voice input support

Installation

Add this package to your pubspec.yaml file:

dependencies:
  google_places_suggestions: latest_version

Run the command to install dependencies:

flutter pub get

Usage

import 'package:google_places_suggestions/google_places_suggestions.dart';
import 'package:flutter/material.dart';

GooglePlacesSuggestions(
// Required parameters
googleMapKey: 'YOUR_GOOGLE_MAPS_API_KEY',
onPlaceSelected: (String placeId) {
  // Handle selected place
  print('Selected place ID: $placeId');
},

// Optional customization
hint: 'Search for a location...',
accentColor: Theme.of(context).primaryColor,
debounceTime: const Duration(milliseconds: 300),

// Customize text styles
textStyle: const TextStyle(
  fontSize: 16,
  color: Colors.black87,
),
placeSuggestionTextStyle: const TextStyle(
  fontSize: 14,
  fontWeight: FontWeight.w500,
  color: Colors.black87,
),

// Customize decorations
placeSuggestionIconDecoration: BoxDecoration(
  color: Theme.of(context).primaryColor.withValues(alpha: 0.1),
  borderRadius: BorderRadius.circular(8),
),
underlineDecoration: BoxDecoration(
  border: Border(
    bottom: BorderSide(
      color: Colors.grey.withValues(alpha: 0.2),
      width: 1,
    ),
  ),
),

// Recent searches configuration
enableRecentSearches: true,
maxRecentSearches: 5,
recentText: 'Recent Locations',
recentTextStyle: const TextStyle(
  fontSize: 16,
  fontWeight: FontWeight.bold,
),

// Error handling
onError: (String error) {
  ScaffoldMessenger.of(context).showSnackBar(
    SnackBar(content: Text(error)),
  );
},

// Custom empty state
noResultsWidget: const Center(
  child: Column(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.search_off, size: 48, color: Colors.grey),
      SizedBox(height: 8),
      Text(
        'No locations found',
        style: TextStyle(
          fontSize: 16,
          color: Colors.grey,
        ),
      ),
    ],
  ),
),
)

Configuration

Ensure you have enabled Places API in your Google Cloud Console and added the API key in your Flutter app.

License

This project is licensed under the MIT License.