Proximidad

Servicios web

Documentación sobre la funcionalidad Proximidad 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 los N puntos más próximos a un centro

Petición:

Ejemplo de petición:

&cmd=prox&mo=42.369140,-3.489919|CENTRO&mocs=gdd&rqmolist=%5b40.369140,-3.589919|A%5d,%5b40.367223,-3.583056|B%5d&num=2

Donde:

  • cmd=prox Petición de proximidad
  • mocs=gdd Coordenadas expresadas en geográficas (LatLon)
  • mo= Coordenada en geográficas del centro con formato lat,lon|ID
  • rqmolist= Lista de puntos que se desea ordenar por tiempo en ruta en formato [lat1,lon1|ID1], [lat2,lon2|ID2], ...
  • num= Número de puntos en rqmolist

Respuesta:

<cercalia cmd="prox" version="1">
   <proximity center="-3.4899189461929763,42.36914099810293" num="2" type="mo">
      <molist num="2">
         <mo dist="222546" id="A" pos="1">
            <coord x="-3.5899194036211615" y="40.36914023237501"/>
         </mo>
         <mo dist="222739" id="B" pos="2">
            <coord x="-3.5830562748504877" y="40.36722321688161"/>
         </mo>
      </molist>
   </proximity>
   <server>lb3.cercalia.com</server>
</cercalia>

Donde:

  • dist: distancia proyectada en línea recta, en metros
  • pos: orden de proximidad en la lista de puntos devueltos (de más a menos cercano)

Obtener los N puntos más próximos por ruta a un centro

Petición:

Ejemplo de petición:

&cmd=prox&mo=42.369140,-3.489919|CENTRO&mocs=gdd&rqmolist=%5b40.369140,-3.589919|A%5d,%5b40.367223,-3.583056|B%5d&weight=time&num=2

Donde:

  • cmd=prox Petición de proximidad
  • mocs=gdd Coordenadas expresadas en geográficas (LatLon)
  • mo= Coordenada en geográficas del centro con formato lat,lon|ID
  • rqmolist= Lista de puntos que se desea ordenar por tiempo en ruta en formato [lat1,lon1|ID1], [lat2,lon2|ID2], ...
  • weight=time Obtener los puntos de interés ordenados por tiempo de ruta
  • num= Número de puntos en rqmolist
  • inverse= Si
    • 0 -> los tiempos de ruta son del centro a la lista de puntos
    • 1 -> los tiempos de ruta son de la lista de puntos hasta el centro

Respuesta:

<cercalia cmd="prox" version="1">
   <proximity center="-388496,5187633" inverse="0" num="2" type="mo" weight="time">
      <molist num="2">
         <mo dist="222739" id="B" pos="1" routedist="268639" routerealtime="9618936" routetime="9618936" routeweight="9618936">
            <coord x="-398864" y="4891770"/>
         </mo>
         <mo dist="222546" id="A" pos="2" routedist="268238" routerealtime="9637116" routetime="9637116" routeweight="9637116">
            <coord x="-399628" y="4892049"/>
         </mo>
      </molist>
   </proximity>
   <server>http://cercalia-tomcat-lbs-instance4:8080</server>
</cercalia>

Donde:

  • dist: distancia proyectada en línea recta, en metros
  • routedist: distancia en ruta especificada en metros
  • routetime: tiempo en ruta especificada en milisegundos

Obtención del buffer de una o más geometrías en formato WKT

Petición:

Parámetros de petición:

&cmd=buffergeoms

GEOMS

Lista de geometrías separadas por comas. Cada geometría tiene el siguiente formato: [wkt|id]

Donde:

wkt: Formato wkt de la geometría
id: Identificador de la geometría

Todas las geometrías de la lista deben ser de uno de los siguientes tipos:

  • Point
  • PolyLine
  • Polygon
  • MultiPoint

SRS

Sistema de coordenadas de las geometrías.

Por defecto geográficas (EPSG:4326)

Ej.: EPSG:4326

BUFFER

Buffer en metros que la geometría se debe expandir.

TOLERANCE

Error máximo en metros que se puede cometer al simplificar las geometrías devueltas. (Por defecto no se simplifican: 0 metros)

Respuesta:

Ejemplo de respuesta:

<cercalia cmd="buffergeoms" version="1">
   <buffergeoms>
      <geometry id="1"> POLYGON((-3.708452 40.411246, -3.708434 40.411191, -3.706925 40.411582, -3.705362 40.412022, -3.708362 40.411294, -3.708452 40.411246))</geometry >
      <geometry id="2"> POLYGON((-3.708452 40.411246, -3.708434 40.411191, -3.706925 40.411582, -3.705362 40.412022, -3.708362 40.411294, -3.708452 40.411246))</geometry>
   </buffergeoms>
</cercalia>