GetRouteCostMatrix
説明
GetRouteCostMatrix は、始点と終点の間の移動時間と距離を計算し、最短時間または最短距離となるルートを返します。この結果は、個々のルートの合計時間と合計距離 (ルート コスト) を示します。例えば、4 つの始点と 4 つの終点を入力すると、合計 16 個のルートが計算されます。
GetRouteCostMatrix 操作は、要求ごとの道路網更新を計算で実行できる一時更新もサポートしています。一時更新の詳細については、GetRouteCostMatrix への一時更新の追加を参照してください。
サービスの URL 形式
Routing SOAP サービスの URL エンドポイントの一般的な形式は次のとおりです。
http://server:port/soap/RoutingService
Routing WSDL の URL の一般的な形式は次のとおりです。
http://server:port/soap/RoutingService?wsdl
メッセージ
次の表に、GetRouteCostMatrix 操作のリクエスト メッセージとレスポンス メッセージを示します。
メッセージ名をクリックすると、メッセージの詳細を確認できます。
メッセージ | 説明 |
---|---|
RouteCostMatrixRequest | GetRouteCostMatrix 操作のリクエスト メッセージ。 |
RouteCostMatrixResponse | GetRouteCostMatrix 操作のレスポンス メッセージ。 |
単一の始点および終点の例
単一の始点および終点を持つコスト マトリクスのリクエストです。
<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>
単一の始点および終点を持つコスト マトリクスのレスポンスです。
<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>
複数の始点および終点の例
2 つの始点および終点を持つコスト マトリクスのリクエストです。
<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>
複数のコストを持つ経路境界のレスポンスです。
<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>