search_map 0.0.1

A Flutter package for integrating Google Maps Places API with autocomplete and place details retrieval.

Flutter Search Map

A Flutter package that integrates with the Google Maps Places API to provide a location search field with autocomplete and place details retrieval. This package simplifies adding map-based search functionality with a user-friendly overlay displaying predictions.

---

Key Features

• Google Places Autocomplete: Get real-time suggestions for addresses.
• Place Details Retrieval: Fetch detailed information (name, address, coordinates) for any selected place.
• Debounce Search: Reduce redundant API calls with built-in debouncing.
• Customizable Overlay: Display search results dynamically with customization options.
• Localization Support: Works with easy_localization to support multiple languages.
• Icon Integration: Uses font_awesome_flutter for elegant search icons.
• Session Management: Manages API sessions efficiently to optimize performance.

---

Installation

Add the following to your pubspec.yaml:

dependencies:
  search_map: any

Getting Started

1. Create a Google Cloud Project and enable the Places API.
2. Generate an API Key from the Google Cloud Console.
3. Add your API Key to the widget configuration.

Usage

import 'package:search_map/search_map.dart';

void main() {
  runApp(MyApp());
}

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Search Map Example')),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: SearchMap(
            apiKey: 'YOUR_API_KEY',
            focusNode: FocusNode(),
            onClickAddress: (placeDetails) {
              print('Selected: ${placeDetails.description}');
            },
          ),
        ),
      ),
    );
  }
}

Customization

• Customize the overlay style: Use the overlayStyle parameter to customize the overlay appearance.
• Localization: Use easy_localization to support multiple languages.
• Debounce Time: Adjust the debounce time with debounceTime to balance performance and responsiveness.
• Icon Integration: Use font_awesome_flutter for search icons.
• Session Management: Use sessionManager to manage API sessions efficiently.
• Error Handling: Handle errors gracefully using onError callback.
• Customization: Customize the overlay style, localization, debounce time, icon integration, session management, and error handling.
• Localization: Use easy_localization to support multiple languages.

Contributing

Contributions are welcome! Please follow the MZzzNn guidelines.

License

This project is licensed under the MIT License.