Get optimized locations

POST

https://api.routestripe.com/route-matrix

This endpoint allows you to submit an optimization request using multiple variables. Here you may set up optimization coefficient, add objects with corresponding parameters, and test out the possible responses.

Request

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.routestripe.com/route-matrix' \
--header 'Content-Type: application/json' \
--data '{
    "fleet": {
        "Vehicle 1": {
            "load": 0,
            "profile": "car",
            "shift_end": "21:00",
            "vehicle_id": 55,
            "shift_start": "08:00",
            "max_distance": 0,
            "speed_factor": 1,
            "start_location": {
                "id": "Warehouse_id",
                "lat": 50.426195,
                "lng": 30.538123,
                "name": "Warehouse_Name"
            }
        },
        "Vehicle 2": {
            "load": 100,
            "profile": "car",
            "capacity": 5,
            "shift_end": "20:11",
            "vehicle_id": 1,
            "shift_start": "13:01",
            "max_distance": 0,
            "speed_factor": 1,
            "start_location": {
                "id": "Warehouse_id",
                "lat": 50.426195,
                "lng": 30.538123,
                "name": "Warehouse_Name"
            }
        }
    },
    "visits": {
        "Visit 1": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.424083,
                "lng": 30.532379
            }
        },
        "Visit 2": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.472606,
                "lng": 30.498047
            }
        },
        "Visit 3": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.466693,
                "lng": 30.487747
            }
        }
    },
    "options": {
        "polylines": true,
        "avoid_tolls": false,
        "avoid_highways": true,
        "squash_duration": "1.00",
        "visit_balance_coefficient": 0
    },
    "country": "ukraine"
}'

Response Example

200 - Success

