Package com.here.sdk.mapview

Class RoadShieldIconProperties

  • java.lang.Object
    • com.here.sdk.mapview.RoadShieldIconProperties
  • public final class RoadShieldIconProperties
extends java.lang.Object

    Contains the information required to create a road shield image.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      java.lang.String countryCode
      The country code in ISO-3166-1 alpha-3 format, which will determine the type of road shield.
      java.lang.String routeNumberName
      A string that is used to additionally determine the road shield's visual representation.
      RouteType routeType
      The type of route indicating the significance of the road in a range from 0 to 6.
      java.lang.String shieldText
      The text of the road-shield.
      java.lang.String stateCode
      The state code for the road.

    • Constructor Summary

      Constructors 
      Constructor Description
      RoadShieldIconProperties​(RouteType routeType, java.lang.String countryCode, java.lang.String stateCode, java.lang.String routeNumberName, java.lang.String shieldText)
      Creates a new instance.

    • Method Summary

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • routeType

        @NonNull
public RouteType routeType

        The type of route indicating the significance of the road in a range from 0 to 6. A value of 1 stands for the most major route and 6 the most minor, with 0 being of unknown type.

      • countryCode

        @NonNull
public java.lang.String countryCode

        The country code in ISO-3166-1 alpha-3 format, which will determine the type of road shield.

      • stateCode

        @NonNull
public java.lang.String stateCode

        The state code for the road. It's a 2-letter code in ISO 3166-2 format. For example the ones listed for US on this page https://en.wikipedia.org/wiki/ISO_3166-2:US. The code "AL" is for Alabama. Another example is the code for autonomous communities listed on https://en.wikipedia.org/wiki/ISO_3166-2:ES. Can be empty if not required for the particular country.

      • routeNumberName

        @NonNull
public java.lang.String routeNumberName

        A string that is used to additionally determine the road shield's visual representation. In a routing context, the text can be taken from a LocalizedRoadNumber, which is available for each Span of a Route object. Typically, the string contains the number of a road, such as "E100". Internally, the text is parsed with a RegEx pattern and the results will be used along with other properties such as routeType, countryCode and stateCode to identify the visual representation of a road shield icon.

        Note that the actual text which will be displayed on the road shield icon is set with shieldText. In order to determine the visuals of the icon, countryCode, routeType and eventually the stateCode is in most cases sufficient to determine the type of road shield. In this case an empty string should be passed.

        Note: Texts that contain a CardinalDirection are currently not supported and may lead to unexpected results. See LocalizedRoadNumber for more details, it provides texts with and without a cardinal direction.

      • shieldText

        @NonNull
public java.lang.String shieldText

        The text of the road-shield. This is the text which is displayed on the road-shield in reality. It will be in the output road-shield icon.

    • Constructor Detail

      • RoadShieldIconProperties

        public RoadShieldIconProperties​(@NonNull
                                RouteType routeType,
                                @NonNull
                                java.lang.String countryCode,
                                @NonNull
                                java.lang.String stateCode,
                                @NonNull
                                java.lang.String routeNumberName,
                                @NonNull
                                java.lang.String shieldText)

        Creates a new instance.

        Parameters:
        routeType -

        The type of route indicating the significance of the road in a range from 0 to 6. A value of 1 stands for the most major route and 6 the most minor, with 0 being of unknown type.

        countryCode -

        The country code in ISO-3166-1 alpha-3 format, which will determine the type of road shield.

        stateCode -

        The state code for the road. It's a 2-letter code in ISO 3166-2 format. For example the ones listed for US on this page https://en.wikipedia.org/wiki/ISO_3166-2:US. The code "AL" is for Alabama. Another example is the code for autonomous communities listed on https://en.wikipedia.org/wiki/ISO_3166-2:ES. Can be empty if not required for the particular country.

        routeNumberName -

        A string that is used to additionally determine the road shield's visual representation. In a routing context, the text can be taken from a LocalizedRoadNumber, which is available for each Span of a Route object. Typically, the string contains the number of a road, such as "E100". Internally, the text is parsed with a RegEx pattern and the results will be used along with other properties such as routeType, countryCode and stateCode to identify the visual representation of a road shield icon.

        Note that the actual text which will be displayed on the road shield icon is set with shieldText. In order to determine the visuals of the icon, countryCode, routeType and eventually the stateCode is in most cases sufficient to determine the type of road shield. In this case an empty string should be passed.

        Note: Texts that contain a CardinalDirection are currently not supported and may lead to unexpected results. See LocalizedRoadNumber for more details, it provides texts with and without a cardinal direction.

        shieldText -

        The text of the road-shield. This is the text which is displayed on the road-shield in reality. It will be in the output road-shield icon.