fl_geocoder

Description:

fl geocoder

fl_geocoder #

A Flutter package for Forward and Reverse geocoding using Google Maps Platform Geocoding API. This package provides a more detailed data from API's response such as Address Components, Geometry, Place Id, and Status Codes.
🎯 Pre-requisites #
Before you start using this package, you need a project with a billing account and the Geocoding API enabled at Google Maps Platform.
🔨 Installation #
dependencies:
fl_geocoder: ^0.0.1
copied to clipboard
⚙ Import #
import 'package:fl_geocoder/fl_geocoder.dart';
copied to clipboard
🕹️ Usage #
Create an instance of FlGeocoder to access the functionalities available for geocoding.
You have to pass a valid API key in order for the functions to work as expected. On the other hand, this package provides an error messages where you can debug and found out the cause of it.
final geocoder = const FlGeocoder('YOUR-API-KEY');
copied to clipboard
GestureDetector(
onTap: () async {
final coordinates = Location(40.714224, -73.961452);
final results = await geocoder.findAddressesFromLocationCoordinates(
location: coordinates,
useDefaultResultTypeFilter: isFiltered,
// resultType: 'route', // Optional. For custom filtering.
);
},
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 8.0, vertical: 4.0),
margin: const EdgeInsets.symmetric(horizontal: 8.0),
decoration: const BoxDecoration(
color: Colors.blue,
borderRadius: BorderRadius.all(Radius.circular(5.0))),
child: Text('Search',
style: const TextStyle(color: Colors.white)),
),
),
copied to clipboard
FlGeocoder #
FlGeocoder class contains three different functionalities for geocoding.
1. findAddressesFromLocationCoordinates
Search corresponding addresses from given [Location].



Arguments
Type
Description




location
Location
Required values specifying the location for which you wish to obtain the closest, human-readable address.


resultType
String?
A filter of one or more address types, separated by a pipe (|). If the parameter contains multiple address types, the API returns all addresses that match any of the types.


useDefaultResultTypeFilter
bool
An optinal argument that checks whether to use the default filter type provided by this package which are `street_number








2. findAddressesFromAddress
Search for available list of address that matches the given string [address] query.



Arguments
Type
Description




address
String
Required argument where the geocoding specific area will be based.








2. findAddressesFromPlaceId
Search for available list of address that matches the given place id.



Arguments
Type
Description




id
String
Required argument place [id]s uniquely identify a place in the Google Places database and on Google Maps.








❌ Error Handling #
GeocodeFailure gives you the human-readable explanation for the error that you encountered.
final latitude = double.parse(latitudeController.text);
final longitude = double.parse(longitudeController.text);
final coordinates = Location(latitude, longitude);
try {
final results =
await widget.geocoder.findAddressesFromLocationCoordinates(
location: coordinates,
useDefaultResultTypeFilter: isFiltered,
);
} on GeocodeFailure catch (e) {
// Do some debugging or show an error message.
log(e.message ?? 'Unknown error occured.');
} catch (_) {
// Do some debugging or show an error message.
log('Generic failure occured.');
}
copied to clipboard
🐞 Bugs/Requests #
If you encounter any problems feel open an issue. If you feel the library is missing a feature, please raise a ticket on Github and we'll look into it. Pull request are also welcome.
📃 License #
MIT License