Method Details

• getLocation

  @NonNull public TrafficLocation getLocation()

  Gets the location of the incident.

  Returns:

  Defines the location affected by traffic flow.

• getSpeedInMetersPerSecond

  @Nullable public Double getSpeedInMetersPerSecond()

  Gets the expected speed in meters per second along the roadway; will not exceed the legal speed limit.

  Returns:

  The expected speed in meters per second along the roadway; will not exceed the legal speed limit.

• getSpeedUncappedInMetersPerSecond

  @Nullable public Double getSpeedUncappedInMetersPerSecond()

  Gets the expected speed in meters per second along the roadway.

  It is based on probe data (GPS coordinates sent by vehicles or mobile devices driving along that roadway). The calculated 'expected speed' may be over the legal speed limit for that roadway because people are driving over the speed limit.

  Returns:

  The expected speed in meters per second that a car can drive along a roadway right now; may exceed the legal speed limit.

• getJamTendency

  @Nullable public Short getJamTendency()

  Gets the jam tendency field value which denotes whether the congestion is increasing, decreasing, or constant.

  The congestion tendency may take the following values:

  • +2 - rapidly increasing congestion
  • +1 - increasing congestion
  • 0 - constant congestion
  • -1 - decreasing congestion
  • -2 - rapidly decreasing congestion Default value of 0 can be assumed when this attribute is not present.

  Returns:

  The jamTendency field denotes whether the congestion is increasing, decreasing, or constant.

• getConfidence

  @Nullable public Double getConfidence()

  Gets the confidence field value which is normalized value between 0.0 and 1.0.

  It is a normalized value between 0.0 and 1.0 with the following meaning:

  • 0.7 < confidence <= 1.0 indicates real time speeds
  • 0.5 < confidence <= 0.7 indicates historical speeds
  • 0.0 < confidence <= 0.5 indicates speed limit

  This field can be used to identify whether the data for a location is derived from real-time probe sources or historical information only. All confidence data 0.71 and above is based on real-time information, where a confidence value of 0.75 or greater indicates high confidence real-time information. A confidence value equal to 0.70 or lower means that the data is derived from historical data only.

  Returns:

  The confidence field indicates the proportion of real-time data included in the speed calculation.

• getTraversability

  @Nullable public Traversability getTraversability()

  Gets the traversability of roadway.

  Returns:

  The traversability of roadway.

• getJunctionsTraversability

  @Nullable public JunctionsTraversability getJunctionsTraversability()

  Gets the traversability of junctions along the affected road.

  Returns:

  The traversability of junctions along the affected road.

• getFreeFlowSpeedInMetersPerSecond

  public double getFreeFlowSpeedInMetersPerSecond()

  Gets the reference speed in meters per second along the roadway when no traffic is present.

  Specified by:

  getFreeFlowSpeedInMetersPerSecond in interface TrafficFlowBase

  Returns:

  The reference speed in meters per second along the roadway when no traffic is present.

• getJamFactor

  public double getJamFactor()

  Gets a value for the amount of traffic on the roadway.

  The value, between 0.0 and 10.0, indicate the expected quality of travel. A value of 0.0 indicates that there is no congestion on the roadway. As the value approaches 10.0, it indicates increasing congestion. A value of 10.0 is reserved to represent a blocked roadway (closure).

  Specified by:

  getJamFactor in interface TrafficFlowBase

  Returns:

  A value for the amount of traffic on the roadway.