Isochrones API (1.0.0)

Isochrone API calculates the regions that can be reached within a designated time / distance / battery consumption frame from a given location. It returns an area which can be displayed on the map and subsequently used as a geographic filter in location and reverse geocode search API.

Isochrones

Get a geographic area via POST

Get a geographic area which can be reached in a designated time / distance / battery consumption frame.

Authorizations:
ApiKey
Request Body schema: application/json
required

Isochrones parameters

transport
string
Enum: "car" "lorry" "truck" "pedestrian" "bike" "public"

Route transport mode

type
string
Enum: "fastest" "shortest" "economic" "scenic"

Route type

departure
required
Array of numbers <float> [ items <float > ]

isochrone departure as [longitude, latitude]

avoid
Array of strings
Items Enum: "highway" "toll" "ferry" "unpaved" "turnaround" "traffic" "roadblocks"
ranges
required
Array of integers

range values depending on route type:

  • fastest: travel time in seconds
  • shortest: travel distance in meters
  • economic: battery consumption in watt-hours
locale
string

ISO 3166-1 language code for result

object (vehicle)

vehicle characteristics

profile
string
Enum: "road" "cross" "city" "mountain" "road_pedelec" "cross_pedelec" "city_pedelec" "mountain_pedelec" "road_spedelec" "cross_spedelec" "city_spedelec" "mountain_spedelec" "hike" "walk"

transport mode detailed profile:

  • road / cross / city / mountain: for bike transport mode. Default value is "city"
  • road_pedelec / cross_pedelec / city_pedelec / mountain_pedelec: for bike transport mode with eBike pedelec tunning
  • road_spedelec / cross_spedelec / city_spedelec / mountain_spedelec: for bike transport mode with eBike speed pedelec tunning
  • hike / walk: for pedestrian transport mode. Default value is "walk"
mass
integer

vehicle mass in kg

speed
number <float>

reference speed for the vehicle in m/s. For truck transport is considered the vehicle max speed.

fuel
string
Default: "petrol"
Enum: "electric" "petrol" "diesel" "lpg"

the vehicle fuel type. For electricity fuel type (in conjunction with transport mode car/truck), an EV routing solution is generated with intermediate charging station stops

batt_capacity
integer

battery capacity for EV and eBikes in Wh

charger_ports
Array of strings
Items Enum: "j1772" "mennekes" "type2" "type3" "gbt_ac" "gbt_dc" "chademo" "css1" "css2" "tesla" "super_tesla" "super_tesla_ccs" "tesla_destination"
range
integer

vehicle range in meters. Currently used only for EVs

charge
integer

EV km charged in one hour (with battery capacity in 10% - 80% )

height
integer

vehicle height in cm

length
integer

vehicle length in cm

width
integer

vehicle length in cm

axle
integer

vehicle axle load in kg

departure_soc
number <float>

EV departure battery SoC. ( 0 - empty, 1 - full )

chargerArrival_soc
number <float>

EV minimum SoC when arriving to a charging station

chargerDeparture_soc
number <float>

EV maximum SoC when leaving a charging station

destination_soc
number <float>

EV minimum SoC when arriving at destination

charger_overhead
number <float>

EV overhead time spent in a charging station, in minutes

plate
string

vehicle plate. Used for avoidance on roads with access restrictions based on plate manstissa

Responses

Response Schema: application/json
Array
object
copyrights
Array of strings
Array of objects
Array
distance
integer

route total distance in meters

time
integer

route total time in seconds

bbox
Array of numbers <float> [ items <float > ]

route bbox [ east, south, west, north ]

object or object

range polygon coordinates list

One of
type
string
coords
required
Array of numbers (path_coords) [ items <float >[ items <float > ] ]

path in a form of coordinates array [[ lon, lat, alt], ...]

polyline
string (path_polyline)

path encoded as Google polyline

Request samples

Content type
application/json
{
  • "transport": "car",
  • "type": "fastest",
  • "geometry": "polyline",
  • "ranges": [
    • 1200
    ],
  • "avoid": [
    • "unpaved",
    • "highway",
    • "traffic"
    ],
  • "departure": [
    • 8.165682,
    • 49.61167
    ]
}

Response samples

