GetSegmentData - web_services - 23.1

Guía de servicios web de Spectrum

Product type
Portfolio
Integrate
Product family
Product
Spectrum > Web Services
Version
23.1
Language
Español (México)
Product name
Spectrum Technology Platform
Title
Guía de servicios web de Spectrum
First publish date
2007
ft:lastEdition
2024-02-07
ft:lastPublication
2024-02-07T18:09:34.894393

Descripción

El servicio GetSegmentData devuelve información del segmento de un punto o una ID de segmento. Cuando se especifica un punto, se obtienen los segmentos de ruta más cercanos. Cuando se especifica una ID de segmento, se obtienen los datos de ruta para un segmento de ruta especificado.

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 comprobar los 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. Las solicitudes HTTP GET son distintas para devolver los datos del segmento en un punto o los datos del segmento para una ID de segmento.

Devolución de datos de un segmento en un punto específico:

HTTP GET /rest/Spatial/erm/databases/dbsource/segments.json?point=x,y,srsName&query_parameters

Devolución de datos de un segmento específico:

HTTP GET /rest/Spatial/erm/databases/dbsource/segments/segmentID.json?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 Spectrum Spatial Routing. El parámetro segmentID es el identificador de segmento que desea que devuelva los datos.

Parámetros de consulta

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

Parámetro Tipo Requerido Descripción
destinationSrs Cadena de caracteres no El sistema de coordenadas devuelve los datos del segmento ruta y la geometría resultante. El valor predeterminado es el sistema de coordenadas de los datos que se utilizan.
distanceUnit Cadena de caracteres no Las unidades para devolver la distancia. El valor predeterminado es m (metros). Los valores disponibles son : m(meter), km(kilometer), yd(yard), ft(foot), mi(mile).
timeUnit Cadena de caracteres no Las unidades para devolver el tiempo. El valor predeterminado es min (minutos). Los valores disponibles son: min(minuto), msec(milisegundo), s(segundo), h(hora).
velocityUnit Cadena de caracteres no Las unidades para devolver la velocidad. El valor predeterminado es mph (millas por hora). Los valores disponibles son: mph(miles per hour) y kph(kilometers per hour).
angularUnit Cadena de caracteres no Las unidades para devolver los ángulos de giro. El valor predeterminado es deg(degree). Los valores disponibles son: deg(degree), rad(radian), minute(minute), sec(second), grad(grad).
segmentGeometryStyle Cadena de caracteres no

El formato de la geometría que representa un segmento de la ruta. El valor predeterminado es NINGUNO. Especifique este parámetro si solicitó la devolución de geometrías de un segmento. Las opciones al especificar las indicaciones de ruta son:

None
No se devolverá ninguna representación geométrica de un segmento. Valor predeterminado, si no se especifica.
End
Cada segmento se la ruta se devolverá con sus extremos en una cadena de línea.
All
Cada segmento se devolverá con todos sus puntos de forma como una cadena de línea. Las cadena de línea se puede usar como una superposición en un mapa.
version Cadena de caracteres No Especifica la versión del servicio REST GetSegmentData. Los valores válidos son 1 y 2. El valor predeterminado para version es 1.

Ejemplos

Devolución de datos del segmento especificando un punto.

http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase/segments.json?​point=-77,38,epsg:4326&segmentGeometryStyle=all

Respuesta

[{ 	"segmentID": "aa18eb33:1b7bbe", 	"primaryName": "VA-631", 	"primaryNameLanguage": "en", 	"alternateNames": [{ 		"alternateName": "Lloyds Rd", 		"language": "en" 	}, 	{ 		"alternateName": "VA-631", 		"language": "en" 	}], 	"segmentLength": 4.954, 	"segmentLengthUnit": "mi", 	"timeTaken": 5.9333, 	"timeUnit": "min", 	"turnAngle": 0.0, 	"turnAngleUnit": "deg", 	"compassDirection": "", 	"speedOfTravel": 49.9955, 	"speedOfTravelUnit": "mph", 	"roadType": "major road rural", 	"segmentDirection": "bidirectional", 	"startJunctionType": "", 	"endJunctionType": "Other", 	"isRoundabout": false, 	"isTollRoad": false, 	"geometry": { 		"type": "LineString", 		"crs": { 			"type": "name", 			"properties": { 				"name": "epsg:4326" 			} 		}, 		"coordinates": [[…]] 	} }, { 	"segmentID": "46ed0e49:d9a7dc", 	"primaryName": "VA-631", 	"primaryNameLanguage": "en", 	"alternateNameList": [{ 		"alternateName": "Lloyds Rd", 		"language": "en" 	}], 	"segmentLength": 1.198, 	"segmentLengtUnit": "mi", 	"timeTaken": 1.433, 	"timeUnit": "min", 	"turnAngle": 0.0, 	"turnAngleUnit": "degree", 	"compassDirection": "", 	"speedOfTravel": 49.9955, 	"speedOfTravelUnit": "mph", 	"roadType": "major road rural", 	"segmentDirection": "bidirectional", 	"startJunctionType": "Other", 	"endJunctionType": "", 	"isRoundabout": false, 	"isTollRoad": false, 	"pointsInSegment": { 		"type": "LineString", 		"crs": { 			"type": "name", 			"properties": { 				"name": "epsg:4326" 			} 		}, 		"coordinates": [[…]] 	} }]			

Devolución de datos del segmento especificando segmentID.

http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase/segments/aa18eb33:1b7bbe.json?​distanceUnits=mi

Respuesta

[{ 	"segmentID": "aa18eb33:1b7bbe", 	"primaryName": "VA-631", 	"primaryNameLanguage": "en", 	"alternateNames": [{ 		"alternateName": "Lloyds Rd", 		"language": "en" 	}, 	{ 		"alternateName": "VA-631", 		"language": "en" 	}], 	"segmentLength": 4.954, 	"segmentLengthUnit": "mi", 	"timeTaken": 5.9333, 	"timeUnit": "min", 	"turnAngle": 0.0, 	"turnAngleUnit": "deg", 	"compassDirection": "", 	"speedOfTravel": 49.9955, 	"speedOfTravelUnit": "mph", 	"roadType": "major road rural", 	"segmentDirection": "bidirectional", 	"startJunctionType": "", 	"endJunctionType": "Other", 	"isRoundabout": false, 	"isTollRoad": false }			

Respuesta de error específica de la versión

Cuando ingresa un valor de parámetro no válido (por ejemplo, falta un punto) en una solicitud, la respuesta de error que obtiene depende de la versión que ingresó. Cuando la versión es 1, obtiene valor y error, y cuando la versión es 2, la respuesta sólo contiene el error.

  • Solicitud cuando version es 1:
    http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase.json?version=1
  • Respuesta:
    { 	"value": "Point cannot be empty.", 	"errors": [{ 		"errorCode": 4139, 		"userMessage": "Point cannot be empty."                          	}] }
  • Solicitud cuando version es 2:
    http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase.json?version=2
  • Respuesta:
    {"errors": [{ 	"errorCode": 4139, 	"userMessage": "Point cannot be empty." }]}