logistics

Routing

Etas, routes and turn by turn directions

Directions $0.001 per request

POSThttps://api.m3o.com/v1/routing/Directions

Turn by turn directions from a start point to an end point including maneuvers and bearings

Request payload

destination object

The destination of the journey

origin object

The staring point for the journey

Response

directions object array

Turn by turn directions

distance number

Estimated distance of the route in meters

duration number

Estimated duration of the route in seconds

waypoints object array

The waypoints on the route

Request

    curl "https://api.m3o.com/v1/routing/Directions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
  "destination": {
    "latitude": 52.529407,
    "longitude": 13.397634
  },
  "origin": {
    "latitude": 52.517037,
    "longitude": 13.38886
  }
}'

Response

{
 "directions": [
  {
   "name": "Torstraße",
   "instruction": "depart ",
   "distance": 748.7000122070312,
   "duration": 122.4000015258789,
   "maneuver": {
    "bearing_after": 265,
    "location": {
     "latitude": 52.529432,
     "longitude": 13.397627
    },
    "action": "depart"
   },
   "intersections": [
    {
     "location": {
      "latitude": 52.529432,
      "longitude": 13.397627
     },
     "bearings": [
      265
     ]
    },
    {
     "location": {
      "latitude": 52.529429,
      "longitude": 13.397565
     },
     "bearings": [
      90,
      180,
      255,
      345
     ]
    },
    {
     "location": {
      "latitude": 52.528996,
      "longitude": 13.395724
     },
     "bearings": [
      75,
      255,
      345
     ]
    },
    {
     "location": {
      "latitude": 52.528526,
      "longitude": 13.393814
     },
     "bearings": [
      75,
      135,
      255,
      315
     ]
    },
    {
     "location": {
      "latitude": 52.528233,
      "longitude": 13.392425
     },
     "bearings": [
      75,
      165,
      255
     ]
    },
    {
     "location": {
      "latitude": 52.528032,
      "longitude": 13.391396
     },
     "bearings": [
      75,
      255,
      330
     ]
    },
    {
     "location": {
      "latitude": 52.527549,
      "longitude": 13.389147
     },
     "bearings": [
      75,
      255,
      345
     ]
    }
   ]
  },
  {
   "name": "Friedrichstraße",
   "instruction": "turn left",
   "distance": 1151,
   "duration": 135.8000030517578,
   "maneuver": {
    "bearing_before": 251,
    "bearing_after": 257,
    "location": {
     "latitude": 52.527166,
     "longitude": 13.387215
    },
    "action": "turn",
    "direction": "left"
   },
   "intersections": [
    {
     "location": {
      "latitude": 52.527166,
      "longitude": 13.387215
     },
     "bearings": [
      75,
      180,
      255,
      330
     ]
    },
    {
     "location": {
      "latitude": 52.527137,
      "longitude": 13.386982
     },
     "bearings": [
      75,
      165,
      255,
      330
     ]
    },
    {
     "location": {
      "latitude": 52.526374,
      "longitude": 13.387144
     },
     "bearings": [
      0,
      75,
      180
     ]
    },
    {
     "location": {
      "latitude": 52.526292,
      "longitude": 13.387156
     },
     "bearings": [
      0,
      120,
      180
     ]
    },
    {
     "location": {
      "latitude": 52.525018,
      "longitude": 13.387368
     },
     "bearings": [
      0,
      180,
      255
     ]
    },
    {
     "location": {
      "latitude": 52.523863,
      "longitude": 13.387568
     },
     "bearings": [
      0,
      90,
      180,
      255
     ]
    },
    {
     "location": {
      "latitude": 52.522524,
      "longitude": 13.387885
     },
     "bearings": [
      0,
      180,
      225
     ]
    },
    {
     "location": {
      "latitude": 52.52175,
      "longitude": 13.388024
     },
     "bearings": [
      0,
      60,
      180,
      225
     ]
    },
    {
     "location": {
      "latitude": 52.520332,
      "longitude": 13.388224
     },
     "bearings": [
      0,
      90,
      180,
      285
     ]
    },
    {
     "location": {
      "latitude": 52.520298,
      "longitude": 13.388228
     },
     "bearings": [
      0,
      180
     ]
    },
    {
     "location": {
      "latitude": 52.519905,
      "longitude": 13.388272
     },
     "bearings": [
      0,
      180
     ]
    },
    {
     "location": {
      "latitude": 52.519822,
      "longitude": 13.38828
     },
     "bearings": [
      0,
      195,
      270
     ]
    },
    {
     "location": {
      "latitude": 52.518716,
      "longitude": 13.388544
     },
     "bearings": [
      30,
      90,
      180,
      270,
      315
     ]
    },
    {
     "location": {
      "latitude": 52.518027,
      "longitude": 13.388643
     },
     "bearings": [
      0,
      90,
      180,
      270
     ]
    },
    {
     "location": {
      "latitude": 52.517155,
      "longitude": 13.388779
     },
     "bearings": [
      0,
      90,
      180,
      270
     ]
    }
   ]
  },
  {
   "name": "Friedrichstraße",
   "instruction": "arrive ",
   "maneuver": {
    "bearing_before": 174,
    "location": {
     "latitude": 52.517036,
     "longitude": 13.388798
    },
    "action": "arrive"
   },
   "intersections": [
    {
     "location": {
      "latitude": 52.517036,
      "longitude": 13.388798
     },
     "bearings": [
      354
     ]
    }
   ]
  }
 ],
 "waypoints": [
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.529432,
    "longitude": 13.397627
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.529429,
    "longitude": 13.397565
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528996,
    "longitude": 13.395724
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528526,
    "longitude": 13.393814
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528233,
    "longitude": 13.392425
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528032,
    "longitude": 13.391396
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.527549,
    "longitude": 13.389147
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.527166,
    "longitude": 13.387215
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.527137,
    "longitude": 13.386982
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.526374,
    "longitude": 13.387144
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.526292,
    "longitude": 13.387156
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.525018,
    "longitude": 13.387368
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.523863,
    "longitude": 13.387568
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.522524,
    "longitude": 13.387885
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.52175,
    "longitude": 13.388024
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.520332,
    "longitude": 13.388224
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.520298,
    "longitude": 13.388228
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.519905,
    "longitude": 13.388272
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.519822,
    "longitude": 13.38828
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.518716,
    "longitude": 13.388544
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.518027,
    "longitude": 13.388643
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.517155,
    "longitude": 13.388779
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.517036,
    "longitude": 13.388798
   }
  }
 ],
 "distance": 1899.800048828125,
 "duration": 258.20001220703125
}

