========================================================= BuildNearestRoute - tries to build a route as close to the target as possible, even if there isn't a path to the final point. If supplied, search will return a node at least as far away as MinDist from vecThreat, but no farther than MaxDist. if MaxDist isn't supplied, it defaults to a reasonable value ======================================
source not stored for this graph (policy: none)
nothing calls this directly
no test coverage detected