Output

Los datos de salida de Get Travel Cost Matrix contienen una cantidad de secuencias de rutas, cada una con los puntos de inicio y fin de los candidatos utilizados en la ruta de matriz y con los datos de tiempo y distancia de cada ruta calculada. Los datos de salida pueden incluir todas las rutas de la matriz o solo la ruta óptima entre cada punto de inicio/fin, según cómo se haya configurado la opción Optimize by (Optimizar por).

Si Get Travel Cost Matrix no puede encontrar una ruta entre un punto de inicio y fin en la matriz, se registrará un error en el registro cronológico del servidor, pero de todos modos se arrojarán las rutas que sí pudieron determinarse. Por ejemplo, si existe el punto de inicio A y los puntos de fin 1 y 2, y Get Travel Cost Matrix puede encontrar una ruta de A a 1 pero no de A a 2, Get Travel Cost Matrix devolverá la ruta entre A a 1 y registrará un error para indicar que la ruta de A a 2 no pudo determinarse.

Los datos de salida de Get TravelCost Matrix tienen formato de lista o formato de objeto, según cómo se haya configurado la opción Return route cost matrix (Obtener matriz de costos de rutas). No es posible interactuar directamente con la salida en formato de objeto.

Tabla 1. Datos de salida de Get Travel Cost Matrix
Opción	Formato	Descripción
Distance	Cadena	La distancia desde el punto de inicio o partida al punto final o de llegada. El valor se expresa en las unidades indicadas en el elemento DistanceUnits.
DistanceUnits	Cadena	La unidad de medida utilizada para expresar la distancia. Una de las siguientes: Feet La distancia se expresa en pies. Kilometers La distancia se expresa en kilómetros. Meters La distancia se expresa en metros. Miles La distancia se expresa en millas. Opción predeterminada. Yards La distancia se expresa en yardas.
EndPointRef	Cadena	Una ID de referencia que corresponde al orden en que se especificaron los puntos finales en la entrada. El primer punto final especificado tiene la ID de referencia 1, el segundo tiene la ID de referencia 2, y así sucesivamente. Usted debe desarrollar su propio proceso para relacionar las coordenadas de latitud/longitud en la entrada con la ID de referencia arrojada por Get Travel Cost Matrix.
EndPointID	Cadena	Una identificación asignada al punto final correspondiente en el campo ID de la etapa Input (Entrada). Por ejemplo, el primer punto final puede tener un valor N para la identificación EndPointID, el segundo punto final puede tener el valor O, y así sucesivamente. Nota: Este campo solo está activo cuando el campo Formato de matriz de costos de rutas se define con el valor "Jerarquía".
StartPointRef	Cadena	Una ID de referencia que corresponde al orden en que se especificaron los puntos de inicio en la entrada. El primer punto de inicio especificado tiene la ID de referencia 1, el segundo tiene la ID de referencia 2, y así sucesivamente. Usted debe desarrollar su propio proceso para relacionar las coordenadas de latitud/longitud en la entrada con la ID de referencia arrojada por Get Travel Cost Matrix.
StartPointID	Cadena	Una identificación asignada al punto de inicio correspondiente en el campo ID de la etapa Input (Entrada). Por ejemplo, el primer punto de inicio puede tener el valor A para la identificación StartPointID, el segundo punto de inicio puede tener el valor B, y así sucesivamente. Nota: Este campo solo está activo cuando el campo Formato de matriz de costos de rutas se define con el valor "Jerarquía".
Time	Cadena	El tiempo total desde el punto de inicio o partida al punto final o de llegada. El valor se expresa en las unidades indicadas en el elemento TimeUnits.
TimeUnits	Cadena	La unidad de medida utilizada para expresar el tiempo. Una de las siguientes: Hours El tiempo se expresa en horas. Minutes El tiempo se expresa en minutos. Opción predeterminada. Seconds El tiempo se expresa en segundos. Milliseconds El tiempo se expresa en milisegundos.
Status	Cadena de caracteres [1]	Indica el resultado exitoso o fallido del cruce. null (nulo) Sin errores F Falla
Status.Code	Cadena de caracteres [100]	Motivo de la falla, en caso de que haya una.
Status.Description	Cadena	Descripción de la falla indicada en el campo Status.Code.

Datos de salida de ejemplo

Los datos de salida de ejemplo que aparecen a continuación muestran que los valores de StartPointIDs asignados en los datos de entrada (denominados A, B y C en la entrada) corresponden a las primeras tres entidades en la lista de puntos (numeradas respectivamente 1, 2 y 3 por Spectrum™ Technology Platform). Este ejemplo también muestra que la primera instancia de EndPointID (denominada X en la entrada) es la ruta más eficaz desde las tres identificaciones StartPointID en comparación con las otras dos identificaciones EndPointID (denominadas Y y Z en la entrada; no se muestran en este ejemplo porque la instancia X de EndPointID es la ruta más eficaz).