GetRouteCostMatrix

Description

GetRouteCostMatrix calculates the travel time and distances between an array of start and end locations and returns the route that is either the fastest or the shortest. The result determines the total time and distance of the individual routes (the route costs). For example if you input four start points and four end points, a total of 16 routes will be calculated.

The GetRouteCostMatrix operation also supports transient updates, that allow you to perform per-request based road network updates for your calculations. For more information on transient updates, see Adding Transient Updates to GetRouteCostMatrix

Service URL Formats

The URL endpoint for the Routing SOAP service has the following general form:

http://server:port/soap/RoutingService

The URL for the Routing WSDL has the following general form:

http://server:port/soap/RoutingService?wsdl

Messages

The following table lists the request and response messages for the GetRouteCostMatrix operation.

Click on a message name to get more information about the message.

Message Description
RouteCostMatrixRequest The request message for the GetRouteCostMatrix operation.
RouteCostMatrixResponse The response message for the GetRouteCostMatrix operation.

Single Start and End Point Example

Request for a cost matrix with a single start and end point.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:v1="http://www.mapinfo.com/routing/service/v1" xmlns:v11="http://www.mapinfo.com/midev/service/geometries/v1">
	<soapenv:Header />
	<soapenv:Body>
		<v1:RouteCostMatrixRequest id="?" locale="?">
			<v1:DatasetResourceName>US_NE</v1:DatasetResourceName>
			<v1:StartPoints srsName="epsg:4326">
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.150620</v11:X>
						<v11:Y>41.057343</v11:Y>
					</v11:Pos>
				</v11:Point>
			</v1:StartPoints>
			<v1:EndPoints srsName="epsg:4326">
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.946153</v11:X>
						<v11:Y>42.010112</v11:Y>
					</v11:Pos>
				</v11:Point>
			</v1:EndPoints>
			<v1:DistanceUnit>km</v1:DistanceUnit>
			<v1:TimeUnit>Second</v1:TimeUnit>
			<v1:ReturnOptimalRoutesOnly>true</v1:ReturnOptimalRoutesOnly>
			<v1:OptimizeBy>time</v1:OptimizeBy>
			<v1:MajorRoads>true</v1:MajorRoads>
			<v1:ReturnDistance>true</v1:ReturnDistance>
			<v1:ReturnTime>true</v1:ReturnTime>
			<v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
			<v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
			<v1:RoadTypePreferences>
				<v12:RoadTypesPrefEntry xmlns:v12="http://www.mapinfo.com/routing/service/common/v1">
					<v12:RoadTypes>limited access dense urban</v12:RoadTypes>
					<v12:RoadTypesPref>None</v12:RoadTypesPref>
				</v12:RoadTypesPrefEntry>
			</v1:RoadTypePreferences>
		</v1:RouteCostMatrixRequest>
	</soapenv:Body>
</soapenv:Envelope>

Response for a cost matrix with a single start and end point.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <RouteCostMatrixResponse xmlns="http://www.mapinfo.com/routing/service/v1" xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns3="http://www.mapinfo.com/routing/service/common/v1" xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/midev/service/units/v1">
         <Matrix>
            <Time uom="Second">5704.0</Time>
            <Distance uom="km">164.479</Distance>
            <StartPoint srsName="epsg:4326">
               <ns2:Pos>
                  <ns2:X>-74.15062</ns2:X>
                  <ns2:Y>41.057343</ns2:Y>
               </ns2:Pos>
            </StartPoint>
            <EndPoint srsName="epsg:4326">
               <ns2:Pos>
                  <ns2:X>-74.946153</ns2:X>
                  <ns2:Y>42.010112</ns2:Y>
               </ns2:Pos>
            </EndPoint>
         </Matrix>
      </RouteCostMatrixResponse>
   </soap:Body>
</soap:Envelope>

Multiple Start and End Point Example

Request for a cost matrix with two start and end point.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:v1="http://www.mapinfo.com/routing/service/v1" xmlns:v11="http://www.mapinfo.com/midev/service/geometries/v1">
	<soapenv:Header />
	<soapenv:Body>
		<v1:RouteCostMatrixRequest id="?" locale="?">
			<v1:DatasetResourceName>US_NE</v1:DatasetResourceName>
			<v1:StartPoints srsName="epsg:4326">
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.150620</v11:X>
						<v11:Y>41.057343</v11:Y>
					</v11:Pos>
				</v11:Point>
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.250620</v11:X>
						<v11:Y>41.357343</v11:Y>
					</v11:Pos>
				</v11:Point>
			</v1:StartPoints>
			<v1:EndPoints srsName="epsg:4326">
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.946153</v11:X>
						<v11:Y>42.010112</v11:Y>
					</v11:Pos>
				</v11:Point>
				<v11:Point srsName="epsg:4326">
					<v11:Pos>
						<v11:X>-74.946153</v11:X>
						<v11:Y>42.010112</v11:Y>
					</v11:Pos>
				</v11:Point>
			</v1:EndPoints>
			<v1:DistanceUnit>km</v1:DistanceUnit>
			<v1:TimeUnit>Second</v1:TimeUnit>
			<v1:ReturnOptimalRoutesOnly>true</v1:ReturnOptimalRoutesOnly>
			<v1:OptimizeBy>time</v1:OptimizeBy>
			<v1:MajorRoads>true</v1:MajorRoads>
			<v1:ReturnDistance>true</v1:ReturnDistance>
			<v1:ReturnTime>true</v1:ReturnTime>
			<v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
			<v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
			<v1:RoadTypePreferences>
				<v11:RoadTypesPrefEntry>
					<v11:RoadTypes>limited access dense urban</v11:RoadTypes>
					<v11:RoadTypesPref>None</v11:RoadTypesPref>
				</v11:RoadTypesPrefEntry>
			</v1:RoadTypePreferences>
		</v1:RouteCostMatrixRequest>
	</soapenv:Body>
</soapenv:Envelope>

Response for a Travel boundary with multiple costs.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
	<soap:Body>
		<RouteCostMatrixResponse xmlns="http://www.mapinfo.com/routing/service/v1"
			xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1"
			xmlns:ns3="http://www.mapinfo.com/routing/service/common/v1"
			xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/midev/service/units/v1">
			<Matrix>
				<Time uom="Second">5704.0</Time>
				<Distance uom="km">164.479</Distance>
				<StartPoint srsName="epsg:4326">
					<ns2:Pos>
						<ns2:X>-74.15062</ns2:X>
						<ns2:Y>41.057343</ns2:Y>
					</ns2:Pos>
				</StartPoint>
				<EndPoint srsName="epsg:4326">
					<ns2:Pos>
						<ns2:X>-74.946153</ns2:X>
						<ns2:Y>42.010112</ns2:Y>
					</ns2:Pos>
				</EndPoint>
			</Matrix>
			<Matrix>
				<Time uom="Second">4087.0</Time>
				<Distance uom="km">119.585</Distance>
				<StartPoint srsName="epsg:4326">
					<ns2:Pos>
						<ns2:X>-74.25062</ns2:X>
						<ns2:Y>41.357343</ns2:Y>
					</ns2:Pos>
				</StartPoint>
				<EndPoint srsName="epsg:4326">
					<ns2:Pos>
						<ns2:X>-74.946153</ns2:X>
						<ns2:Y>42.010112</ns2:Y>
					</ns2:Pos>
				</EndPoint>
			</Matrix>
		</RouteCostMatrixResponse>
	</soap:Body>
</soap:Envelope>