GetTravelBoundary

説明

GetTravelBoundary は、ロケーションから一定の走行/歩行時間または距離で到達可能なエリアの境界を示します。この操作は、時間到達圏または距離到達圏の計算に基づくポリゴンを返します。時間到達圏とは、始点から一定時間内に道路を通って到達できるエリアを表すポリゴンまたはポイントの集まりです。距離到達圏とは、始点から一定距離の移動で到達できるエリアを表すポリゴンまたはポイントの集まりです。GetTravelBoundary 操作 (到達圏検索とも呼ばれます) は、始点、単位 (距離または時間)、および 1 つ以上のコストを入力として受け取り、生成された到達圏(ポリゴン)を返します。コストとは、到達圏計算に使用する時間または距離の値を意味します。

サービスの URL 形式

Routing SOAP サービスの URL エンドポイントの一般的な形式は次のとおりです。

http://server:port/soap/RoutingService

Routing WSDL の URL の一般的な形式は次のとおりです。

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

メッセージ

次の表に、GetTravelBoundary 操作のリクエストメッセージとレスポンスメッセージを示します。

メッセージ名をクリックすると、メッセージの詳細を確認できます。


メッセージ	説明
GetTravelBoundaryRequest	GetTravelBoundary 操作のリクエストメッセージ。
GetTravelBoundaryResponse	GetTravelBoundary 操作のレスポンスメッセージ。

単一コストの例

単一のコストを持つ経路境界のリクエストです。

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 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" xmlns:v12="http://www.mapinfo.com/midev/service/units/v1">
 
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetTravelBoundaryRequest id="">
      <v1:DatasetResourceName>US</v1:DatasetResourceName>
         <v1:Point srsName="epsg:4326">
         <v1:Point srsName="epsg:4326">
            <v11:Pos>
               <v11:X>-74.099876</v11:X>
               <v11:Y>40.814618</v11:Y>
             </v11:Pos>
         </v1:Point>
         <v1:Costs>            
         <v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
         <v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">5</v1:Time>
         </v1:Cost>      
         </v1:Costs>
         <!--optionals-->
        <v1:BandingStyle>Donut</v1:BandingStyle>
           <v1:MaxOffroadDistance uom="Mile">1</v1:MaxOffroadDistance>
           <v1:ReturnHoles>false</v1:ReturnHoles>
           <v1:ReturnIslands>false</v1:ReturnIslands>
           <v1:SimplificationFactor>0.5</v1:SimplificationFactor>
           <v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
           <v1:MajorRoads>true</v1:MajorRoads>
           <v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>

         <v1:AmbientSpeeds>
            <v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessSuburban</v1:AmbientSpeedRoadType>
               <v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
               	<v12:Speed uom="KPH">30</v12:Speed>
               </v1:AmbientSpeedCost>
            </v1:AmbientCostEntry>
            <v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessRural</v1:AmbientSpeedRoadType>
               <v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
               	<v12:Speed uom="MPH">30</v12:Speed>
               </v1:AmbientSpeedCost>
            </v1:AmbientCostEntry>  
	</v1:AmbientSpeeds>
	<!--optionals-->
      </v1:GetTravelBoundaryRequest>
   </soapenv:Body>
</soapenv:Envelope>

単一のコストを持つ経路境界のレスポンスです。

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <GetTravelBoundaryResponse xmlns="http://www.mapinfo.com/routing/service/v1" xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns3="http://www.mapinfo.com/midev/service/units/v1" xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/routing/service/common/v1">
         <TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ns2:MultiPolygon srsName="epsg:4326">
               <ns2:Polygon srsName="epsg:4326">
                  <ns2:Exterior>
                     <ns2:LineString>
                        <ns2:Pos>
                           <ns2:X>-74.12239074707031</ns2:X>
                           <ns2:Y>40.78827667236328</ns2:Y>
                        </ns2:Pos>
                        <ns2:Pos>
                           <ns2:X>-74.1226806640625</ns2:X>
                           <ns2:Y>40.788719177246094</ns2:Y>
                        </ns2:Pos>
                        	…….
                        <ns2:Pos>
                           <ns2:X>-74.1220932006836</ns2:X>
                           <ns2:Y>40.78827667236328</ns2:Y>
                        </ns2:Pos>
                        <ns2:Pos>
                           <ns2:X>-74.12239074707031</ns2:X>
                           <ns2:Y>40.78827667236328</ns2:Y>
                        </ns2:Pos>
                     </ns2:LineString>
                  </ns2:Exterior>
               </ns2:Polygon>
            </ns2:MultiPolygon>
            <IsoChroneCost>
               <ns3:Time uom="Minute">5.0</ns3:Time>
            </IsoChroneCost>
         </TravelBoundary>
      </GetTravelBoundaryResponse>
   </soap:Body>
</soap:Envelope>

複数コストの例