Content type
application/json
[
  • {
    • "info": {
      • "copyrights": [
        • "MagicLane"
        ]
      }
    },
  • {
    • "routes": [
      • {
        • "distance": 1200,
        • "time": 1200,
        • "bbox": [
          • 7.96876,
          • 49.47344,
          • 8.4062,
          • 49.74558
          ],
        • "points": {
          • "type": "polyline",
          • "polyline": "}|rnHspop@vG|GzA|PtG?xD}PtGnLrJ??oLsJmLxDmLvG?dV{Yza@mLdVdkAnM|P|A|PpJlL?lLvG?xD_H?mLyDmCxDoCzA}PxDoCtG{YrJmL{AmUsJmL}AmL?yk@bYmU|A}GrJoCtG{Plm@}Ypj@nCxD_HtG|Y?|PrJzPzA|YtG|GxDj^vG~GzAzPnM|P|AlUnM|PtGzYxDvt@{Azk@tGzPrJ~G?|PtG|G?|PxD|Ggs@nCcv@mLyDmLev@oC?lLza@~GpJ|P|Axb@tG??}PlPmCxDmLxa@|G`y@??leCuGhp@zAlUuGj^xDhg@jP|G?j^sJnC?|PfV|GzAmLlP?rJ}GxD|GsJ~G?lLxD|GwGnC?lLrJ?|A}GxD?zAjUtG?|AmLrJlLtG?xDig@nM?zAbtA|^fbA|Aj^jPxt@?fp@vG??ebAwGmL{A}YyDmCzA_HuGk^iSk^yDkU?wfAxDmCzAlLvGlC?nLnM?zAzPvG?zA}GvG|P?zYtG?xD{YnMnC{Ak^tGgkArJkUpJ??}PxDoC?mLyDoC|^mC|AlLpJnC|AzPrJnC?~GpJ?fVzPtG|PlPnCtG|PnMlLxDzY{AlLya@hp@yD{YyDoCoMnC?lLqM|G?nLpM|G}A|PkPzY?~GgVxk@zAhg@vGzYrJnCwGig@vGmU}AkUxD}PtG_HpMig@tGj^tG?{Ak^rJoCvDkUfVk^xD|GsJlU?tfAzA|GrJ?{AekAtGmLxD{YxDoCxD{YxDnC?|PjPzY?lLhSvt@?vfAxDlL?|PvG?}Ak^xDoC?ig@iSgbAhSoC?mLeV?mPyb@}A}PuG_H|A}GtG?tGmLhSlC?{PqJ?wGoL?}GlPk^hS}PxDlUrJ|G?lUtGlLtG?|AlLxD?tGlLxDzYxD?xD|PvD?pMzY?lUsJ|GzAv}@rJmLyDyb@nMmU?{YiS{YeVyt@a\\ig@?_HkPk^?mLoM{YzA}PlP{Ynj@lLlPxk@?jUbY|P?lLtG|P?lUxDnCtGxb@?|YxDlC?lLfVzb@?lLnMnCtGlLpM?tG|PhS?lPmLvD}YvGmLxD?tG{YrJ?zAkUiS?uGlL?zPwG|PqJ~G}A|PuG|GyDoC{A~GiSmUwGnCyDmLqJ?gVyk@sJiy@|A}GnM?xD|G?nLtG?nMoLxD~G?lLlPnC?{b@sJoC|AkUyD_HwG?ya@wt@yD}P|A{YtGoCxD}PzA|PvG?zA{YmP}YxDmC|AmLhSxb@jP~G|AlLdVzY|AzYrJ~GsJzYtGj^tGlLvGmL?}PtGoC?{PuGoCnM}PzAmUrJ{PnMzP?~GbYjUxDhp@uG~G?|PxD?tGzP{Ajg@xD|GtG??ekAyDoCtGmC?}PwDoCtGoCzAig@xDoCuG{YxDoC?}PxDmCyDk^sJmLxDhg@}A|PuG|G?lUuGoCyD~GmPoLoMkU{A{b@yDmCxDoLpJ??{PqJ?qMoL?mLyDmC|A}YoM}GtGoC?}PiSgy@hp@?xD|G{A~GuG?vDzb@pM??oLyDmCxD_HzAk^nM~G{Ahp@tG?xDk^rJ|GzAzb@vG?bYk^tG?zAxb@rJ|P?~GtGlC?nLvG|GhSnC?mLmP_HeVyk@zAmUfV~G?mLwGmLcYoC?w}@oMyt@sJmL?}GeVlLyDoC{Agy@tG}P~[lL|AlLpJ~GvG??mLsJ}PgV}Pya@oCuGkUxDmLxDyt@xDoCtGnL?jUnM|G|^hp@tG?rJ|PlP?zA~Gvd@j^xDlLtG?{AmU{a@{Y{A}PgV?}^k^cY{b@?}GqJ}G?}PwGmL?mUcYw}@|Aw}@lPmUvDnLwDj^pJlCyD~G?|PvG?xDlLtG?zA|PpM??oLsJkUzAip@rJoCzA}PvGnC?|PxD?tGzYrJnLjP?wDip@sJoLzA}Gza@?tGlLuGlL?lLjPmCtGlL?lLvG?zAmLrJ?tGk^yD{YwDoCzA}PnM}Gpj@lCxD~GnMnC?zYtG?vGmLvD?xDlLvG?tGmLzA}PwDmLtGmLrJzPxDzb@tG|GzAfbAvG??gy@tGoCnMlLtG??mLud@kUoM}Y?mLqMk^fV}GtGjU?nLhSjU?}PuGmL?}PuGmLxa@oChS~G?}PoM}Gwd@?iSlLmP?yDlLwDoC}A{YyD_HrJmCxDmUrJnC?_HxDmC~[|GxD~GtG?|A_HtG~GrJ??oLsJ}G?}GuGoL?mLcYlLyDnL{a@_H?~GwDlCwGk^sJ{PwDk^tGoCxDlLnM??mLyD?iS{YuG?qMoLya@ebAcYmL{A}YtGmC?}YmPnC{A}GuG??|GyDnC}AmLqJmLwGkg@kP{b@?mLtG}GxDig@nMoC?mLyD_HkP?}AkUuGoCxD}P?ip@wG?yDfbAwD|GsJ??~GsJ|G{AlUa\\jUsJ?uGlLmPmCuG|GiS?{A~GyD_HzAmLmPgbAuGmLxD}P?kUuGmU}A{YxD}GtG?rJoLhS}GpMmLtG}PsJoCsJ|PyD?uGlLyDmCoMzPuG}GzAsaBuGip@dV}G?mLyDoC|A{YxDoC}AkUvGyt@}A}PuG?}Azb@wD|G{a@|PoMlU{AzYvD|PeVzYyDmL?wt@rJoC?mLsJ_HtG}PkPkUiS??j^jPzY{A|PsJ?mm@{b@yDnCuGmL?mLoM_HvDmLjS??mLcYoCiSzb@sJnCwd@kg@uG?yDyb@xD}PyDk^zA{YuG{b@tGoC?mLoMmUhS}G?mLsJ_HeVnCiS{b@wG?wD|Ywd@_H?yb@mPyt@uG}G?{b@tG}G|AmUtG}G?oLtG{Pza@kg@dVmCfVmUnj@nCfs@hg@xD}GyDmLuG?a\\}YcYmL{^?sJ~GcYoC?lLya@zb@mPxb@uGnCyDj^yDnC}A|PoMlLyDj^}^xb@_\\~GyD_HrJkUxD?zA{YuG?cYxk@yDoLnM{P?kg@oM?{Azb@qMnC{A}PsJ?uGk^?}PmP{Y{A{b@xDoCzAkUsJnC{A}PsJoCrJ`fBsJ|PsJoC{A~GuG??lLbYoCjPkUvG|PzAzYsJlLuG?uGlLwG?yD|PoM?cYzY?|PtGnC|AzYrJ|GqMnCwDzYwG~G?lLxDnCyDlC?nLxDlC{A~GsJ?}A|GoMoC{A~GiS{YoMlC?{YsJ{b@bYmL?mLgVnC{A_HwG?{AlLgV}G{A|Pmm@oCyDlLuGmCmm@zPmm@?yD}GcY?mPlL{A}PwG?yDlLcY~G?lLdv@?zA}GvG?tGzPoM~G?lLvd@nCpJjUvG}GzAmLhS?rJ_HxD~GzAtfAyD|GqgA|PuGmC?oLsJ??~GuGlLoM?wG}GvG}P?mLiS}YkSnC?lLpMnC}A|GyD??lLvG?zA~GeV|P?jUpJnCuGnC?zYuGlU?zYsJnC?lLhS|G?zb@mPlC?nLlPlCyDnLuG?zAjUrJnC?hp@yD|G?lUuGzPgV?yD~G?lL`\\oCxD~G}AdbAiS?xD|Y{AlLmP?oMmL}AlCoM{P{AlCyDk^sJ?{A~GyDoCzAk^yDoC|A}PwGsoAyD_H|A}PuG}GyDnCnM~nBzAvfAyD|GqJ?cY|PoMoC}AnLuG?}A|GeVlLa\\oC|A|Yvd@_HjP}PlPmCnMmLxa@oLxD~GxDrxAuGjUyDzk@rJoCnMw}@?mUyDmC?ekAhSlCxDnLrJ?~[zPvGnL?lLnMoCpJjUpMz}G}Ahp@iS?sJlLwDk^wG?uG|PmPoCsg@gy@yDnCoMmUuGnC?|PtG?tGlLrJ?zA|PlP|GnMzYy~@lLsJ|PyD??lLtG?vGmLbY}Gxa@?rJ_HzA~GrJlC?nLdVxb@{Aj^yDnC?lLxDnC{AjUvDnCoMdtA|Axk@sJ|GyDlLgVlLwDnLgVzPcYyb@mPoCwD}G}AmUoM}P}AnCuGmLsJlC{A}GsJoCoM}PuG?vDzb@jS?vD~GlP?|A|GtG?xD~G?h^bY~GtG|G?~GsJ|GyD|PuGoCgs@j^yD|PyDoCeVnLuGoL?}GwG??xk@"
          }
        }
      ]
    }
]