google_places_autocomplete_text_field
A fully customizable Google Places autocomplete TextFormField for Flutter iOS, Android and Web.
4.1.0
2.9K downloads/mo
#4684 most downloaded on pub.dev
julienandco/google_places_autocomplete_text_field
What this package is like to depend on
Last release 4 months ago
25 Apr 2026
Release timing varies
gaps range from 1 weeks to 10 months
Nearly every release is documented
notes for 14 of 14 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
14 releases · first in 2023
3 releases in the last 12 months
see the full history below
Release timeline
14 releases · Apr 2023 to Apr 2026Releases
latest 14-
4.1.025 Apr 2026Release notes
Open source →Added the possibility to pass bundle/package information to the request headers to enable API key restrictions.
Release notes
Open source →- [Feat]: Added
packageName,sha1andiosBundleIdto theGoogleApiConfigto enable application restrictions on the Google API keys (thank you @outdoorapps!)
- [Feat]: Added
-
4.0.003 Apr 2026Release notes
Open source →Breaking changes, introducing two new features and a bug fix. Check out the changelog for more details and kudos!
Release notes
Open source →- [Breaking]: Removed
predictionTextBuilderand replaced it withpredictionBuilderto enable fully custom widgets (thank you @shanakamadusanka!) - [Feat]: Added
suggestionsFieldMaskandplaceDetailsFieldMaskto theGoogleApiConfigto enable explicit field mask setting per request (thank you @RobK410!) - [Fix]: The language code is now always passed to the request and uncoupled from the
countriesflag (thank you @srappose for opening issue #58!)
- [Breaking]: Removed
-
3.0.023 Nov 2025Release notes
Open source →Breaking changes, introducing two new fetures. Check out Changelog for more details and kudos!
Release notes
Open source →- [Breaking]: Explicitly passed
TextEditingControllers are not disposed by the widget anymore, but have to be handled manually (thank you @Brandon2255p!) - [Feat]: Added
predictionTextBuilderfor custom text andpredictionTextStylefor styling per prediction (thank you @fedecarroz!)
- [Breaking]: Explicitly passed
-
2.0.323 Aug 2025 -
2.0.223 Aug 2025Release notes
Open source →- [Feat]: The text field unfocuses after a suggestion has been selected. This behaviour can be prohibited by setting
keepFocusAfterSuggestionSelection = true. - [Feat]: Whenever the API returns an empty list of predictions, a placeholder widget will be shown inside the overlay, indicating that the request yielded no results. Customize this widget by using
predictionsEmptyWidget. - [Fix]: Added null-safe casts to prevent deserialization from breaking for predictions without types (thank you @stanimeros for opening issue #48!)
- [Feat]: The text field unfocuses after a suggestion has been selected. This behaviour can be prohibited by setting
-
2.0.118 Aug 2025Release notes
Open source →- [Fix]: The proxy URL now completely overrides the default prefix (https), instead of simply prepending the URL (thank you @abimbola-michael-punch!)
-
2.0.012 Aug 2025Release notes
Open source →- [Breaking]: Introduced the
GoogleApiConfigclass to manage the Google Places API Configuration. - [Breaking]: Renamed
onPlaceDetailsWithCoordinatesReceivedtoonPredictionWithCoordinatesReceived. - [Breaking]: Bumped up SDK version to
3.7.2. - [Feat]: Add
locationBiasandlocationRestrictionparameters to the api config(see more info in the Google docs) - [Feat]: Add
includedPrimaryTypesparameter to the api config (see more info in the Google docs)
- [Breaking]: Introduced the
-
1.1.025 Jan 2025Release notes
Open source →A lot of new contributions that found a bug and improved the error handling! Thanks a lot and check out the change log for more info and kudos!
Release notes
Open source →- [Docs]: Add documentation for undocumented class members (thank you @Pietrucci-Blacher!)
- [Fix]: Handle unhandled exception when widget is disposed (thanks for finding this bug @jsanders5!)
- [Fix]: Improve the error handling in the API class (thank you @Alienjob!)
- [Feat]: Add language code functionality to receive API answers in the specified language (thank you @raulgarciaalcaraz-zero!)
-
1.0.027 Nov 2024Release notes
Open source →A lot of issues and PRs have been resolved in this new version! The main change is: we now implement the new Google Places API!
Check out the changelog for more info!Release notes
Open source →All the changes marked with (*) are the work of @lucaantonelli, thank you a lot!
- [Breaking]: Implement new Places API (*)
- [Add]: Add a minimum input length (*)
- [Add]: Add the possibility to use a session token (thanks for the first implementation @lucaantonelli!)
- [Add]: Add the
maxHeightparameter to manipulate the overlay height (special thanks to @Muhammed-Ayad!) - [Chore]: Remove unused
toJsonmethods from several classes - [Chore]: Added doc comments to
GooglePlacesAutoCompleteTextFormField - [Breaking]: Rename
itmClicktoonSuggestionClicked - [Breaking]: Rename
isLatLngRequiredtofetchCoordinates - [Breaking]: Rename
overlayContainertooverlayContainerBuilder - [Breaking]: Remove unnecessary typedefs:
GetPlaceDetailswWithLatLng,ItemClickandOverlayContainer - [Fix]: Make the
TextEditingControllernullable and ensure theinitialValueproperty can be used (thanks for finding this bug @trusilosv!) - [Add]: Add the
fetchSuggestionsForInitialValueparameter to instantly fetch suggestions when an initial value is given. - [Refactor]: Extract the Google Places API logic into an own class
- [Fix]: Make sure the overlay adapts to multiline input (thanks for finding this bug @iamdiogo!)
- [Breaking]: Rename
getPlaceDetailWithLatLngtoonPlaceDetailsWithCoordinatesReceived
-
0.1.304 Feb 2024Release notes
Open source →- [Fix]: Removed the duplicate declaration of the fields
inputDecorationanddecoration, which were misleading. Now only the fielddecorationis available to assign aInputDecorationto theGooglePlacesAutoCompleteTextFormField, following theTextFormFieldconvention.
- [Fix]: Removed the duplicate declaration of the fields
-
0.1.212 Aug 2023Release notes
Open source →- [Add]: New argument
validatornow you can validate the field if it's used inside the Form widget. More information is available in the example. - [Update]: Example updated.
- [Add]: New argument
-
0.1.119 May 2023Release notes
Open source →- [Fix]: Fixed a bug where the Google API Url would not be correctly built if no proxy URL was provided.
-
0.1.018 May 2023Release notes
Open source →- [Add]: Added compatibility for Flutter Web 🌐. Just pass the
GooglePlacesAutoCompleteTextFormFielda proxy URL and you're good to go!
- [Add]: Added compatibility for Flutter Web 🌐. Just pass the
-
0.0.322 Apr 2023Release notes
Open source →- [Fix]: Fixed a bug on MacOS where clicking on the predictions would not be registered.