New cpp folder structure

Signed-off-by: Alexander Borsuk <me@alex.bio>

libs/platform/measurement_utils.hpp

@@ -0,0 +1,70 @@
+#pragma once
+
+#include "geometry/point2d.hpp"
+#include "platform/locale.hpp"
+
+#include <string>
+
+namespace measurement_utils
+{
+enum class Units
+{
+  Metric = 0,
+  Imperial = 1
+};
+
+std::string_view DebugPrint(Units units);
+
+Units GetMeasurementUnits();
+
+inline double MetersToMiles(double m) { return m * 0.000621371192; }
+inline double MilesToMeters(double mi) { return mi * 1609.344; }
+inline double MilesToFeet(double mi) { return mi * 5280.0; }
+inline double MiphToKmph(double miph) { return MilesToMeters(miph) / 1000.0; }
+inline double KmphToMiph(double kmph) { return MetersToMiles(kmph * 1000.0); }
+inline double MpsToKmph(double mps) { return mps * 3.6; }
+inline double MetersToFeet(double m) { return m * 3.2808399; }
+inline double FeetToMeters(double ft) { return ft * 0.3048; }
+inline double FeetToMiles(double ft) { return ft * 0.00018939; }
+inline double InchesToMeters(double in) { return in / 39.370; }
+inline double NauticalMilesToMeters(double nmi) { return nmi * 1852; }
+inline double constexpr KmphToMps(double kmph) { return kmph * 1000 / 3600; }
+
+double ToSpeedKmPH(double speed, Units units);
+double MpsToUnits(double metersPerSecond, Units units);
+
+/// @return Speed value in km/h for Metric and in mph for Imperial.
+int FormatSpeed(double metersPerSecond, Units units);
+/// @return Speed value string (without suffix) in km/h for Metric and in mph for Imperial.
+std::string FormatSpeedNumeric(double metersPerSecond, Units units);
+
+/// @param[in] dac  Digits after comma in seconds.
+/// Use dac == 3 for our common conversions to DMS.
+std::string FormatLatLonAsDMS(double lat, double lon, bool withComma, int dac = 3);
+void FormatLatLonAsDMS(double lat, double lon, std::string & latText, std::string & lonText,
+                       int dac = 3);
+std::string FormatMercatorAsDMS(m2::PointD const & mercator, int dac = 3);
+void FormatMercatorAsDMS(m2::PointD const & mercator, std::string & lat, std::string & lon,
+                         int dac = 3);
+
+/// Default dac == 6 for the simple decimal formatting.
+std::string FormatLatLon(double lat, double lon, int dac = 6);
+std::string FormatLatLon(double lat, double lon, bool withComma, int dac = 6);
+void FormatLatLon(double lat, double lon, std::string & latText, std::string & lonText,
+                  int dac = 6);
+std::string FormatMercator(m2::PointD const & mercator, int dac = 6);
+void FormatMercator(m2::PointD const & mercator, std::string & lat, std::string & lon, int dac = 6);
+
+std::string FormatOsmLink(double lat, double lon, int zoom);
+
+/// Converts OSM distance (height, ele etc.) to meters.
+/// @returns false if fails.
+bool OSMDistanceToMeters(std::string const & osmRawValue, double & outMeters);
+/// Converts OSM distance (height, ele etc.) to meters std::string.
+/// @returns empty std::string on failure.
+std::string OSMDistanceToMetersString(std::string const & osmRawValue,
+                                      bool supportZeroAndNegativeValues = true,
+                                      int digitsAfterComma = 2);
+std::string ToStringPrecision(double d, int pr);
+std::string ToStringPrecisionLocale(platform::Locale const & locale, double d, int pr);
+}  // namespace measurement_utils