複数のコストを持つ経路境界のリクエストです。

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 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" xmlns:v12="http://www.mapinfo.com/midev/service/units/v1">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:GetTravelBoundaryRequest id="" lang="">
      <v1:DatasetResourceName>US</v1:DatasetResourceName>
         <v1:Point srsName="epsg:4326">
        <v1:Point srsName="epsg:4326">
            <v11:Pos>
               <v11:X>-74.099876</v11:X>
               <v11:Y>40.814618</v11:Y>
             </v11:Pos>
         </v1:Point>
         <v1:Costs>            
         <v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
         <v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">5</v1:Time>
         </v1:Cost>
         <v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">15</v1:Time>
        </v1:Cost>
        <v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">20</v1:Time>
        </v1:Cost>
        <v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">13</v1:Time>         
        </v1:Cost>
        </v1:Costs>
<!--optionals-->
        <v1:BandingStyle>Donut</v1:BandingStyle>
        <v1:MaxOffroadDistance uom="Mile">1</v1:MaxOffroadDistance>
        <v1:ReturnHoles>false</v1:ReturnHoles>
        <v1:ReturnIslands>false</v1:ReturnIslands>
        <v1:SimplificationFactor>0.5</v1:SimplificationFactor>
        <v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
        <v1:MajorRoads>true</v1:MajorRoads>
        <v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>

        <v1:AmbientSpeeds>
           <v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessSuburban</v1:AmbientSpeedRoadType>
           <v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
               	<v12:Speed uom="KPH">30</v12:Speed>
           </v1:AmbientSpeedCost>
          </v1:AmbientCostEntry>

          <v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessRural</v1:AmbientSpeedRoadType>
          <v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
               	<v12:Speed uom="MPH">30</v12:Speed>
             </v1:AmbientSpeedCost>
            </v1:AmbientCostEntry>
         </v1:AmbientSpeeds>
<!--optionals-->
       </v1:GetTravelBoundaryRequest>
   </soapenv:Body>
</soapenv:Envelope>

複数のコストを持つ経路境界のレスポンスです。

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <GetTravelBoundaryResponse xmlns="http://www.mapinfo.com/routing/service/v1" xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns3="http://www.mapinfo.com/midev/service/units/v1" xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/routing/service/common/v1">
         <TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ns2:MultiPolygon srsName="epsg:4326">
               <ns2:Polygon srsName="epsg:4326">
                  <ns2:Exterior>
                     <ns2:LineString>
                        <ns2:Pos>
                           <ns2:X>-74.12239074707031</ns2:X>
                           <ns2:Y>40.78827667236328</ns2:Y>
                        </ns2:Pos>
                        <ns2:Pos>
                           <ns2:X>-74.1226806640625</ns2:X>
                           <ns2:Y>40.788719177246094</ns2:Y>
                        </ns2:Pos>
                       		......
	
                           <ns2:Pos>
                              <ns2:X>-74.1853168033443</ns2:X>
                              <ns2:Y>40.65807664011055</ns2:Y>
                           </ns2:Pos>
                           <ns2:Pos>
                              <ns2:X>-74.18765315676006</ns2:X>
                              <ns2:Y>40.65807664011055</ns2:Y>
                           </ns2:Pos>
                        </ns2:LineString>
                     </ns2:Ring>
                  </ns2:InteriorList>
               </ns2:Polygon>
            </ns2:MultiPolygon>
            <IsoChroneCost>
               <ns3:Time uom="Minute">20.0</ns3:Time>
            </IsoChroneCost>
         </TravelBoundary>
         <TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ns2:MultiPolygon srsName="epsg:4326">
               <ns2:Polygon srsName="epsg:4326">
                  <ns2:Exterior>
                     <ns2:LineString>
                        <ns2:Pos>
                           <ns2:X>-74.1646741097915</ns2:X>
                           <ns2:Y>40.686006605152414</ns2:Y>
                        </ns2:Pos>
                        <ns2:Pos>
                           <ns2:X>-74.1646741097915</ns2:X>
                           <ns2:Y>40.68675357686172</ns2:Y>
                        </ns2:Pos>
                       		.......
		
                           <ns2:Pos>
                              <ns2:X>-74.1220932006836</ns2:X>
                              <ns2:Y>40.78827667236328</ns2:Y>
                           </ns2:Pos>
                           <ns2:Pos>
                              <ns2:X>-74.12239074707031</ns2:X>
                              <ns2:Y>40.78827667236328</ns2:Y>
                           </ns2:Pos>
                        </ns2:LineString>
                     </ns2:Ring>
                  </ns2:InteriorList>
               </ns2:Polygon>
            </ns2:MultiPolygon>
            <IsoChroneCost>
               <ns3:Time uom="Minute">13.0</ns3:Time>
            </IsoChroneCost>
         </TravelBoundary>
      </GetTravelBoundaryResponse>
   </soap:Body>
</soap:Envelope>