GetTravelBoundary

Description

GetTravelBoundary détermine une limite de distance ou de temps de marche ou de conduite en voiture à partir d'un lieu. Cette opération renvoie des polygones correspondant à un calcul d'isochrone ou d'isodistance. Un isochrone est un polygone ou ensemble de points représentant une zone pouvant être traversée à partir d'un point de départ en un temps donné via un réseau routier. Un isodistance est un polygone ou ensemble de points représentant la zone située à une certaine distance par rapport à un point de départ. L'opération GetTravelBoundary (également appelée définition iso) prend comme entrée un point de départ, une unité (linéaire ou temporelle) et un ou plusieurs coûts et renvoie la limite de trajet à parcourir obtenue. Le coût fait référence au temps ou à la distance à utiliser pour calculer un iso.

Formats URL du service

L'URL de destination du service Routing SOAP suit la forme générale suivante :

http://<server>:<port>/soap/RoutingService

				

L'URL de Routing WSDL suit la forme générale suivante :

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

				

Messages

Le tableau suivant répertorie les messages de requête et de réponse de l'opération GetTravelBoundary.

Pour obtenir plus d'informations sur un message, cliquez sur son nom.

Exemple de coût unique

Requête de limite de trajet avec un seul coût.

<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>


			

Réponse de limite de trajet avec un seul coût.

<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>	
			
			

Exemple de plusieurs coûts

Requête de limite de trajet avec plusieurs coûts.

<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>


			

Réponse de limite de trajet avec plusieurs coûts.

<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>