特定のルートの回避

有料道路の回避機能

この機能では、ルートに有料道路を含めるかどうかを選択できます。これは文字列パラメータです。SOAP リクエストで avoid パラメータに値として tollroad を指定できます。この値を指定すると、ルート計算の結果として有料道路を除外したルートが返されます。以下の例では、このパラメータの使用方法を示します。

有料道路の回避指定がある例

以下では、あるルートに対する想像上のポイントを使用してこの機能の例を示します。リクエストには、<v1:Avoid>tollroad</v1:Avoid> という有料道路の回避パラメータが含まれています。

<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="?">

         <!--Optional:-->
         <v1:DatasetResourceName>${#Project#TollRoad_DB}</v1:DatasetResourceName>
    
         <v1:StartPoints srsName="epsg:4326">

         <!--Zero or more repetitions:-->
            <v11:Point srsName="epsg:4326">
            <v11:Pos>
               <v11:X>12.822214</v11:X>
               <v11:Y>47.282809</v11:Y>
            </v11:Pos>
         </v11:Point>
   </v1:StartPoints>
           
   <v1:EndPoints srsName="epsg:4326">
           <!--Zero or more repetitions:-->
           <v11:Point srsName="epsg:4326">
              <v11:Pos>
                 <v11:X>12.873852</v11:X>
                 <v11:Y>46.871467</v11:Y>
              </v11:Pos>
            </v11:Point<
     </v1:EndPoints>

      <v1:DistanceUnit>Mile</v1:DistanceUnit>
      <v1:TimeUnit>Minute</v1:TimeUnit>
      <v1:ReturnOptimalRoutesOnly>true</v1:ReturnOptimalRoutesOnly>
      <v1:OptimizeBy>distance</v1:OptimizeBy>
      <v1:MajorRoads>false</v1:MajorRoads>
      <v1:ReturnDistance>true</v1:ReturnDistance>
      <v1:ReturnTime>true</v1:ReturnTime>
      <v1:Avoid>tollroad</v1:Avoid>
      <v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
   </v1:RouteCostMatrixRequest>
</soapenv:Body>
</soapenv:Envelope>

有料道路の回避指定がない例

以下では、あるルートに対する想像上のポイントを使用してこの機能の例を示します。リクエストには、有料道路の回避パラメータが含まれていません。

<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="?">

      <!--Optional:-->
      <v1:DatasetResourceName>${#Project#TollRoad_DB}</v1:DatasetResourceName>
      <v1:StartPoints srsName="epsg:4326">
    
          <!--Zero or more repetitions:-->
          <v11:Point srsName="epsg:4326">
             <v11:Pos>
                <v11:X>12.822214</v11:X>
                <v11:Y>47.282809</v11:Y>
             </v11:Pos>
          </v11:Point>
      </v1:StartPoints>
           
      <v1:EndPoints srsName="epsg:4326">
         <!--Zero or more repetitions:-->
         <v11:Point srsName="epsg:4326">
             <v11:Pos>
                  <v11:X>12.873852</v11:X>
                  <v11:Y>46.871467</v11:Y>
              </v11:Pos>
            </v11:Point>
         </v1:EndPoints>

         <v1:DistanceUnit>Mile</v1:DistanceUnit>
         <v1:TimeUnit>Minute</v1:TimeUnit>
         <v1:ReturnOptimalRoutesOnly>true</v1:ReturnOptimalRoutesOnly>
         <v1:OptimizeBy>distance</v1:OptimizeBy>
         <v1:MajorRoads>false</v1:MajorRoads>
         <v1:ReturnDistance>true</v1:ReturnDistance>
         <v1:ReturnTime>true</v1:ReturnTime>
         <v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
      </v1:RouteCostMatrixRequest>
   </soapenv:Body>
</soapenv:Envelope>