GetTravelBoundary (obsoleto)

Importante: Esta etapa es obsoleta en la versión 12.2. La etapa Límite de viaje debe usarse en su lugar cuando se creen flujos de datos nuevos.

GetTravelBoundary determina la frontera de tiempo o distancia a pie o en vehículo desde una ubicación. Esta función permite obtener 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 Get Travel Boundary (también conocida como definición iso) toma un punto de partida, una unidad (lineal o de tiempo), uno o más costos y sus rótulos asociados como datos de entrada y devuelve el límite de viaje resultante. Costo hace referencia a la cantidad de tiempo o distancia que se usará para calcular un iso. Un rótulo es una cadena de caracteres que identifica el costo y se usa para hacer coincidir el resultado correspondiente. Se pueden dar múltiples costos como entrada, al proporcionar los costos como una cadena delimitada por “;”.

GetTravelBoundary forma parte del módulo Enterprise Routing.

Nota: GetTravelBoundary solo está disponible como servicio web. GetTravelBoundary no está disponible en las API Java, C++, C, .NET o COM.

URL del recurso

Extremo del elemento JSON:

http://server:port/rest/GetTravelBoundary/results.json

Extremo del XML:

http://server:port/rest/GetTravelBoundary/results.xml

Ejemplo con respuesta JSON

El siguiente ejemplo solicita una respuesta JSON:

http://myserver:8080/rest/GetTravelBoundary/results.json?Data.Latitude=51.5072&Data.Longitude=0.1275&Data.&Data.TravelBoundaryCost=10&Data.TravelBondaryCostUnits=Kilometers&Option.DataSetResourceName=Routing_db_gb

El elemento JSON devuelto por esta solicitud sería:

Nota: Algunos de los puntos se eliminaron de este ejemplo para acortarlo.

Nota: La respuesta en este ejemplo muestra coordenadas para las geometrías devueltas con valores de 14 lugares decimales. Esto contribuye a una carga más grande de lo necesario en la respuesta JSON, especialmente cuando se devuelven polígonos grandes o muchos registros. Esto también puede conducir a geometrías inválidas, como autointersecciones. Para devolver valores más cortos de coordenadas y reducir la carga, agregue lo siguiente a %Spectrum%\server\bin\wrapper\wrapper.conf: wrapper.java.additional.xx=-Dcom.pb.midev.useprecision=true. Luego, reinicie el servidor.

{"output_port": [{
   "IsoNodeResponse": [],
   "IsoPolygonResponse":    {
      "srsName": "epsg:4326",
      "Polygon": [      {
         "srsName": "epsg:4326",
         "Exterior": {"LineString": [{"Pos":          [
                        {
               "X": -84.34868168466456,
               "Y": 33.68373169496257
            },
                        {
               "X": -84.36945064055561,
               "Y": 33.69293307108579
            },
                        {
               "X": -84.3694506405556,
               "Y": 33.69293307108579
            },
                        {
               "X": -84.3694506405556,
               "Y": 33.69303002973829
            },
                        {
               "X": -84.37104825254721,
               "Y": 33.69391558543121
            },
                        {
               "X": -84.37104825254721,
               "Y": 33.6936408692491
            },
                        {
               "X": -84.42163929894845,
               "Y": 33.716054477754355
            },
                        {
               "X": -84.4440058668311,
               "Y": 33.710741143596806
            },
                        {
               "X": -84.43921303085625,
               "Y": 33.72800947960886
            },
                        {
               "X": -84.45678676276404,
               "Y": 33.73376559161287
            },
                        {
               "X": -84.43921303085625,
               "Y": 33.73996448146335
            },
            ...
         ]}]}
      }]
   },
   "user_fields": [   {
      "name": "TravelBoundaryCostUnits",
      "value": "Kilometers"
   }]
}]}

Ejemplo con respuesta XML

El siguiente ejemplo solicita una respuesta XML:

http://myserver:8080/rest/GetTravelBoundary/results.xml?Data.TravelBoundaryCostUnits=Kilometers&Data.Latitude=33.751748&Data.Longitude=-84.364014&Data.TravelBoundaryCost=10

El elemento XML devuelto por esta solicitud sería:

Nota: Algunos de los puntos se eliminaron de este ejemplo para acortarlo.

<ns3:xml.GetTravelBoundaryResponse
xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns3="http://www.pb.com/spectrum/services/GetTravelBoundary">
   <ns3:output_port>
      <ns3:IsoRouteResponse>
         <ns3:IsoNodeResponse/>
         <ns3:IsoPolygonResponse
              xsi:type="ns2:MultiPolygon"
              srsName="epsg:4326"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ns2:Polygon srsName="epsg:4326">
               <ns2:Exterior>
                  <ns2:LineString>
                     <ns2:Pos>
                        <ns2:X>-84.34868168466456</ns2:X>
                        <ns2:Y>33.68373169496257</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.36945064055561</ns2:X>
                        <ns2:Y>33.69293307108579</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.3694506405556</ns2:X>
                        <ns2:Y>33.69293307108579</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.3694506405556</ns2:X>
                        <ns2:Y>33.69303002973829</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.37104825254721</ns2:X>
                        <ns2:Y>33.69391558543121</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.37104825254721</ns2:X>
                        <ns2:Y>33.6936408692491</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.42163929894845</ns2:X>
                        <ns2:Y>33.716054477754355</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.4440058668311</ns2:X>
                        <ns2:Y>33.710741143596806</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.43921303085625</ns2:X>
                        <ns2:Y>33.72800947960886</ns2:Y>
                     </ns2:Pos>
                     <ns2:Pos>
                        <ns2:X>-84.45678676276404</ns2:X>
                        <ns2:Y>33.73376559161287</ns2:Y>
                     </ns2:Pos>
                     ...
                  </ns2:LineString>
               </ns2:Exterior>
            </ns2:Polygon>
         </ns3:IsoPolygonResponse>
         <ns3:user_fields/>
      </ns3:IsoRouteResponse>
   </ns3:output_port>
</ns3:xml.GetTravelBoundaryResponse>