[NAVAND-3671] Turf radians, degrees, and bearing methods: added tests and update docs (#1613)

Author: RingerJK

services-turf/src/main/java/com/mapbox/turf/TurfMeasurement.java

@@ -49,9 +49,8 @@ private TurfMeasurement() {
    *
    * @param point1 first point used for calculating the bearing
    * @param point2 second point used for calculating the bearing
-   * @return bearing in decimal degrees
-   * @see <a href="http://turfjs.org/docs/#bearing">Turf Bearing documentation</a>
-   * @since 1.3.0
+   * @return bearing in decimal degrees, between -180 and 180 degrees (positive clockwise)
+   * @see <a href="https://turfjs.org/docs/api/bearing">Turf Bearing documentation</a>
    */
   public static double bearing(@NonNull Point point1, @NonNull Point point2) {
 

services-turf/src/test/java/com/mapbox/turf/TurfConversionTest.java

@@ -45,6 +45,23 @@ public class TurfConversionTest extends TestUtils {
   @Rule
   public ExpectedException thrown = ExpectedException.none();
 
+  @Test
+  public void degreesToRadians() {
+    assertEquals(1, TurfConversion.degreesToRadians(57.295), 0.0001);
+    assertEquals(3.1416, TurfConversion.degreesToRadians(180), 0.0001);
+    assertEquals(2.1817 , TurfConversion.degreesToRadians(125), 0.0001);
+    assertEquals(0, TurfConversion.degreesToRadians(360), 0.0001);
+    assertEquals(0, TurfConversion.degreesToRadians(0), 0.0001);
+  }
+
+  @Test
+  public void radiansToDegrees() {
+    assertEquals(57.295, TurfConversion.radiansToDegrees(1), 0.01);
+    assertEquals(180, TurfConversion.radiansToDegrees(3.1416), 0.01);
+    assertEquals(125, TurfConversion.radiansToDegrees(2.1817), 0.01);
+    assertEquals(0, TurfConversion.radiansToDegrees(0), 0.01);
+  }
+
   @Test
   public void radiansToDistance() {
     assertEquals(

services-turf/src/test/java/com/mapbox/turf/TurfMeasurementTest.java

@@ -60,9 +60,54 @@ public class TurfMeasurementTest extends TestUtils {
 
   @Test
   public void testBearing() {
-    Point pt1 = Point.fromLngLat(-75.4, 39.4);
-    Point pt2 = Point.fromLngLat(-75.534, 39.123);
-    assertNotEquals(TurfMeasurement.bearing(pt1, pt2), 0, DELTA);
+    assertEquals(
+            90,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(10, 0)
+            ),
+            DELTA
+    );
+    assertEquals(
+            -90,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(-10, 0)
+            ),
+            DELTA
+    );
+    assertEquals(
+            0,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(0, 10)
+            ),
+            DELTA
+    );
+    assertEquals(
+            180,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(0, -10)
+            ),
+            DELTA
+    );
+    assertEquals(
+            -135.43,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(-10, -10)
+            ),
+            0.01
+    );
+    assertEquals(
+            44.56,
+            TurfMeasurement.bearing(
+                    Point.fromLngLat(0, 0),
+                    Point.fromLngLat(10, 10)
+            ),
+            0.01
+    );
   }
 
   @Test