Routing.Bands

Creates drive time and drive distance bands. Inherits from Routing.Router

Note

This function requires a HERE streets layer included with a Maptitude Country Package. For a list of available Country packages, please visit https://www2.caliper.com/store/product/maptitude-country-package/HERE country packages

Constructor

Routing.Bands()

Initializes a new instance of the Routing.Bands class with default settings.

Properties

Name	Type	Contents
CumulativeBands	bool	Optional. Default value is false
SeparateBands	bool	Optional. Default value is false
InboundBands	bool	Optional. Default value is false. It will create bands from the selected points
MajorHighwaySpeedLevel	int	Optional. Default value is 4. Defines speed level from 1 to 7, slow to fast
SecondaryHighwaySpeedLevel	int	Optional. Default value is 4. Defines speed level from 1 to 7, slow to fast
LocalHighwaySpeedLevel	int	Optional. Default value is 4. Defines speed level from 1 to 7, slow to fast
ArterialSpeedLevel	int	Optional. Default value is 4. Defines speed level from 1 to 7, slow to fast
LocalRoadSpeedLevel	int	Optional. Default value is 4. Defines speed level from 1 to 7, slow to fast
Minimize	string	The variable to minimize when calculating paths, either "Time" (the default) or "Distance"
Interval	int	Interval size in units of the variable to be minimized, default value is 15
BandMax	int	Maximum band size. Default value is 90. The resulting maximum band will always be a multiple of the Interval value and therefore may be smaller than the BandMax value requested by the user
CreateTheme	bool	Optional. Default value is false. If true, creates a color theme for the output layer

Methods

CreateBands(array opt)

Creates the travel bands

Option		Type	Description
opts		array
	Coords	array	Array of coordinates for the origin or destination of points
	FileName	string	Optional. Name of the band geographic file
	LayerName	string	Optional. Name of the output layer name

Example

macro "Bands"
on error do
ShowMessage(GetLastError())
return()
end
// Open a map of USA and zoom to Boston MA
if GetMap() = null then
Throw("Please open a map and zoom to Boston, MA")
// Geocode two addresses
finder = CreateObject("Data.Finder")
finder.SetRegion()
args.silent = true
args.address = "407 Marlborough Street"
args.city = "Boston MA"
p1 = finder.Find("ADDRESS", args)
args.silent = true
args.address = "1172 Beacon Street"
args.city = "Newton MA"
p2 = finder.Find("ADDRESS", args)
arr = {p1.Coord, p2.Coord}
c = CreateObject("Routing.Bands")
c.Minimize = "Time"
c.Interval = 10
c.BandMax = 20
c.CumulativeBands = "Yes" // null, yes, yes separate
c.CreateTheme = true
// pass speed adjustment factors" Level 1 - 7; 4 being normal speed
c.MajorHighwaySpeedLevel = 1
c.SecondaryHighwaySpeedLevel = 4
c.LocalHighwaySpeedLevel = 4
c.ArterialSpeedLevel = 4
c.LocalRoadSpeedLevel = 4
inputs = {Coords: arr, FileName: GetTempFileName("*.dbd"), LayerName : "MyBands"}
s = c.CreateBands(inputs)
RedrawMap()
return(true)
endmacro

See Also:

CC.ModifyTableOperations