GetTravelBoundary

Descripción

GetTravelBoundary determina la frontera de tiempo o distancia a pie o en vehículo desde una ubicación. Esta operación devuelve polígonos que corresponden a un cálculo de elemento isócrono o equidistancia. Un elemento isócrono es un polígono o conjunto de puntos que representan un área que puede recorrerse en una red desde un punto inicial en un tiempo dado. La equidistancia es un polígono o conjunto de puntos que representan el área que se encuentra a cierta distancia desde un punto de partida. La operación GetTravelBoundary (también conocida como definición "iso") toma un punto de partida, una unidad (lineal o de tiempo) y uno o más costos como entrada y devuelve el límite de viaje resultante. Costos hace referencia a la cantidad de tiempo o distancia que se usará para calcular un iso.

Formatos de la URL del servicio

El extremo de la URL del servicio de funciones SOAP tiene el siguiente formato general:



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

				

La URL del servicio de funciones WSDL tiene el siguiente formato general:



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

				

Mensajes

La siguiente tabla enumera los mensajes de solicitud y de respuesta para la operación GetTravelBoundary.

Haga clic en el nombre de un mensaje para obtener más información acerca de este.

Mensaje Descripción
GetTravelBoundaryRequest El mensaje de solicitud de la operación GetTravelBoundary.
GetTravelBoundaryResponse El mensaje de respuesta de la operación GetTravelBoundary.

Ejemplo de costo simple

Solicitud de límite de viaje con un costo simple.



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


			

Respuesta de límite de viaje con un costo simple.



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

Ejemplo de costos múltiples

Solicitud de límite de viaje con costos múltiples.



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


			

Respuesta de límite de viaje con costos múltiples.



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