{
  "auth": true,
  "num_late_visits": 0,
  "num_unserved": 0,
  "solution": {
    "Vehicle 1": [
      {
        "distance": 0,
        "finish_time": "08:00",
        "location_id": "Warehouse_id",
        "arrival_time": "08:00",
        "location_name": "Warehouse_id"
      },
      {
        "distance": 7.28,
        "finish_time": "08:18",
        "location_id": "Visit 3",
        "arrival_time": "08:14",
        "location_name": "Visit 3"
      },
      {
        "distance": 2.721,
        "finish_time": "08:28",
        "location_id": "Visit 2",
        "arrival_time": "08:24",
        "location_name": "Visit 2"
      }
    ],
    "Vehicle 2": [
      {
        "distance": 0,
        "finish_time": "13:01",
        "location_id": "Warehouse_id",
        "arrival_time": "13:01",
        "location_name": "Warehouse_id"
      },
      {
        "distance": 2.506,
        "finish_time": "13:10",
        "location_id": "Visit 1",
        "arrival_time": "13:06",
        "location_name": "Visit 1"
      }
    ]
  },
  "status": "success",
  "total_break_time": 0,
  "total_idle_time": 0,
  "total_travel_time": 23,
  "total_vehicle_overtime": 0,
  "total_visit_lateness": 0,
  "total_working_time": 38,
  "unserved": null,
  "vehicle_overtime": {
    "Vehicle 1": 0,
    "Vehicle 2": 0
  },
  "total_distance": 12.507,
  "polylines": {
    "Vehicle 1": [
      "orxd_Bczzfy@sDfEgEbGg@f@_DzEsIzJc`@gaAsDgJSg@{@gJvG_I~a@cj@f@oAf@oA?oA?oASoAS{@g@{@{@Sg@Sg@Rg@Rg@Ro_@rg@wGrIkHfJoAbBcBvBgO~R_DrDknAj}AwQnUcVb[_DfEsDzE{EvG{EbGwLzO_InK_{@jiAg@f@gh@fr@gJvL_{@jiAsDzEcBbB_Xr]wB~CwcArtA_DfEcBvBos@zaAcVj\\on@~_AgYbe@g@z@_IjM{@f@wBrDg@f@oAz@cBz@cBz@gJzEkCvBkCvBcBbB{E~HkCnFg^zr@_InPsIbQoAjCcQr]gEnFkCjC{EjC_DnA{Ez@{JbBg@RgEf@gJbB_NvBwVrD_Df@_DRwBRgEf@sDf@sIz@oARcBnAcBbBwBfEcBzEg@nFcBrSoA~Rg@rDcBrNg@bBg@vBg@bB{@vBsNsDoZwG_v@cQsDSwBRg@?S?SRSRSRg@RSf@Sf@{@bL{Erg@{@vLg@bGcBvQoAvLsDb`@sDzc@{@~HcBrS{Ebj@cBvQcBbQoAzO{@fJSbBkM~xAsDja@wBfT{@zJ{@fJ_Dz^?RSjC{Ebj@SbBoA~M{@zJSjCS~CcGvo@{@~MSnAgEfc@cB~RgEfc@g@nFg@zE?nA{JngASjCSz@{@zJcBnP?f@g@zE_Dv[SjC?z@gErb@oF~k@SrDoFjk@g@zEg@bGcBfT{ObfB{Eve@kCj\\g@~C?nAg@nF{J~dAoAzOSvBsD~a@SnAg@~CcBrD{@f@oAf@_Df@sIrIoFnFsDfEoAz@sIzJoAz@wGjHcBbBkCjC{JnKkC~C_XrXSRsDrDoFvG{^b`@SRcQvQsIrI{EnFkR~RcQvQ{JnK{EnF{m@bo@sDz@_Dg@sX_I_]wLoU{J_SkHsN{E_NgEcBg@cVg@oPS{ESRbG?jC?vLf@n_@?vLf@~f@?zEf@j\\Rz^RnK?fORnUS~HSvGg@~CoAvGg@z@Sz@sXfw@cBrDkH~RwBnF_I~RoA~CsDnK_IbQcGnKcBvBoPbQ_DrDkWvVsNrNwBvBoFfEwBvBgOfOoAnAka@fc@oKnK_NfO_DrDSRScBS_DSwBwLsb@wVkz@g@oA?oASg@g@?{@S{@RwBg@{aA_NoA?wQnAcBRg^zJw[nKoKrD_Dz@{J~CoAf@{TrDwQjCkHRoPR?oAf@{^RcLnAgkA_q@_DoFg@kCS{ErDwLnA_SgE{@g@sSwGoFg@{h@oAsDSwVoAcGS_S{@w`@oA_DSc[{@{ESg@?cB??{@Sg@Sg@Sg@SSg@?g@RSRSf@wB{@wBkCoAgEg@cG?gER{Ef@_Df@{@jHkMbQoZrIsNzYwe@~C{ErS_X~H_IbBoAvGoF~u@s{@zE{EbVsNzEkCvGoFbBkCnAkCnA_DzJ_b@bGkWnAsI?{ESgESwGcLcy@oA{EwB{EsDgE{TcVoFwGcVgc@sI_SoF_XkCoZoA{^Ska@?kCg@c~@{@wG_DgEwBkCkCkCcLsNoAwB_NsSkp@_jAgEwGcBkCkCgESSwB_DoAwBwLgT_DoFsSs]oAwBkM_ScLcQcG{J{@oAkCgEwBfEc`@bt@gEfJoFvL{@bBg@nAg@nAg@z@{@bBsIzO_DvGcGbL_DbGkW~f@gOnZcLzToKjRgJbQgJbQ{@nA{EfJvB~CvBjHja@vo@zERfTr]~CcBbQnZoFvL"
    ],
    "Vehicle 2": [
      "orxd_Bczzfy@sDfEgEbGg@f@_DzEsIzJc`@gaAsDgJSg@{@gJvG_I~a@cj@jHsIjHgJzOsS~CgEni@os@v[w`@~CsDnFwG~H_IrIkHnP{Jve@gYnKwGzEkCjHoFzEwGb`@gh@rDoF~CrIjHvQzTbj@z@jCz@bBnAvBvB~CvB~CvVvVnKnKzTbVv[~\\jk@rl@jCjCfYzYzEnF~R~R~C~CR~HsN~_A{Jbo@{@jHsIzh@_Ifh@{@bGoAbGSbBoPzfA{@bGgOr`AwBvLoAfJcBbLoFv[_I~f@cBbLSjCcGja@sI_D_v@oPkC{@gJwBoPsDsDwBsg@{YwB{@_SgOkCoA{c@_IcBg@fE{O"
    ]
  }
}

Modified at 2026-07-09 11:59:58

API Parameters

Store Visit