Class ServiceAreaTaskInfo


  • public final class ServiceAreaTaskInfo
    extends Object
    Represents metadata about the network analyst service used by ServiceAreaTask.

    ServiceAreaTaskInfo is an immutable object and initialized when the ServiceAreaTask is loaded. Changing ServiceAreaParameters does not affect this.

    Since:
    100.1.0
    • Method Detail

      • getNetworkName

        public String getNetworkName()
        Gets the name of the underlying transportation network dataset.
        Returns:
        the network name
        Since:
        100.1.0
      • getCostAttributes

        public Map<String,​CostAttribute> getCostAttributes()
        Gets a map of cost attributes that can be used as a travel mode impedance TravelMode.setImpedanceAttributeName(String) to optimize the service area result. The key in the Map represents the name of the cost attribute.
        Returns:
        an unmodifiable map of the cost attributes
        Since:
        100.1.0
      • getRestrictionAttributes

        public Map<String,​RestrictionAttribute> getRestrictionAttributes()
        Gets the map of supported restrictions for constraining the service area result. The key in the Map represents the name of the restriction attribute.
        Returns:
        an unmodifiable map of the restriction attributes
        Since:
        100.1.0
      • getSupportedRestrictionUsageParameterValues

        public List<String> getSupportedRestrictionUsageParameterValues()
        Gets the supported restriction usage parameter values.
        Returns:
        an unmodifiable list of the supported restriction usage parameter values
        Since:
        100.1.0
      • getAccumulateAttributeNames

        public List<String> getAccumulateAttributeNames()
        Gets the list of network attributes that can be accumulated and returned as part of the service area result.

        For example, accumulateAttributeNames = {"Miles", "Kilometers"} indicates that the total cost of the service area result should also be calculated in miles and kilometers. All supported attributes can be obtained from getCostAttributes().

        Returns:
        an unmodifiable list of the accumulate attribute names
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.getAccumulateAttributeNames()
      • getTravelModes

        public List<TravelMode> getTravelModes()
        Gets the available travel modes that can be used to customize the service area result.
        Returns:
        an unmodifiable list of the travel modes
        Since:
        100.1.0
      • getDefaultTravelModeName

        public String getDefaultTravelModeName()
        Gets the default travel mode that can be used to customize the service area result.
        Returns:
        the default travel mode name
        Since:
        100.1.0
      • getStartTime

        public Calendar getStartTime()
        Gets the default time the service area result begins. If not specified, defaults to the time the task is executed.
        Returns:
        the start time or null if no default start time is specified
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.setStartTime(Calendar)
      • getPolygonBufferDistance

        public double getPolygonBufferDistance()
        Gets the service area polygon buffer distance in meters.

        The polygon buffer refers to the distance from the road the service area polygon should extend when no other reachable roads are nearby, similar to a line buffer size. This is useful if the network is very sparse and you don't want the service area to cover large areas where there are no features.

        Returns:
        the polygon buffer distance in meters
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.setPolygonBufferDistance(double)
      • getPolygonDetail

        public ServiceAreaPolygonDetail getPolygonDetail()
        Gets the level of detail of the output polygons.

        If your analysis covers an urban area with a grid-like street network, the difference between generalized and standard polygons will be minimal. However, for mountain and rural roads, the standard and detailed polygons may present significantly more accurate results than generalized polygons.

        Returns:
        the level of detail of the output polygons
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.setPolygonDetail(ServiceAreaPolygonDetail)
      • isReturnPolylines

        public boolean isReturnPolylines()
        Indicates if polylines will be generated in the result.

        Service area output will contain line features representing the roads reachable before the cutoffs are exceeded.

        Returns:
        true for returning polylines after solving, false otherwise
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.setReturnPolylines(boolean)
      • isReturnPolygons

        public boolean isReturnPolygons()
        Indicates if polygons will be generated in the result.

        Service areas output will contain polygon features encompassing reachable area(s).

        Returns:
        true for returning polygons after solving, false otherwise
        Since:
        100.1.0
        See Also:
        ServiceAreaParameters.setReturnPolygons(boolean)