GetTravelDirections (Legacy)

重要: このステージは 12.1 リリースで非推奨になっています。新しいデータフローを作成するときは、代わりに Get Route ステージを使用してください。

GetTravelDirections は、2 つのポイントまたは複数のポイントに対するルーティング情報を返します。始点の緯度/経度と終点の緯度/経度を入力として受け取り、ステージの設定方法によって、最速または最短ルートを返します。

国ごとに、Enterprise Routing モジュール -<国> という形式の名前が付けられた固有のデータベースがあります。各データベースには、固有の国コードも付与されています。例えば、オーストリアのデータベースの名前は、"Enterprise Routing モジュール - オーストリア" で、オーストリアのバッチ国コードは "A1T" です。データベースごとに個別のライセンスが必要です。

注: Get Travel Directions は、SOAP Web サービスとしてのみ利用可能です。Get Travel Directions を、REST を介して利用することはできません。Java、C++、C、.NET、または COM API を介して利用することもできません。

GetTravelDirections は、Enterprise Routing モジュールに含まれています。

リソース URL

http://server:port/soap/GetTravelDirections

例

SOAP リクエストを以下に示します。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetTravelDirections"
xmlns:typ="http://www.g1.com/services/erm/types">
   <soapenv:Header/>
   <soapenv:Body>
      <get:GetTravelDirectionsRequest>
         <get:input_port>
            <get:PointToPointRequest>
               <get:RoutePoints>
                  <get:RoutePoint>
                     <get:Latitude>33.751748</get:Latitude>                            
                     <get:Longitude>-84.364014</get:Longitude>
                  </get:RoutePoint>
                   <get:RoutePoint>
                     <get:Latitude>33.664925</get:Latitude>
                     <get:Longitude>-80.90332</get:Longitude>
                  </get:RoutePoint>
               </get:RoutePoints>
            </get:PointToPointRequest>
         </get:input_port>
      </get:GetTravelDirectionsRequest>
   </soapenv:Body>
</soapenv:Envelope>

応答は次のようになります。

注: この例では、短縮のため一部の道順が削除されています。

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns6:GetTravelDirectionsResponse xmlns:ns2="http://spectrum.pb.com/" xmlns:ns3="http://www.g1.com/services/erm/types" xmlns:ns4="http://www.g1.com/services/GetTravelDirections" xmlns:ns5="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns6="http://www.pb.com/spectrum/services/GetTravelDirections">
         <ns6:output_port>
            <ns6:PointToPointResponse>
               <ns6:Time>215.82</ns6:Time>
               <ns6:TimeUnits>Minutes</ns6:TimeUnits>
               <ns6:Distance>218.441</ns6:Distance>
               <ns6:DistanceUnits>Miles</ns6:DistanceUnits>
               <ns6:Format>Normal</ns6:Format>
               <ns6:Language>en</ns6:Language>
               <ns6:RouteDirections>
                  <ns6:RouteDirection>
                     <ns6:Instruction/>
                     <ns6:Time>0.03</ns6:Time>
                     <ns6:TimeUnits>Minutes</ns6:TimeUnits>
                     <ns6:Distance>0.013</ns6:Distance>
                     <ns6:DistanceUnits>Miles</ns6:DistanceUnits>
                  </ns6:RouteDirection>
                  <ns6:RouteDirection>
                     <ns6:Instruction>Turn left on Short St SE and travel South 0.10 mi (0.3 min).</ns6:Instruction>
                     <ns6:Time>0.28</ns6:Time>
                     <ns6:TimeUnits>Minutes</ns6:TimeUnits>
                     <ns6:Distance>0.099</ns6:Distance>
                     <ns6:DistanceUnits>Miles</ns6:DistanceUnits>
                  </ns6:RouteDirection>
                 ...
                  <ns6:RouteDirection>
                     <ns6:Instruction>Turn left on Un-named street and travel East 0.11 mi (0.2 min).</ns6:Instruction>
                     <ns6:Time>0.2</ns6:Time>
                     <ns6:TimeUnits>Minutes</ns6:TimeUnits>
                     <ns6:Distance>0.105</ns6:Distance>
                     <ns6:DistanceUnits>Miles</ns6:DistanceUnits>
                  </ns6:RouteDirection>
                  <ns6:RouteDirection>
                     <ns6:Instruction>Turn right to reach your destination to the East.</ns6:Instruction>
                     <ns6:Time>0.33</ns6:Time>
                     <ns6:TimeUnits>Minutes</ns6:TimeUnits>
                     <ns6:Distance>0.167</ns6:Distance>
                     <ns6:DistanceUnits>Miles</ns6:DistanceUnits>
                  </ns6:RouteDirection>
               </ns6:RouteDirections>
               <ns6:user_fields/>
            </ns6:PointToPointResponse>
         </ns6:output_port>
      </ns6:GetTravelDirectionsResponse>
   </soap:Body>
</soap:Envelope>