feat: Add query constraint wherePolygonContains to determine whether a point in within a polygon (#778)

Author: Paul0Cesar

packages/dart/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [3.1.11](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-3.1.10...dart-3.1.11) (2023-01-21)
+
+### Features
+
+* Add query constraint `wherePolygonContains` to determine whether a point in within a polygon ([#777](https://github.com/parse-community/Parse-SDK-Flutter/issues/777))
+
 ## [3.1.10](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-3.1.9...dart-3.1.10) (2023-01-16)
 
 ### Bug Fixes

packages/dart/lib/src/base/parse_constants.dart

@@ -1,7 +1,7 @@
 part of flutter_parse_sdk;
 
 // Library
-const String keySdkVersion = '3.1.10';
+const String keySdkVersion = '3.1.11';
 const String keyLibraryName = 'Flutter Parse SDK';
 
 // End Points

packages/dart/lib/src/network/parse_query.dart

@@ -314,6 +314,15 @@ class QueryBuilder<T extends ParseObject> {
         _singleQuery, '"$column":{"\$geoWithin":${jsonEncode(dictionary)}}'));
   }
 
+  /// Add a constraint to the query that requires a particular key's coordinates that contains a point
+  void wherePolygonContains(String column, ParseGeoPoint point) {
+    final double latitude = point.latitude;
+    final double longitude = point.longitude;
+
+    queries.add(MapEntry<String, dynamic>(_singleQuery,
+        '"$column":{"\$geoIntersects":{"\$point":{"__type":"GeoPoint","latitude":$latitude,"longitude":$longitude}}}'));
+  }
+
   /// Add a constraint to the query that requires a particular key's value match another QueryBuilder
   void whereMatchesQuery<E extends ParseObject>(
       String column, QueryBuilder<E> query) {

packages/dart/pubspec.yaml

@@ -1,6 +1,6 @@
 name: parse_server_sdk
 description: Dart plugin for Parse Server, (https://parseplatform.org), (https://back4app.com)
-version: 3.1.10
+version: 3.1.11
 homepage: https://github.com/parse-community/Parse-SDK-Flutter
 
 environment:

packages/dart/test/parse_query_test.dart

@@ -327,5 +327,76 @@ void main() {
 
       expect(result.query, expectedQuery.query);
     });
+
+    test('wherePolygonContains', () async {
+      // arrange
+      final QueryBuilder<ParseObject> queryBuilder =
+          QueryBuilder<ParseObject>(ParseObject('TEST_SCHEMA', client: client));
+      double latitude = 84.17724609375;
+      double longitude = -53.69670647530323;
+      ParseGeoPoint point =
+          ParseGeoPoint(latitude: latitude, longitude: longitude);
+      queryBuilder.wherePolygonContains("geometry", point);
+
+      var desiredOutput = {
+        "results": [
+          {
+            "objectId": "eT9muOxBTK",
+            "createdAt": "2022-07-25T13:46:06.092Z",
+            "updatedAt": "2022-07-25T13:46:23.586Z",
+            "geometry": {
+              "type": "Polygon",
+              "coordinates": [
+                [
+                  [84.17724609375, -53.69670647530323],
+                  [83.1884765625, -54.61025498157913],
+                  [84.814453125, -55.14120964449505],
+                  [85.67138671875, -54.40614309031968],
+                  [84.17724609375, -53.69670647530323]
+                ]
+              ]
+            }
+          }
+        ]
+      };
+
+      when(client.get(
+        any,
+        options: anyNamed("options"),
+        onReceiveProgress: anyNamed("onReceiveProgress"),
+      )).thenAnswer((_) async => ParseNetworkResponse(
+          statusCode: 200, data: jsonEncode(desiredOutput)));
+
+      // act
+      ParseResponse response = await queryBuilder.query();
+      ParseObject parseObject = response.results?.first;
+
+      final Uri result = Uri.parse(verify(client.get(
+        captureAny,
+        options: anyNamed("options"),
+        onReceiveProgress: anyNamed("onReceiveProgress"),
+      )).captured.single);
+
+      var queryDesiredOutput = {
+        "geometry": {
+          "\$geoIntersects": {
+            "\$point": {
+              "__type": "GeoPoint",
+              "latitude": latitude,
+              "longitude": longitude
+            }
+          }
+        }
+      };
+      final Uri expectedQuery =
+          Uri(query: 'where=' + jsonEncode(queryDesiredOutput));
+
+      // assert
+      expect(response.results?.first, isA<ParseObject>());
+      expect(parseObject.objectId, "eT9muOxBTK");
+      expect(parseObject.containsKey("geometry"), true);
+      expect(result.path, '/classes/TEST_SCHEMA');
+      expect(result.query, expectedQuery.query);
+    });
   });
 }