Expose isPresent platform interface (#202)

Author: TimHoogstrate

geocoding_platform_interface/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 3.2.0
+
+- Adds `isPresent` method to the platform interface.
+
 ## 3.1.0
 
 - Adds `placemarkFromAddress` method to the platform interface.

geocoding_platform_interface/lib/src/geocoding_platform_interface.dart

@@ -58,6 +58,16 @@ abstract class GeocodingPlatform extends PlatformInterface {
         'locationFromAddress() has not been implementated.');
   }
 
+  /// Returns true if there is a geocoder implementation present that may return results.
+  /// If true, there is still no guarantee that any individual geocoding attempt will succeed.
+  ///
+  ///
+  /// This method is only implemented on Android, calling this on iOS always
+  /// returns [true].
+  Future<bool> isPresent() {
+    throw UnimplementedError('isPresent() has not been implementated.');
+  }
+
   /// Returns a list of [Placemark] instances found for the supplied
   /// coordinates.
   ///

geocoding_platform_interface/pubspec.yaml

@@ -3,7 +3,7 @@ description: A common platform interface for the geocoding plugin.
 homepage: https://github.com/baseflow/flutter-geocoding/tree/main/geocoding_platform_interface
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 3.1.0
+version: 3.2.0
 
 dependencies:
   flutter:

geocoding_platform_interface/test/geocoding_platform_interface_test.dart

@@ -51,6 +51,20 @@ void main() {
       );
     });
 
+    test(
+        // ignore: lines_longer_than_80_chars
+        'Default implementation of isPresent should throw unimplemented error',
+        () {
+      // Arrange
+      final geocodingPlatform = ExtendsGeocodingPlatform();
+
+      // Act & Assert
+      expect(
+        () => geocodingPlatform.isPresent(),
+        throwsUnimplementedError,
+      );
+    });
+
     test(
         // ignore: lines_longer_than_80_chars
         'Default implementation of placemarkFromCoordinates should throw unimplemented error',