GetRouteData

GetRouteData は、ポイントまたはセグメント ID のルートセグメント情報を返します。ポイントを指定すると、最も近いルートセグメントが返されます。セグメント ID を指定すると、そのセグメント ID に対応するルートセグメントが返されます。

注: Get Route Data は、サービス (Management Console および SOAP Web サービス) としてのみ利用可能です。Get Route Data は、ステージまたは REST API を介して利用することはできません。Java、C++、C、.NET、または COM API を介して利用することもできません。

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

リソース URL

http://サーバー:ポート/soap/GetRouteData

例

SOAP 要求を以下に示します。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="http://www.g1.com/services/GetRouteData">
   <soapenv:Header/>
   <soapenv:Body>
      <get:GetRouteDataRequest>
         <get:options>
            <get:DataSetResourceName>US</get:DataSetResourceName>
            <get:CoordinateSystem>epsg:4326</get:CoordinateSystem>
         </get:options>
         <get:rows>
            <get:row>
               <get:RoutingData>
                  <get:RouteDataPoint>
                     <get:Longitude>-74.843</get:Longitude>
                     <get:Lattitude>40.0077</get:Lattitude>
                  </get:RouteDataPoint>
               </get:RoutingData>
            </get:row>
         </get:rows>
      </get:GetRouteDataRequest>
   </soapenv:Body>
</soapenv:Envelope>

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

注: この例では、簡略化のため一部のセグメントが割愛されています。

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <GetRouteDataResponse xmlns="http://www.g1.com/services/GetRouteData">
         <rows>
            <row>
               <Segments>
                  <SegmentDetails>
                     <Segment>
                        <RoutingSegmentID>b81740d3:4b3526</RoutingSegmentID>
                        <SegmentData>
                           <PrimaryName>New Jersey Tpke S</PrimaryName>
                           <PrimaryNameLanguage>en</PrimaryNameLanguage>
                           <AlternateNameList>
                              <AlternateName>
                                 <Name>New Jersey Tpke S</Name>
                                 <Language>en</Language>
                              </AlternateName>
                           </AlternateNameList>
                           <SegmentLength>8.397</SegmentLength>
                           <SegmentLengthUnit>Miles</SegmentLengthUnit>
                           <TimeTaken>7.866666666666666</TimeTaken>
                           <TimeUnit>Minutes</TimeUnit>
                           <TurnAngle>0.0</TurnAngle>
                           <TurnAngleUnit>degree</TurnAngleUnit>
                           <CompassDirection/>
                           <speedOfTravel>64.01366022429013</speedOfTravel>
                           <speedOfTravelUnit>Miles/hour</speedOfTravelUnit>
                           <RoadType>primary highway rural</RoadType>
                           <SegmentDirection>from_to</SegmentDirection>
                           <StartJunctionType>Other</StartJunctionType>
                           <EndJunctionType/>
                           <IsRoundabout>false</IsRoundabout>
                           <IsTollRoad>true</IsTollRoad>
                           <PointsInSegment>
                              <RouteDataPoint>
                                 <Longitude>-74.823861</Longitude>
                                 <Lattitude>40.024421</Lattitude>
                              </RouteDataPoint>
                              <RouteDataPoint>
                                 <Longitude>-74.824133</Longitude>
                                 <Lattitude>40.024149</Lattitude>
                              </RouteDataPoint>
							  ...
                           </PointsInSegment>
                        </SegmentData>
                     </Segment>
                  </SegmentDetails>
               </Segments>
            </row>
         </rows>
      </GetRouteDataResponse>
   </soap:Body>
</soap:Envelope>