Class Incident

    • Constructor Detail

      • Incident

        public Incident​(Point point)
        Creates an instance of incident.
        Parameters:
        point - location of the incident
        Throws:
        java.lang.IllegalArgumentException - if point is null
        Since:
        100.1.0
    • Method Detail

      • getName

        public java.lang.String getName()
        Gets the name that was set for this incident.
        Returns:
        the name of incident. Default value is an empty string
        Since:
        100.1.0
      • setName

        public void setName​(java.lang.String name)
        Sets the name for this incident.
        Parameters:
        name - incident's name. Null is treated as an empty string
        Since:
        100.1.0
      • setCurbApproach

        public void setCurbApproach​(CurbApproach curbApproach)
        Sets the direction from which a vehicle may arrive at or depart from the incident.

        For example, a school bus must approach and depart a school from its door side so that students entering/exiting the bus will not have to cross the street.

        Parameters:
        curbApproach - curb approach
        Throws:
        java.lang.IllegalArgumentException - if curbApproach is null
        Since:
        100.1.0
      • getNetworkLocation

        public NetworkLocation getNetworkLocation()
        Network location.

        The incident's location on the network that can be populated by closest facility task.

        Returns:
        network location, or null if none
        Since:
        100.1.0
        See Also:
        NetworkLocation
      • setNetworkLocation

        public void setNetworkLocation​(NetworkLocation networkLocation)
        Network location.

        The incident's location on the network that can be populated by closest facility task. Set to null for resetting a network location.

        Parameters:
        networkLocation - network location
        Since:
        100.1.0
        See Also:
        NetworkLocation
      • getDistanceToNetworkLocation

        public double getDistanceToNetworkLocation()
        Gets the distance to the network location in meters.
        Returns:
        the distance to the network location in meters. Returns NaN by default
        Since:
        100.1.0
      • getGeometry

        public Point getGeometry()
        Gets the location the incident should be placed on the map.
        Returns:
        a map point representing the location of the incident
        Since:
        100.1.0
      • getAddedCost

        public double getAddedCost​(java.lang.String attributeName)
        Gets the added cost that was set for this incident.
        Parameters:
        attributeName - attribute name. It can be empty. Null is treated as an empty string
        Returns:
        the added cost. Returns 0 if it was not set
        Since:
        100.1.0
      • setAddedCost

        public void setAddedCost​(java.lang.String attributeName,
                                 double addedCost)
        Sets the added cost for this incident.
        Parameters:
        attributeName - attribute name. It can be empty. Null is treated as an empty string
        addedCost - added cost
        Since:
        100.1.0
      • getCurrentBearing

        public double getCurrentBearing()
        Gets the current bearing in degrees, measured clockwise from true north. Typical values are 0 to 360 or NaN, negative values will have 360 added to them (e.g. -15 => 345), values greater than 360 will have 360 subtracted from them (e.g. 385 => 25). For this property to be used the bearing tolerance also has to be set.
        Returns:
        the current bearing
        Since:
        100.7.0
      • setCurrentBearing

        public void setCurrentBearing​(double currentBearing)
        Sets the current bearing in degrees, measured clockwise from true north. Typical values are 0 to 360 or NaN, negative values will have 360 added to them (e.g. -15 => 345), values greater than 360 will have 360 subtracted from them (e.g. 385 => 25). For this property to be used, the bearing tolerance also has to be set.
        Parameters:
        currentBearing - the new value for current bearing
        Since:
        100.7.0
      • getCurrentBearingTolerance

        public double getCurrentBearingTolerance()
        Gets the current bearing tolerance in degrees. Valid values are 0 to 180 or NaN.
        Returns:
        the current bearing tolerance
        Since:
        100.7.0
      • setCurrentBearingTolerance

        public void setCurrentBearingTolerance​(double currentBearingTolerance)
        Sets the current bearing tolerance in degrees. Valid values are 0 to 180 or NaN.
        Parameters:
        currentBearingTolerance - the new value for current bearing tolerance
        Throws:
        java.lang.IllegalArgumentException - if currentBearingTolerance is out of range
        Since:
        100.7.0
      • getNavigationLatency

        public double getNavigationLatency()
        Gets the navigation latency in seconds.
        Returns:
        navigation latency in seconds
        Since:
        100.7.0
      • setNavigationLatency

        public void setNavigationLatency​(double navigationLatency)
        Sets the navigation latency in seconds.
        Parameters:
        navigationLatency - the new value for navigation latency
        Since:
        100.7.0
      • getNavigationSpeed

        public double getNavigationSpeed()
        Gets the navigation speed in meters per second.
        Returns:
        navigation speed in meters per second
        Since:
        100.7.0
      • setNavigationSpeed

        public void setNavigationSpeed​(double navigationSpeed)
        Sets the navigation speed in meters per second.
        Parameters:
        navigationSpeed - the new value for navigation speed
        Since:
        100.7.0