Eta $0.001 per request

POSThttps://api.m3o.com/v1/routing/Eta

Get the eta for a route from origin to destination. The eta is an estimated time based on car routes

Request payload

destination object

The end point for the eta calculation

origin object

The starting point for the eta calculation

speed number

speed in kilometers

type string

type of transport. Only "car" is supported currently.

Response

duration number

eta in seconds

Request

    curl "https://api.m3o.com/v1/routing/Eta" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
  "destination": {
    "latitude": 52.529407,
    "longitude": 13.397634
  },
  "origin": {
    "latitude": 52.517037,
    "longitude": 13.38886
  }
}'

Response

{
 "duration": 258.20001220703125
}

Route $0.001 per request

POSThttps://api.m3o.com/v1/routing/Route

Retrieve a route as a simple list of gps points along with total distance and estimated duration

Request payload

destination object

Point of destination for the trip

origin object

Point of origin for the trip

Response

distance number

estimated distance in meters

duration number

estimated duration in seconds

waypoints object array

waypoints on the route

Request

    curl "https://api.m3o.com/v1/routing/Route" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
  "destination": {
    "latitude": 52.529407,
    "longitude": 13.397634
  },
  "origin": {
    "latitude": 52.517037,
    "longitude": 13.38886
  }
}'

Response

{
 "distance": 1899.800048828125,
 "duration": 258.20001220703125,
 "waypoints": [
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.529432,
    "longitude": 13.397627
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.529429,
    "longitude": 13.397565
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528996,
    "longitude": 13.395724
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528526,
    "longitude": 13.393814
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528233,
    "longitude": 13.392425
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.528032,
    "longitude": 13.391396
   }
  },
  {
   "name": "Torstraße",
   "location": {
    "latitude": 52.527549,
    "longitude": 13.389147
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.527166,
    "longitude": 13.387215
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.527137,
    "longitude": 13.386982
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.526374,
    "longitude": 13.387144
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.526292,
    "longitude": 13.387156
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.525018,
    "longitude": 13.387368
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.523863,
    "longitude": 13.387568
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.522524,
    "longitude": 13.387885
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.52175,
    "longitude": 13.388024
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.520332,
    "longitude": 13.388224
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.520298,
    "longitude": 13.388228
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.519905,
    "longitude": 13.388272
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.519822,
    "longitude": 13.38828
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.518716,
    "longitude": 13.388544
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.518027,
    "longitude": 13.388643
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.517155,
    "longitude": 13.388779
   }
  },
  {
   "name": "Friedrichstraße",
   "location": {
    "latitude": 52.517036,
    "longitude": 13.388798
   }
  }
 ]
}