GetTravelBoundary

Descripción

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 GetTravelBoundary (también conocida como definición "iso") toma un punto de partida, una unidad (lineal o de tiempo), uno o más costos como entrada y arroja el límite de viaje resultante. Costos hace referencia a la cantidad de tiempo o distancia que se usará para calcular un iso. Múltiples costos también se pueden entregar como entrada. En el caso de múltiples costos, estos también se pueden proporcionar como una cadena delimitada por comas.

Nota: La respuesta del servicio REST será en formato JSON. Cuando una solicitud contiene parámetros de consulta no válidos en la URL de GET o una carga no válida para POST, se obtiene una respuesta de error acumulativa en un conjunto JSON. El nodo value en la respuesta JSON está obsoleto. Para la comprobación de errores, solo se debe utilizar el nodo errors.

Formato de dirección URL de HTTP GET

El siguiente formato se utiliza para solicitudes HTTP GET. HTTP GET se utiliza para todos los límites de viaje, donde no se requiere carga JSON adicional (cambios de la velocidad ambiente).


HTTP GET /rest/Spatial/erm/databases/dbsource.json?q=travelBoundary&query_parameters

Donde dbsource es el nombre de la base de datos que contiene los datos que se van a usar para la ruta. Utilice el nombre de la base de datos especificado en la herramienta Recursos de base de datos del módulo Enterprise Routing.

Formato de dirección URL de HTTP POST

El siguiente formato se utiliza para solicitudes HTTP POST:


HTTP POST:  /rest/Spatial/erm/databases/dbsource.json?q=travelBoundary&query_parameters
POST BODY: Content-Type:application/json {Route Data}

Route Data es el cuerpo POST json (Tipo de contenido: aplicación/json) para la información de ruta adicional que se va a utilizar en el cálculo que contiene las velocidades ambiente de los tipos de camino. Para obtener información y ejemplos de estas opciones, consulte Opciones de GetTravelBoundary HTTP POST.

Parámetros de consulta

Esta operación toma los siguientes parámetros de consulta.

