Isochrones

Web services

Isochrones API documentation, available via HTTP-JSON/XML service.

URL base service:

* 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=convexhull&net=esp

Where:

  • mo= coord X,Y isochrone center point
  • 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: improved shape isochrone
    • concavehull: simplified 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="" 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

Countries availables:

Code

Name

ESP (*)

Iberia + South of France

FRA

France, Monaco

ITA

Italy, San Marino

BNL

Benelux

GBR

Great Britain

CHE

Switzerland, Austria, Liechtenstein

DEU

Germany

DNK

Denmark

MEX

Mexico

ARG

Argentina, Chile, Uruguay

COL

Colombia

TUR

Turkey

BRA

Brazil

USA

USA

ROU

Romania, Bulgaria

ISR

Israel

(*) Default value

Isochrones, walking

Request:

Example:

&cmd=isochrone&weight=time&mocs=4326&ocs=4326&mo=2.8260807,41.9723144&isolevels=120000,300000,600000&method=convexhull

Where:

  • mo= coord X,Y isochrone center point
  • 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: improved shape isochrone
    • concavehull: simplified 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