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, yesseparate

    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)

    return(true)

endmacro

 

See Also:

AddLayerDB

AddTables

Calculate Tables

Caliper.Charts

CC.ModifyTableOperations

CC.Table

Clustering

Data.Finder

Data.Geocoder

PostgreSQLConnect

PostgreSQLCommand

Routing.Bands

Routing.Path

Routing.Router

Table

Utilities.Mail