search_map 0.0.5 search_map: ^0.0.5 copied to clipboard
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 smooth animated overlay displaying predictions and handling user interactions seamlessly.
Key Features #
- Google Places Autocomplete: Get real-time suggestions for addresses.
- Place Details Retrieval: Fetch detailed information (name, address, coordinates) for any selected place.
- Smooth Animated Overlay: Search results appear and disappear with smooth fade and slide animations.
- Debounce Search: Reduce redundant API calls with built-in debouncing.
- Dynamic Overlay Width: The overlay matches the text field's width with a 3-pixel vertical offset for perfect alignment.
- Customizable Overlay and Icons: Display search results dynamically with customization options and Font Awesome icons.
- Localization Support: Works with
easy_localization
to support multiple languages. - Clear Button with Overlay Management: Automatically hides the overlay when the search is cleared.
- Session Management: Manages API sessions efficiently to optimize performance and minimize costs.
Installation #
Add the following dependency to your pubspec.yaml
:
dependencies:
search_map: anya
Getting Started #
- Create a Google Cloud Project and enable the Places API.
- Generate an API Key from the Google Cloud Console.
- 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.