GetTravelBoundary HTTP POST Options - web_services - 23.1

Spectrum Web Services Guide

Product type
Software
Portfolio
Integrate
Product family
Spectrum
Product
Spectrum > Web Services
Version
23.1
Language
English
Product name
Spectrum Technology Platform
Title
Spectrum Web Services Guide
First publish date
2007
Last updated
2024-10-17
Published on
2024-10-17T00:33:46.811413

HTTP POST URL Format

In addition to the regular HTTP GET parameters, you can add an HTTP POST payload option to your request that specifies ambient speed changes for road types. The content type must be set to application/json. The following format is used for HTTP POST requests:

HTTP POST:  /rest/Spatial/erm/databases/dbsource.json?q=travelBoundary&query_parameters
POST BODY: Content-Type:application/json {Route Data}			
Route Data is the POST json body (Content-Type: application/json) for the additional route information to be used in the calculation containing ambient speeds for road types.

Ambient Speeds

This set of preferences allows you to set ambient speed changes for each request. An ambient speed is a change to the speed in the normal data to travel off a network road when finding the travel boundary. Examples of off-network travel include driveways and access roads. The following is a description of the ambient speed parameters:

Parameter

Description

DefaultAmbientSpeed

Specifies the speed to travel when going off a network road to find the travel boundary (for all road types). To control how off-network travel is used in the travel boundary calculation, you need to specify the speed of travel off the road network (the ambient speed). Ambient speed can affect the size and shape of the travel boundary polygon. In general, the faster the ambient speed, the larger the polygon. For example, if you were at a point with 5 minutes left, and if the ambient speed were 15 miles per hour, boundary points would be put at a distance of 1.25 miles. If the ambient speed were reduced to 10 miles per hour, boundary points would be put at a distance of 0.83 miles.
Note: Default DefaultAmbientSpeed is 15

AmbientSpeedUnit

Specifies the unit of measure to calculate the ambient speed. Available speed units are:
  • MPH (miles per hour)
  • KPH (kilometers per hour)
  • MTPS (meters per second)
  • MTPM (meters per minute)
Note: Default AmbientSpeedUnit is MPH

AmbientSpeed.RoadType

Specifies the ambient speed to use for off-network travel based on the road type. You must specify both the road type and the new speed for that road type. The speed is defined in the defined AmbientSpeedUnit. Road types can be returned in all supported types. The following road types can be used:

  • access way
  • back road
  • connector
  • ferry
  • footpath
  • limited access dense urban
  • limited access rural
  • limited access suburban
  • limited access urban
  • local road dense urban
  • local road rural
  • local road suburban
  • local road urban
  • major local road dense urban
  • major local road rural
  • major local road suburban
  • major local road urban
  • major road dense urban
  • major road rural
  • major road suburban
  • major road urban
  • minor local road dense Urban
  • minor local road rural
  • minor local road suburban
  • minor local road urban
  • normal road dense urban
  • normal road rural
  • normal road rural
  • normal road urban
  • primary highway dense urban
  • primary highway rural
  • primary highway suburban
  • primary highway urban
  • ramp dense urban
  • ramp limited access
  • ramp major road
  • ramp primary highway
  • ramp rural
  • ramp secondary highway
  • ramp urban
  • ramp suburban
  • secondary highway dense urban
  • secondary highway rural
  • secondary highway suburban
  • secondary highway urban
propagationFactor See Query Parameters for description of propagationFactor.
Note: This parameter is only supported in getTravelBoundary version 2 is specified.
RoadType Specifies the propagationFactor to use for off-network travel based on the road type. You must specify both the road type and the new value of propagationFactor for that road type. See propagationFactor to know more. Road types can be returned in all supported types. The following road types can be used:
  • access way
  • back road
  • connector
  • ferry
  • footpath
  • limited access dense urban
  • limited access rural
  • limited access suburban
  • limited access urban
  • local road dense urban
  • local road rural
  • local road suburban
  • local road urban
  • major local road dense urban
  • major local road rural
  • major local road suburban
  • major local road urban
  • major road dense urban
  • major road rural
  • major road suburban
  • major road urban
  • minor local road dense Urban
  • minor local road rural
  • minor local road suburban
  • minor local road urban
  • normal road dense urban
  • normal road rural
  • normal road rural
  • normal road urban
  • primary highway dense urban
  • primary highway rural
  • primary highway suburban
  • primary highway urban
  • ramp dense urban
  • ramp limited access
  • ramp major road
  • ramp primary highway
  • ramp rural
  • ramp secondary highway
  • ramp urban
  • ramp suburban
  • secondary highway dense urban
  • secondary highway rural
  • secondary highway suburban
  • secondary highway urban
Note: This parameter is only supported in getTravelBoundary version 2 is specified.
avoid Specifies a comma-separated list of road types to be avoided during travel boundary calculation. This is a String parameter. When a road type is provided as the value of the parameter, the boundary excludes that type of roads in the calculation. For example, if tollRoad is provided as the parameter value, the calculated boundary will have no toll roads.

Example with ambient speed parameters in HTTP POST payload in gettravelboundary version 1.

{
	"DefaultAmbientSpeed": 45,
	"AmbientSpeedUnit": "MPH"

	"AmbientSpeed.RoadType.PrimaryHighwayUrban": 15,
	"AmbientSpeed.RoadType.SecondaryHighwayUrban": 10
}

Example with ambient speed and propagationFactor parameters in HTTP POST payload in gettravelboundary version 2.

{
	"ambientSpeeds": {
		"defaultAmbientSpeed": 24,
		"ambientSpeedUnit": "MPH",
		"ambientSpeedOverrides": {
			"Primary Highway Urban": ".51",
			"Secondary Highway Urban": ".1"
		}
	},
	"propagationFactors": {

		"propagationFactor": "1",
		"propagationFactorOverrides": {
			"Primary Highway Urban": ".51",
			"Secondary Highway Urban": ".1"
		}
	}
}
{
	"ambientSpeeds": {
		"ambientSpeedOverrides": {
			"Primary Highway Urban": 25,
			"Secondary Highway Urban": 10
		}
	},
	"propagationFactors": {

		"propagationFactor": "0.2",
		"propagationFactorOverrides": {
			"Primary Highway Urban": "0.51",
			"Secondary Highway Urban": "0.1"
		}
	}
}
Note: The response from REST request will be in JSON format and the geometries will be of GEOJSON format.