Web services
Isochrones API documentation, available via HTTP-JSON/XML service.
URL base service:
- JSON: https://lb.cercalia.com/services/json?key=<clave API*>
- XML: https://lb.cercalia.com/services/xmlgeo?key=<clave API*>
* API KEY. Same KEY used in maps API js
HTTP requests in GET or POST
Response in JSON / XML format
Isochrones, by car
Request:
Example:
&cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=concavehull&net=esp
Where:
cmd=isochrone request type (isochrone)
mo= coord X,Y isochrone center point
mocs / ocs= coordinate system (4326 = geog lat,long)
weight= isochrone calculation type: driving time (time) / maximum distance (distance)
isolevels= isochrones values. You can add several isochrones in a single request.
weight=time value in milliseconds
weight=distance value in meters
method= isochrone type:
convexhull: simplified shape isochrone
concavehull: improved shape isochrone
net= logistics (only for truck routing)
* Rest of parameters, add them with the values indicated in the example
Response:
<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>
Where:
isocrhone level= osochrone level value
POLYGON= isochrone polygon, in WKT format
Isochrones, walking
Request:
Example:
&cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=concavehull
Where:
cmd=isochrone request type (isochrone)
mo= coord X,Y isochrone center point
mocs / ocs= coordinate system (4326 = geog lat,long)
weight= isochrone calculation type: walking time (time) / maximum distance (distance)
isolevels= isochrones values. You can add several isochrones in a single request.
weight=time value in milliseconds
weight=distance value in meters
method= isochrone type:
convexhull: simplified shape isochrone
concavehull: improved shape isochrone
net= country. List: See annex table
* Rest of parameters, add them with the values indicated in the example
Response:
<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>
Where:
isocrhone level= osochrone level value
POLYGON= isochrone polygon, in WKT format
Countries availables:
Code |
Name |
ESP (*) |
Iberia |
USA |
USA |
(*) Default value