move TurfSimplify#simplify to TurfTransformation and deprecate PolylineUtils#simplify

Author: dzinad

CHANGELOG.md

@@ -3,6 +3,8 @@
 Mapbox welcomes participation and contributions from everyone.
 
 ### main
+- Replaced `TurfSimplify#simplify` with `TurfTransformation#simplify`. [#1496](https://github.com/mapbox/mapbox-java/pull/1496)
+- Deprecated `PolylineUtils#simplify` in favour of `TurfTransformation#simplify`. [#1496](https://github.com/mapbox/mapbox-java/pull/1496)
 
 ### v6.8.0-beta.4 - September 5, 2022
 - Added `TurfSimplify#simplify` method to simplify `LineString` using Ramer-Douglas-Peucker algorithm. [#1486](https://github.com/mapbox/mapbox-java/pull/1486)

docs/turf-port.md

@@ -48,7 +48,7 @@ Below's an on going list of the Turf functions which currently exist inside the
 - [ ] turf-dissolve
 - [ ] turf-intersect
 - [ ] turf-line-offset
-- [ ] turf-simplify
+- [x] turf-simplify
 - [ ] turf-tesselate
 - [ ] turf-transform-rotate
 - [ ] turf-transform-translate

samples/src/main/java/com/mapbox/samples/BasicTurfSimplify.java

@@ -8,7 +8,7 @@
 import com.mapbox.geojson.LineString;
 import com.mapbox.geojson.Point;
 import com.mapbox.sample.BuildConfig;
-import com.mapbox.turf.TurfSimplify;
+import com.mapbox.turf.TurfTransformation;
 import retrofit2.Response;
 
 import java.io.IOException;
@@ -20,7 +20,7 @@ public class BasicTurfSimplify {
     public static void main(String[] args) throws IOException {
         LineString complexLineString = generateLineString();
         LineString simplifiedLineString = LineString.fromLngLats(
-          TurfSimplify.simplify(complexLineString.coordinates(), 0.001, true),
+          TurfTransformation.simplify(complexLineString.coordinates(), 0.001, true),
           complexLineString.bbox()
         );
         System.out.println("[Turf] complex: " + complexLineString.coordinates());

services-geojson/src/main/java/com/mapbox/geojson/utils/PolylineUtils.java

@@ -133,7 +133,9 @@ private static void encode(long variable, StringBuilder result) {
    * @return an array of simplified points
    * @see <a href="http://mourner.github.io/simplify-js/">JavaScript implementation</a>
    * @since 1.2.0
+   * @deprecated Use TurfTransformation#simplify.
    */
+  @Deprecated
   @NonNull
   public static List<Point> simplify(@NonNull List<Point> points) {
     return simplify(points, SIMPLIFY_DEFAULT_TOLERANCE, SIMPLIFY_DEFAULT_HIGHEST_QUALITY);
@@ -149,7 +151,9 @@ public static List<Point> simplify(@NonNull List<Point> points) {
    * @return an array of simplified points
    * @see <a href="http://mourner.github.io/simplify-js/">JavaScript implementation</a>
    * @since 1.2.0
+   * @deprecated Use TurfTransformation#simplify.
    */
+  @Deprecated
   @NonNull
   public static List<Point> simplify(@NonNull List<Point> points, double tolerance) {
     return simplify(points, tolerance, SIMPLIFY_DEFAULT_HIGHEST_QUALITY);
@@ -165,7 +169,9 @@ public static List<Point> simplify(@NonNull List<Point> points, double tolerance
    * @return an array of simplified points
    * @see <a href="http://mourner.github.io/simplify-js/">JavaScript implementation</a>
    * @since 1.2.0
+   * @deprecated Use TurfTransformation#simplify.
    */
+  @Deprecated
   @NonNull
   public static List<Point> simplify(@NonNull List<Point> points, boolean highestQuality) {
     return simplify(points, SIMPLIFY_DEFAULT_TOLERANCE, highestQuality);
@@ -183,7 +189,9 @@ public static List<Point> simplify(@NonNull List<Point> points, boolean highestQ
    * @return an array of simplified points
    * @see <a href="http://mourner.github.io/simplify-js/">JavaScript implementation</a>
    * @since 1.2.0
+   * @deprecated Use TurfTransformation#simplify.
    */
+  @Deprecated
   @NonNull
   public static List<Point> simplify(@NonNull List<Point> points, double tolerance,
                                      boolean highestQuality) {

services-geojson/src/test/java/com/mapbox/geojson/utils/PolylineUtilsTest.java

@@ -123,12 +123,14 @@ public void encode_neverReturnsNull() throws Exception {
   }
 
   @Test
+  @Deprecated
   public void simplify_neverReturnsNullButRatherAnEmptyList() throws Exception {
     List<Point> simplifiedPath = simplify(new ArrayList<Point>(), PRECISION_6);
     assertNotNull(simplifiedPath);
   }
 
   @Test
+  @Deprecated
   public void simplify_returnSameListWhenListSizeIsLessThanOrEqualToTwo(){
     final List<Point> path = new ArrayList<>();
     path.add(Point.fromLngLat(0, 0));
@@ -138,6 +140,7 @@ public void simplify_returnSameListWhenListSizeIsLessThanOrEqualToTwo(){
   }
 
   @Test
+  @Deprecated
   public void simplify_withHighestQuality() throws IOException{
     List<Point> path = createPointListFromResourceFile(SIMPLIFICATION_INPUT);
     List<Point> simplifiedPath = simplify(path, PRECISION_5, true);