Package com.esri.arcgisruntime.utilitynetworks

Class UtilityNearestNeighbor

java.lang.Object

com.esri.arcgisruntime.utilitynetworks.UtilityNearestNeighbor

public final class UtilityNearestNeighbor
extends java.lang.Object

Defines a Nearest Neighbor element in a UtilityNetwork. A filter object to return the next N features from the starting point.

Since:

100.8.0

Method Summary

Modifier and Type	Method	Description
static UtilityNearestNeighbor	createWithAssetTypes(UtilityNetworkAttribute costNetworkAttribute, int count, java.lang.Iterable<UtilityAssetType> assetTypes)	Creates a filter object to return the next n features from the starting point with asset types.
static UtilityNearestNeighbor	createWithAssetTypesAndCategories(UtilityNetworkAttribute costNetworkAttribute, int count, java.lang.Iterable<UtilityAssetType> assetTypes, java.lang.Iterable<UtilityCategory> categories)	Creates a filter object to return the next n features from the starting point with asset types and categories.
static UtilityNearestNeighbor	createWithCategories(UtilityNetworkAttribute costNetworkAttribute, int count, java.lang.Iterable<UtilityCategory> categories)	Creates a filter object to return the next n features from the starting point with categories.
java.util.List<UtilityAssetType>	getAssetTypes()	Gets an unmodifiable list of UtilityAssetType that are used to define features to return.
java.util.List<UtilityCategory>	getCategories()	Gets an unmodifiable list of UtilityCategory that are used to define features to return.
UtilityNetworkAttribute	getCostNetworkAttribute()	Gets the UtilityNetworkAttribute used to determine the definition of "nearest".
int	getCount()	Gets the number of nearest features to return.

Methods inherited from class java.lang.Object

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

Method Detail

createWithAssetTypes

public static UtilityNearestNeighbor createWithAssetTypes(UtilityNetworkAttribute costNetworkAttribute,
                                                          int count,
                                                          java.lang.Iterable<UtilityAssetType> assetTypes)

Creates a filter object to return the next n features from the starting point with asset types.

Parameters:

costNetworkAttribute - the UtilityNetworkAttribute used to determine the definition of "nearest"

count - the number of nearest features to return

assetTypes - the collection of UtilityAssetType that are used to define features to return

Throws:

java.lang.IllegalArgumentException - if costNetworkAttribute is null

java.lang.IllegalArgumentException - if count is less than one

java.lang.IllegalArgumentException - if assetTypes is null or empty

Since:

100.8.0

createWithCategories

public static UtilityNearestNeighbor createWithCategories(UtilityNetworkAttribute costNetworkAttribute,
                                                          int count,
                                                          java.lang.Iterable<UtilityCategory> categories)

Creates a filter object to return the next n features from the starting point with categories.

Parameters:

costNetworkAttribute - the UtilityNetworkAttribute used to determine the definition of "nearest"

count - the number of nearest features to return

categories - the collection of UtilityCategory that are used to define features to return

Returns:

a UtilityNearestNeighbor with nearest categories

Throws:

java.lang.IllegalArgumentException - if costNetworkAttribute is null

java.lang.IllegalArgumentException - if count is less than one

java.lang.IllegalArgumentException - if categories is null or empty

Since:

100.8.0

createWithAssetTypesAndCategories

public static UtilityNearestNeighbor createWithAssetTypesAndCategories(UtilityNetworkAttribute costNetworkAttribute,
                                                                       int count,
                                                                       java.lang.Iterable<UtilityAssetType> assetTypes,
                                                                       java.lang.Iterable<UtilityCategory> categories)

Creates a filter object to return the next n features from the starting point with asset types and categories.

Parameters:

costNetworkAttribute - the UtilityNetworkAttribute used to determine the definition of "nearest"

count - the number of nearest features to return

assetTypes - the collection of UtilityAssetType that are used to define features to return

categories - the collection of UtilityCategory that are used to define features to return

Returns:

a UtilityNearestNeighbor with nearest asset types and categories

Throws:

java.lang.IllegalArgumentException - if costNetworkAttribute is null

java.lang.IllegalArgumentException - if count is less than one

java.lang.IllegalArgumentException - if assetTypes is null

java.lang.IllegalArgumentException - if categories is null

java.lang.IllegalArgumentException - if both assetTypes and categories are empty

Since:

100.8.0

getCostNetworkAttribute

public UtilityNetworkAttribute getCostNetworkAttribute()

Gets the UtilityNetworkAttribute used to determine the definition of "nearest".

Returns:

the utility network attribute

Since:

100.8.0

getCount

public int getCount()

Gets the number of nearest features to return.

Returns:

the number of nearest features

Since:

100.8.0

getAssetTypes

public java.util.List<UtilityAssetType> getAssetTypes()

Gets an unmodifiable list of UtilityAssetType that are used to define features to return. This may be an empty list if created empty with createWithAssetTypesAndCategories(UtilityNetworkAttribute, int, Iterable<UtilityAssetType>, Iterable<UtilityCategory>) or if createWithCategories(UtilityNetworkAttribute, int, Iterable<UtilityCategory>) was used to create an instance of this class.

Returns:

an unmodifiable list of UtilityAssetType that are used to define features

Since:

100.8.0

getCategories

public java.util.List<UtilityCategory> getCategories()

Gets an unmodifiable list of UtilityCategory that are used to define features to return. This may be an empty list if created empty with createWithAssetTypesAndCategories(UtilityNetworkAttribute, int, Iterable<UtilityAssetType>, Iterable<UtilityCategory>) or if createWithAssetTypes(UtilityNetworkAttribute, int, Iterable<UtilityAssetType>) was used to create an instance of this class.

Returns:

an unmodifiable list of UtilityCategory that are used to define features

Since:

100.8.0