Class RouteSegment

libs/routing/route.hpp:46–220

\brief The route is composed of one or several subroutes. Every subroute is composed of segments. For every Segment is kept some attributes in the structure SegmentInfo.

/// \brief The route is composed of one or several subroutes. Every subroute is composed of segments.
/// For every Segment is kept some attributes in the structure SegmentInfo.
class RouteSegment final
{
public:
  struct SpeedCamera
  {
    SpeedCamera() = default;
    SpeedCamera(double coef, uint8_t maxSpeedKmPH) : m_coef(coef), m_maxSpeedKmPH(maxSpeedKmPH) {}

    bool EqualCoef(SpeedCamera const & rhs) const { return AlmostEqualAbs(m_coef, rhs.m_coef, 1.0E-5); }

    bool operator<(SpeedCamera const & rhs) const
    {
      if (!EqualCoef(rhs))
        return m_coef < rhs.m_coef;

      // Keep a camera with lowest speed (unique).
      return m_maxSpeedKmPH < rhs.m_maxSpeedKmPH;
    }

    friend std::string DebugPrint(SpeedCamera const & rhs);

    /// @todo Can replace with uint16_t feature node index, assuming that all cameras are placed on nodes.
    // Сoefficient where camera placed at the segment (number from 0 to 1).
    double m_coef = 0.0;
    // Max speed
    uint8_t m_maxSpeedKmPH = 0;
  };

  struct RoadNameInfo
  {
    // This is for street/road. |m_ref| |m_name|.
    std::string m_name;             // E.g "Johnson Ave.".
    std::string m_destination_ref;  // Number of next road, e.g. "CA 85", Sometimes "CA 85 South". Usually match |m_ref|
                                    // of next main road.
    // This is for 1st segment of link after junction. Exit |junction_ref| to |m_destination_ref| for |m_destination|.
    std::string m_junction_ref;  // Number of junction e.g. "398B".
    std::string m_destination;   // E.g. "Cupertino".
    std::string m_ref;           // Number of street/road e.g. "CA 85".
    bool m_isLink = false;

    RoadNameInfo() = default;
    RoadNameInfo(std::string name) : m_name(std::move(name)) {}
    RoadNameInfo(std::string name, std::string destination_ref)
      : m_name(std::move(name))
      , m_destination_ref(std::move(destination_ref))
    {}
    RoadNameInfo(std::string name, std::string destination_ref, std::string junction_ref)
      : m_name(std::move(name))
      , m_destination_ref(std::move(destination_ref))
      , m_junction_ref(std::move(junction_ref))
    {}
    RoadNameInfo(std::string name, std::string ref, std::string junction_ref, std::string destination_ref,
                 std::string destination, bool isLink)
      : m_name(std::move(name))
      , m_destination_ref(std::move(destination_ref))
      , m_junction_ref(std::move(junction_ref))
      , m_destination(std::move(destination))
      , m_ref(std::move(ref))