GetTravelBoundary (Deprecated)
Important: This stage has been deprecated in the 12.2 release. TheTravel Boundary stage should be used instead
when creating new dataflows.
GetTravelBoundary determines a drive or walk time or distance boundary from a location. This feature obtains polygons corresponding to an isochrone or isodistance calculation. An isochrone is a polygon or set of points representing an area that can be traversed in a network from a starting point in a given amount of time. An isodistance is a polygon or set of points representing the area that is a certain distance from the starting point. The Get Travel Boundary operation (also known as an iso definition) takes a starting point, a unit (linear or time), one or more costs and their associated tags as input and returns the resulting travel boundary. Cost refers to the amount of time or distance to use in calculating an iso. A tag is a string that identifies the cost and is used to match the corresponding result. Multiple costs can be given as input by providing the costs as a “;” delimited string.
GetTravelBoundary is part of Spectrum Spatial.
Note: GetTravelBoundary is only available as a web service. GetTravelBoundary is not available
through the Java, C++, C, .NET, or COM APIs.
Resource URL
http://server:port/soap/GetTravelBoundaryhttps://OnDemandServer/soap/GetTravelBoundaryFor a list of Spectrum OnDemand servers, see ../../../OnDemand/source/GettingStarted/AccessingServices.dita.
Example
Case 1, Single Cost:
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetTravelBoundary">
<soapenv:Header/>
<soapenv:Body>
<get:GetTravelBoundaryRequest>
<!--Optional:-->
<get:input_port>
<get:IsoRouteRequest>
<!--Optional:-->
<get:Latitude>33.751748</get:Latitude>
<!--Optional:-->
<get:Longitude>-84.364014</get:Longitude>
<!--Optional:-->
<get:TravelBoundaryCost>10</get:TravelBoundaryCost>
<!--Optional:-->
<get:TravelBoundaryCostUnits>Kilometers</get:TravelBoundaryCostUnits>
<!--Optional:-->
<get:user_fields>
<get:user_field>
<get:name>?</get:name>
<get:value>?</get:value>
</get:user_field>
</get:user_fields>
</get:IsoRouteRequest>
</get:input_port>
</get:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>
This would be the response:
Note: Some of the points have been removed from this example to shorten it.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns4:GetTravelBoundaryResponse xmlns:ns2="http://spectrum.pb.com/"
xmlns:ns3="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns4="http://<server>:<port>/spectrum/services/GetTravelBoundary">
<ns4:output_port>
<ns4:IsoRouteResponse>
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
</ns4:output_port>
</ns4:GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>Case 2, Multiple Costs:
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetTravelBoundary">
<soapenv:Header/>
<soapenv:Body>
<get:GetTravelBoundaryRequest>
<!--Optional:-->
<get:input_port>
<get:IsoRouteRequest>
<!--Optional:-->
<get:Latitude>33.751748</get:Latitude>
<!--Optional:-->
<get:Longitude>-84.364014</get:Longitude>
<!--Optional:-->
<get:TravelBoundaryCost>5;10</get:TravelBoundaryCost>
<!--Optional:-->
<get:TravelBoundaryCostUnits>Kilometers</get:TravelBoundaryCostUnits>
<!--Optional:-->
<get:user_fields>
<get:user_field>
<get:name>?</get:name>
<get:value>?</get:value>
</get:user_field>
</get:user_fields>
</get:IsoRouteRequest>
</get:input_port>
</get:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>
This would be the response:
Note: Some of the points have been removed from this example to shorten it.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns4:GetTravelBoundaryResponse xmlns:ns2="http://spectrum.com/"
xmlns:ns3="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns4="http://<server>:<port>/spectrum/services/GetTravelBoundary">
<ns4:output_port>
<ns4:IsoRouteResponse>
<ns4:cost>5</ns4:cost>
<ns4:costUnits>Kilometers</ns4: costUnits >
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
<ns4:IsoRouteResponse>
<ns4:cost>10</ns4:cost>
<ns4:costUnits>Kilometers</ns4: costUnits >
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
</ns4:output_port>
</ns4:GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>