Servicios web
Documentación sobre la funcionalidad Isócronas disponible a través del webservice HTTP-JSON/XML de la plataforma CERCALIA.
La URL base a utilizar es:
- JSON: http://ws.cercalia.com/services/json?markattributes=true&key=<clave API*>
- XML: http://ws.cercalia.com/services/xmlgeo?key=<clave API*>
* 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
Isócronas en coche
Petición:
Ejemplo de petición:
&cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=concavehull
Donde:
cmd=isochrone tipo de petición de cercalia (isócrona)
mo= coordenadas X,Y centro de búsqueda
mocs / ocs = sistema de coordenadas (4326 = geográficas)
weight= tipo de cálculo de la isócrona, en base a: tiempo conduciendo (time) / distancia máxima (distance)
isolevels= valor de la isócrona/as. Permite especificar n isócronas para un mismo mo. Si:
weight=time valor en milisegundos
weight=distance valor en metros
method= tipo de isócrona. Dos opciones:
convexhull: isócrona simplificada, polígono cóncavo
concavehull: isócrona mejorada, polígono convexo
net=logistics en caso de querer utilizar la red de rutas específica para camiones
* Resto de parámetros, añadirlos con los valores indicados en el ejemplo
Respuesta:
<cercalia cmd="isochrone" version="1">
<isochrones center="314598,5128250" inverse="0" method="convexhull" net="" ocs="4326" weight="time">
<isochrone level="120000">
POLYGON((2.822404 41.970239, 2.823191 41.969078, 2.823694 41.968361, 2.826895 41.966269, 2.833949 41.972128, 2.832128 41.972907, 2.830421 41.973523, 2.825116 41.974990, 2.822894 41.974348, 2.822404 41.970239))
</isochrone>
<isochrone level="300000">
POLYGON((2.811143 41.961637, 2.811239 41.961434, 2.819370 41.954925, 2.825696 41.954361, 2.842197 41.954841, 2.849896 41.960571, 2.849977 41.960638, 2.850130 41.960831, 2.847706 41.968282, 2.829963 41.979839, 2.826368 41.982045, 2.824970 41.982149, 2.823567 41.982197, 2.823129 41.982192, 2.818441 41.980124, 2.813792 41.977902, 2.811387 41.976640, 2.811143 41.961637))
</isochrone>
<isochrone level="600000">
POLYGON((2.779116 41.967357, 2.791218 41.915038, 2.850529 41.922482, 2.869435 41.970239, 2.869430 41.970320, 2.849357 42.018400, 2.849165 42.018823, 2.807712 41.994073, 2.779116 41.967357))
</isochrone>
</isochrones>
<server>http://cercalia-tomcat-lbs-instance3:8080</server>
</cercalia>
Donde:
isocrhone level= nivel de la isócrona
POLYGON= polígono de la isócrona, en formato WKT
Isócronas a pie
El cálculo de isócronas a pie se realiza en los servidores estándar de Cercalia.
Petición:
Ejemplo de petición:
cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&net=espw&method=concavehull
Donde:
cmd=isochrone tipo de petición de cercalia (isócrona)
mo= coordenadas X,Y centro de búsqueda
mocs / ocs = sistema de coordenadas (4326 = geográficas)
weight= tipo de cálculo de la isócrona, en base a: tiempo andando (time) / distancia máxima (distance)
isolevels= valor de la isócrona/as. Permite especificar n isócronas para un mismo mo. Si:
weight=time valor en milisegundos
weight=distance valor en metros
net= código de red a utilizar. Redes disponibles: Ver tabla anexa de países
method= tipo de isócrona. Dos opciones:
convexhull: isócrona simplificada, polígono cóncavo
concavehull: isócrona mejorada, polígono convexo
* Resto de parámetros, añadirlos con los valores indicados en el ejemplo
Respuesta:
<cercalia cmd="isochrone" version="1">
<isochrones center="314598,5128250" inverse="0" method="convexhull" net="espw" ocs="4326" weight="time">
<isochrone level="120000">
POLYGON((2.824597 41.972372, 2.824678 41.972124, 2.825704 41.971502, 2.826633 41.971440, 2.827483 41.972226, 2.827691 41.972437, 2.827443 41.972643, 2.826490 41.973252, 2.825570 41.973106, 2.825315 41.972981, 2.824597 41.972372))
</isochrone>
<isochrone level="300000">
POLYGON((2.824115 41.970791, 2.824263 41.970665, 2.825528 41.970093, 2.826694 41.969753, 2.827381 41.969821, 2.828057 41.970385, 2.828426 41.970703, 2.829846 41.971955, 2.829968 41.972124, 2.828956 41.973342, 2.824809 41.974333, 2.824231 41.974146, 2.824115 41.970791))
</isochrone>
<isochrone level="600000">
POLYGON((2.820342 41.974847, 2.820816 41.970314, 2.823460 41.967852, 2.823701 41.967704, 2.827544 41.966803, 2.828324 41.966893, 2.828494 41.967006, 2.830167 41.968462, 2.831013 41.969629, 2.832745 41.972589, 2.826763 41.976112, 2.825867 41.976542, 2.824984 41.976833, 2.824253 41.977026, 2.823246 41.976777, 2.821396 41.975693, 2.820342 41.974847))
</isochrone>
</isochrones>
<server>http://cercalia-tomcat-lbs-instance2:8080</server>
</cercalia>
Donde:
isocrhone level= nivel de la isócrona
POLYGON= polígono de la isócrona, en formato WKT
Países disponibles:
Código |
Descripción |
ESPW (*) |
Península Ibérica |
USAW |
USA |
(*) Valor por defecto