geocoding_platform_interface

A common platform interface for the geocoding plugin.

This interface allows platform-specific implementations of the geocoding plugin, as well as the plugin itself, to ensure they are supporting the same interface. Have a look at the Federated plugins section of the official Developing packages & plugins documentation for more information regarding the federated architecture concept.

Usage

To implement a new platform-specific implementation of geocoding, extend GeocodingPlatform with an implementation that performs the platform-specific behavior, and when you register your plugin, set the default GeocodingPlatform by calling GeocodingPlatform.instance = MyPlatformGeocoding().

Note on breaking changes

Strongly prefer non-breaking changes (such as adding a method to the interface) over breaking changes for this package.

See https://flutter.dev/go/platform-interface-breaking-changes for a discussion on why a less-clean interface is preferable to a breaking change.

Issues

Please file any issues, bugs or feature requests as an issue on our GitHub page. Commercial support is available, you can contact us at hello@baseflow.com.

Want to contribute

If you would like to contribute to the plugin (e.g. by improving the documentation, solving a bug or adding a cool new feature), please carefully review our contribution guide and send us your pull request.

Author

This Geocoding plugin for Flutter is developed by Baseflow.

5.0.0

• BREAKING CHANGES:
  • Changes the Location.timestamp field to allow null values. Not all platforms (e.g. Android) specify a timestamp indicating when the coordinates for an address where resolved.

4.0.0

• BREAKING CHANGES:
  • Releases new interface making the Geocoding plugin easier to extend and implement on different platforms.
  • Moves the old interface into the legacy folder. This interface will remain available but will no longer be maintained. To import the old interface use import 'package:geocoding_platform_interface/legacy/geocoding_platform_interface.dart.

3.2.1

• Fixed analysis warnings from flutter analyse.

3.2.0

• Adds isPresent method to the platform interface.

3.1.0

• Adds placemarkFromAddress method to the platform interface.

3.0.0

• Breaking Change Changes to the platform interface calls, the locale is now set in a separate call.
• Removes the default method channel implementation.

2.0.1

• Updated the installation instructions in the README.md file.

2.0.0

• Migrate to null safety.

1.0.1+1

• Make sure the README.md mentions the correct version number.

1.0.1

• Added NoResultFoundException to indicate when no results are found, instead of PlatformException

1.0.0+3

• Renamed the method placemarkFromAddress to locationFromAddress.

1.0.0+2

• Return location class from the placemarkFromAddress method.

1.0.0+1

• Add missing street and toString implementation to Placemark.

1.0.0

• Initial open-source release.