Parámetro	Tipo	Requerido	Descripción
`point`	Cadena	sí	La ubicación de inicio desde donde se va a calcular el límite de viaje en el formato: x,y,coordSys. Por ejemplo: -74.2,40.8,epsg:4326
`costs`	Double	sí	El tiempo o la distancia de costo, en las unidades de costo especificadas (puede ser un valor decimal). Por ejemplo, si la unidad especificada es millas y especifica 10 en este parámetro, el límite de viaje se calculará para la distancia que puede viajar 10 millas. También puede especificar múltiples costos, al indicar los valores como una cadena delimitada por comas. Se devolverá un límite de viaje independiente para cada costo especificado. Si identifica múltiples costos, cada respuesta tendrá un costo y las unidades de costo relacionadas con dicha respuesta.
`costUnit`	Cadena	sí	El tipo de métrica utilizada para calcular la frontera de viaje. Los valores de distancia disponibles son : m(meter), km(kilometer), yd(yard), ft(foot), mi(mile). Los valores disponibles son: min(minuto), msec(milisegundo), s(segundo), h(hora).
`maxOffroadDistance`	Double	no	La distancia máxima para permitir el recorrido fuera de la red de carreteras por medio del uso de `maxOffroadDistanceUnit`. Algunos ejemplos de caminos fuera de la red son los caminos de entrada y las carreteras de acceso. Por ejemplo, si se especifica una distancia máxima fuera de camino de 1 milla (1,6 kilómetros), la frontera de viaje no se extenderá más allá de esa distancia desde el camino perteneciente a la red. Si se especifica el valor 0, la frontera de viaje se limitará al camino mismo. Utilice las opciones de velocidad ambiente para especificar la velocidad de viaje en caminos y carreteras que no pertenecen a la red.
`maxOffroadDistanceUnit`	Cadena	no	La unidad de distancia que define `maxOffroadDistance`. También debe definir maxOffroadDistance, si define este parámetro. Los valores de distancia disponibles son : m(meter), km(kilometer), yd(yard), ft(foot), mi(mile).
`destinationSrs`	Cadena	no	El sistema de coordenadas que va a devolver las geometrías de límite de viaje. El valor predeterminado es el sistema de coordenadas de los datos que se utilizan (por ejemplo, epsg:4326).
`majorRoads`	Boolean	no	Especifica si en el cálculo deben incluirse todos los caminos o solo los caminos principales. Si se opta por incluir solo los caminos principales, el rendimiento mejorará pero se reducirá la precisión. El valor predeterminado es verdadero.
`returnHoles`	Boolean	no	Especifica si se desean obtener huecos, esto es, áreas dentro del límite mayor a las que no es posible llegar en el tiempo o la distancia deseados sobre la base de la red de carreteras. El valor predeterminado es "false".
`returnIslands`	Boolean	no	Especifica si se desean obtener islas, esto es, pequeñas áreas por fuera del límite principal a las que es posible llegar en el tiempo o la distancia deseados. El valor predeterminado es "false".
`simplificationFactor`	Integer	no	Especifica el porcentaje de puntos originales que debe devolverse o en el que debe basarse la complejidad resultante de las geometrías. Se espera un número del 0,0 al 1,0, sin incluir el 0,0 pero incluido el 1,0. La complejidad aumenta a medida que el valor aumenta, por lo tanto, un 1,0 representa el valor más complejo. El valor predeterminado es 0.5.
`bandingStyle`	Cadena	no	El estilo de banda a usar en el resultado. Los estilos de bandas son los tipos de múltiples bandas de distancia, que pueden mostrarse sobre la base de múltiples costos. Los estilos de banda se pueden devolver en los siguientes formatos: Donut Cada límite se determina restándole el siguiente límite menor. Este es el método predeterminado. Encompassing Cada límite se determina independientemente de los demás.
`historicTrafficTimeBucket`	Cadena	no	Especifica si el cálculo de ruta utiliza las velocidades de tráfico histórico. Estas velocidades se basan en los diferentes depósitos de momento del día. Los datos deben incluir las velocidades de tráfico histórico para utilizar esta característica. Los datos para cada país/región tienen las mismas definiciones de depósito, donde las velocidades para estos valores de depósito pueden variar. Las opciones son: None El valor predeterminado. No se utilizan los datos del tráfico histórico en el cálculo. En su lugar, se utiliza un valor de velocidad promedio. AMPeak Calcule las rutas con las velocidades máximas de la mañana. El depósito de tiempo AMMáximo es el momento desde las 07:00 hasta las 10:00 hs. PMPeak Calcule las rutas con las velocidades máximas de la tarde. El depósito de tiempo PMMáximo es el momento desde las 16:00 hasta las 19:00 hs. OffPeak Calcule las rutas con las velocidades fuera del horario pico (durante el día). El depósito de tiempo Fuera del máximo es el momento desde las 10:00 hasta las 16:00 hs. Night Calcule las rutas con las velocidades nocturnas. El depósito de tiempo Noche es el momento desde las 22:00 hasta las 04:00 hs.

Ejemplos

Límite de viaje con un costo simple.


http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?q=travelBoundary&point=-77.092609,38.871256,epsg:4326&costs=5&costUnit=m

Respuesta


{
"travelBoundary": {
  “costs”: [
	{
		"cost": 5,
		"costUnit": "m",
		"geometry": {"type":"MultiPolygon","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"coordinates":[[[...]]]}
	}
  ]
}
}

Límite de viaje con múltiples costos.


http://www.pb.com/rest/Spatial/erm/databases/usroutedatabase.json?q=travelBoundary&point=-77.092609,38.871256,epsg:4326&costs=2,5&costUnit=m

Respuesta


{
"travelBoundary": {
  "costs": [
	    {
                 "cost": 2,
                 "costUnit": "m",
		"geometry": "{"type":"MultiPolygon","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"coordinates":[[[...]]]}"
	},
	{
		"cost": 5,
		"costUnit": "m",
		"geometry": "{"type":"MultiPolygon","crs":{"type":"name","properties":{"name":"epsg: 4326"}},"coordinates":[[[...]]]}"
	}
  ]
}
}