Snap to road

Servicios web

Documentación sobre la funcionalidad Snap to road disponible a través del webservice HTTP-JSON/XML de la plataforma CERCALIA.

La URL base a utilizar es:

* Clave de seguridad. Es la misma KEY que para la API de mapas de Cercalia

Las peticiones HTTP se pueden enviar en GET o POST
Las respuestas son en formato JSON / XML

Obtener la ruta a partir de un track GPS (snap to road)

Petición para obtener la ruta real por la que ha circulado un vehículo, a partir de su track GPS

Petición:

Ejemplo de petición:

&cmd=geomtrack&TRACK=[-3.710311618,40.429844757@250,45@@70],[-3.698480806,40.428066780@310,45@@75]&SRS=EPSG:4326

Donde:

TRACK

Lista de puntos ordenados, separados por comas, limitado a un máximo de 300 puntos. Cada punto tiene el siguiente formato:

[coordenada{@<compás>}{@@velocidad}]

Donde:

  • coordenada: es una lista de ordenadas separadas por coma.
  • compás: Elemento opcional que identifica el rumbo del vehículo. Formato: @tolerance angle, direction tolerance
    • tolerance angle: corresponde al rumbo (en grados). Posibles valores: 0-360
    • direction tolerance: corresponde a la tolerancia (en grados) respecto al rumbo indicado. Posibles valores: 0-180
  • velocidad: Elemento opcional que indica la velocidad del vehículo en el punto indicado en Km/h.

SRS

Sistema de coordenadas de la lista de puntos. Utilizar EPSG:4326 para coordenadas geográficas

WEIGHT

Peso usado para la resolución (por defecto distancia)

NET

Red usada para el cálculo (opcional)

Parámetros de control a bajo nivel:

ONLYTRACK

Si true devuelve una geometría multipunto con los puntos de la ruta. Por defecto: false

MAXDIRECTIONSEARCHDISTANCE

Desviación máxima que puede haber entre un punto del track y un punto de la red que respete la orientación del punto. Por defecto: 10

Si no se encuentra ningún punto se procede a buscarlo sin tener en cuenta la orientación.

MAXSEARCHDISTANCE

Desviación máxima que puede haber entre un punto del track y un punto de la red sin tener en cuenta la orientación. Por defecto: 20

Si no se encuentra ningún punto en la red que cumpla con la distancia el punto se añade en línea recta al resultado.

FACTOR

Factor entre la distancia en ruta y la recta entre dos puntos. Si se supera este factor se ignora la ruta y se prefiere la línea recta. Por defecto: 2

Respuesta:

<cercalia cmd="geomtrack" version="1">
	<track>
		<geometry>
			<wkt>
			LINESTRING (-3.7102887167967693 40.42997776054614, -3.7091707575880277 40.42986535088826, -3.7089192293084743 40.429844756839465, -3.708748549404491 40.42983789215513, -3.7077514194391186 40.42973492180528, -3.707419042783995 40.42971432771623, -3.706754289473746 40.42965941011441, -3.706305131831686 40.42961822188338, -3.706161401386227 40.429590763048566, -3.7058110584254202 40.42954271006045, -3.7054517323117726 40.42948092759633, -3.705379867089043 40.42947406287456, -3.704751046390159 40.429398550888514, -3.703717983813422 40.429220067672745, -3.7033047587827275 40.429137690642925, -3.7024064434986075 40.42898666582415, -3.7023615277344017 40.428972936278214, -3.701984235315071 40.42892488284522, -3.701409313533235 40.42880131671579, -3.7005109982491153 40.42861596709264, -3.6999360764672793 40.428485535567766, -3.6994150536024897 40.42838942796525, -3.698436860020802 40.428197754472336)
			</wkt>
		</geometry>
	</track>
	<server>http://cercalia-tomcat-lbs-instance3:8080</server>
</cercalia>

Donde:

  • geomtrack= WKT de tipo polilínea (linestring / multilinestring) con la ruta real

 

Representación visual de la polilínea:

 

Snap to road