API Access
The Isochrones API allows you to retrieve multiple isochrones in a single request, calculated based on travel time or distance. It is available via HTTP-JSON and XML services.
Base Service URLs:
- Supported methods: GET or POST
- Response formats: JSON / XML
Driving Isochrones
Calculate reachable areas by car using either travel time or road distance.
Request Parameters
Example:
https://lb.cercalia.com/services/v2/json?cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=concavehull&key=YOUR_API_KEY
| Parameter | Description |
|---|---|
cmd | Isochrone request type (isochrone). |
mo | Center point coordinates (X,Y). |
mocs / ocs | Spatial Reference System (use 4326 for WGS84). |
weight | Calculation metric: time (duration) or distance (road distance). |
isolevels | List of thresholds (comma-separated). Multiple levels generate multiple shapes. |
weight=time | Threshold value in milliseconds. |
weight=distance | Threshold value in meters. |
method | Algorithm for shape generation: convexhull (simplified), concavehull (precise), or net (logistics/truck). |
For optimal results, include all parameters as shown in the example above.
Response Structure
The response contains a list of polygons representing the reachable areas for each level.
Example:
{
"cercalia": {
"@cmd": "isochrone",
"@version": "1",
"isochrones": {
"@center": "314598,5128250",
"@inverse": "0",
"@method": "concavehull",
"@net": "",
"@ocs": "4326",
"@weight": "time",
"isochrone": [
{
"@level": "120000",
"value": "POLYGON((2.823289 41.974289, 2.824276 41.973483, 2.824384 41.973416, 2.824272 41.973332, 2.825515 41.972631, 2.825844 41.972316, 2.825552 41.972297, 2.824645 41.972256, 2.824716 41.972022, 2.824986 41.971305, 2.824258 41.970564, 2.823688 41.970119, 2.823971 41.970091, 2.824195 41.970064, 2.823944 41.969706, 2.824690 41.970031, 2.824968 41.970031, 2.824995 41.969676, 2.824672 41.969401, 2.825022 41.969575, 2.825086 41.969527, 2.825094 41.969521, 2.825239 41.969157, 2.825857 41.969293, 2.826145 41.968556, 2.826521 41.968627, 2.826483 41.967567, 2.827205 41.968005, 2.827690 41.968750, 2.827908 41.968801, 2.827959 41.970735, 2.828460 41.970708, 2.830579 41.969931, 2.830511 41.969991, 2.830421 41.970058, 2.830178 41.970205, 2.830327 41.970301, 2.829729 41.970641, 2.829513 41.970815, 2.829702 41.970829, 2.828552 41.971264, 2.828516 41.971593, 2.829594 41.971646, 2.829522 41.971687, 2.829531 41.971727, 2.830582 41.971834, 2.830609 41.971848, 2.833855 41.972153, 2.833619 41.972216, 2.833179 41.972377, 2.832128 41.972907, 2.831049 41.972931, 2.830843 41.972967, 2.830439 41.972813, 2.830514 41.973001, 2.830520 41.973014, 2.829037 41.972330, 2.828732 41.972397, 2.828067 41.972451, 2.828561 41.973363, 2.827411 41.972437, 2.826998 41.973188, 2.826603 41.973577, 2.826504 41.973296, 2.825089 41.974948, 2.824959 41.974797, 2.825399 41.973919, 2.824896 41.974026, 2.824528 41.973885, 2.824411 41.973919, 2.823423 41.974267, 2.823289 41.974289))"
},
{
"@level": "300000",
"value": "POLYGON((2.813747 41.976549, 2.814988 41.975380, 2.814907 41.975116, 2.818570 41.972378, 2.818446 41.972196, 2.818224 41.972247, 2.818365 41.972029, 2.818361 41.972018, 2.819288 41.970334, 2.819138 41.970373, 2.819064 41.970239, 2.818885 41.969918, 2.818160 41.969639, 2.817261 41.969398, 2.817224 41.969380, 2.817251 41.969374, 2.818446 41.969005, 2.818464 41.968911, 2.818150 41.968589, 2.818100 41.968501, 2.817972 41.968272, 2.817970 41.968268, 2.817880 41.968114, 2.817741 41.967938, 2.816031 41.966462, 2.816236 41.966297, 2.816632 41.966082, 2.815418 41.965122, 2.815230 41.964842, 2.815545 41.964614, 2.815724 41.964487, 2.814772 41.964011, 2.814524 41.963794, 2.815103 41.963801, 2.814918 41.963435, 2.814925 41.963434, 2.817561 41.963751, 2.817512 41.963253, 2.817719 41.963199, 2.818240 41.963065, 2.817198 41.962227, 2.818114 41.962287, 2.817966 41.961965, 2.818495 41.961881, 2.818913 41.961738, 2.818770 41.961389, 2.818767 41.961384, 2.819769 41.960786, 2.819758 41.960672, 2.819148 41.960011, 2.819183 41.959988, 2.819164 41.959962, 2.819623 41.959733, 2.819731 41.959686, 2.819928 41.959673, 2.820144 41.959652, 2.820408 41.959650, 2.819830 41.958600, 2.819842 41.958351, 2.820162 41.957175, 2.820162 41.957051, 2.820011 41.956780, 2.820028 41.956711, 2.820090 41.956709, 2.820602 41.956340, 2.820689 41.956331, 2.820593 41.956152, 2.820564 41.956012, 2.822022 41.956910, 2.822031 41.956843, 2.822067 41.956819, 2.822183 41.956742, 2.822210 41.956696, 2.827375 41.956266, 2.827322 41.955797, 2.827519 41.956038, 2.827618 41.956018, 2.827681 41.956032, 2.827708 41.956059, 2.829172 41.957239, 2.829469 41.957017, 2.829585 41.956950, 2.829810 41.956890, 2.829873 41.956856, 2.830178 41.956649, 2.830771 41.956179, 2.830870 41.956072, 2.830969 41.955904, 2.830981 41.955838, 2.830708 41.959425, 2.830757 41.959469, 2.830744 41.959807, 2.830773 41.959791, 2.830865 41.961288, 2.831616 41.960989, 2.831625 41.960993, 2.831631 41.960997, 2.831930 41.961181, 2.831616 41.960989"
},
{
"@level": "600000",
"value": "POLYGON((2.791565 41.962605, 2.802941 41.962247, 2.801684 41.960893, 2.801765 41.960853, 2.803444 41.960578, 2.803260 41.960386, 2.803076 41.959800, 2.802663 41.959512, 2.799493 41.958846, 2.798679 41.958729, 2.799177 41.958519, 2.801522 41.958674, 2.801449 41.957499, 2.801441 41.957467, 2.799612 41.956902, 2.799582 41.956870, 2.799555 41.956830, 2.798825 41.956500, 2.798917 41.956320, 2.807657 41.957453, 2.808071 41.957379, 2.809517 41.956984, 2.809212 41.956642, 2.809490 41.956481, 2.809679 41.956401, 2.810577 41.956481, 2.810559 41.956367, 2.810236 41.956099, 2.808152 41.955287, 2.808080 41.955066, 2.807523 41.954597, 2.807963 41.954463, 2.807990 41.954268, 2.807954 41.954181, 2.808247 41.954104, 2.808350 41.954077, 2.808771 41.953966, 2.809508 41.953819, 2.809770 41.953761, 2.808274 41.952756, 2.808143 41.952438, 2.807246 41.951975, 2.807118 41.951841, 2.806777 41.951546, 2.806744 41.951471, 2.806481 41.950875, 2.806508 41.950867, 2.806283 41.950412, 2.806253 41.949939, 2.805936 41.949427, 2.805834 41.949078, 2.805934 41.948636, 2.805735 41.948474, 2.805654 41.948394, 2.805627 41.948032, 2.805519 41.947650, 2.805367 41.947509, 2.805354 41.947461, 2.805412 41.947187, 2.805376 41.946912, 2.805367 41.946476, 2.805439 41.946067, 2.805524 41.945755, 2.806605 41.944413, 2.803406 41.941608, 2.802709 41.941017, 2.802950 41.941037, 2.797434 41.934613, 2.796563 41.933746, 2.796168 41.933290, 2.796015 41.933069, 2.795881 41.932847, 2.795674 41.932472, 2.795512 41.932096, 2.795360 41.931633, 2.795476 41.931600, 2.794695 41.930137, 2.794731 41.930110, 2.794847 41.930077, 2.794991 41.930084, 2.793438 41.927657, 2.793725 41.927816, 2.793886 41.927937, 2.794021 41.927367, 2.793960 41.927263, 2.797426 41.928132, 2.797381 41.928024, 2.797381 41.927857, 2.797399 41.927796, 2.797444 41.927716, 2.797542 41.927615, 2.797659 41.927541, 2.797821 41.927481, 2.792305 41.920477, 2.792144 41.919773, 2.791931 41.918714, 2.791587 41.916357, 2.791566 41.916281))"
}
]
},
"server": {
"value": "lb.cercalia.com"
},
"instance": {
"value": "http://master-cercalia-lbs-both-lines"
}
}
}
| Field | Description |
|---|---|
isochrone.level | Threshold value for the shape (time or distance). |
polygon | The generated area in WKT format. |
Walking Isochrones
Calculate reachable areas on foot.
Request Parameters
Example:
https://lb.cercalia.com/services/v2/json?cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=concavehull&key=YOUR_API_KEY
| Parameter | Description |
|---|---|
cmd | Isochrone request type (isochrone). |
mo | Center point coordinates (X,Y). |
mocs / ocs | Spatial Reference System (use 4326 for WGS84). |
weight | Calculation metric: time (walking duration) or distance (walking distance). |
isolevels | List of thresholds (comma-separated). |
weight=time | Threshold value in milliseconds. |
weight=distance | Threshold value in meters. |
method | Algorithm for shape generation: convexhull (simplified) or concavehull (precise). |
Supported Coverage Areas
| Code | Region |
|---|---|
esp | Iberia (Default) |
usa | USA |