Automatic Route Optimization

Orders delivery stops into the shortest route from an origin, for one driver or a fleet, and returns them in driving order with the total distance.

POST/v3/store/smart-city/automatic-route-optimizationTry it

• Price1 ICper request
• Served170.6Kcalls

• v1.0
• Active

Input

driverSize

-1

origin

address: คลังสินค้า ถนนวิภาวดีรังสิต latitude: 13.7882814 longitude: 100.5528693

routes

2 × { customerName, customerPhone, customerAddress, item, instructionDriver, latitude, longitude }

OutputPOST /v3/store/smart-city/automatic-route-optimization

jobs

2 × { customerName, customerPhone, customerAddress, item, instructionCC, instructionDriver, latitude, longitude }

numberOfDrops

2

routes

202/1 ซอยอินทามระ 6 เขตพญาไท กรุงเทพมหานคร 10400 บิ๊กซี สะพานควาย

totalDistanceKm

5.32

Every field, under Response

Request

curl -X POST https://api.iapp.co.th/v3/store/smart-city/automatic-route-optimization \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"driverSize": -1, "origin": {"address": "คลังสินค้า ถนนวิภาวดีรังสิต", "latitude": 13.7882814, "longitude": 100.5528693}, "routes": [{"customerName": "สมชาย ใจดี", "customerPhone": "0800000001", "customerAddress": "202/1 ซอยอินทามระ 6 เขตพญาไท กรุงเทพมหานคร 10400", "item": "กล่องอาหาร", "instructionDriver": "โทรก่อนถึง", "latitude": 13.7884637, "longitude": 100.5550741}, {"customerName": "สมหญิง รักดี", "customerPhone": "0800000002", "customerAddress": "บิ๊กซี สะพานควาย", "item": "กาแฟ 2 กล่อง"}]}'

Response

200OK. The fields are explained under Response.

{
  "jobs": [
    { "customerName": "สมชาย ใจดี", "customerPhone": "0800000001",
      "customerAddress": "202/1 ซอยอินทามระ 6 เขตพญาไท กรุงเทพมหานคร 10400",
      "item": "กล่องอาหาร", "instructionCC": "", "instructionDriver": "โทรก่อนถึง",
      "latitude": 13.7884637, "longitude": 100.5550741 },
    { "customerName": "สมหญิง รักดี", "customerPhone": "0800000002",
      "customerAddress": "บิ๊กซี สะพานควาย", "item": "กาแฟ 2 กล่อง",
      "instructionCC": "", "instructionDriver": "" }
  ],
  "numberOfDrops": 2,
  "routes": ["202/1 ซอยอินทามระ 6 เขตพญาไท กรุงเทพมหานคร 10400", "บิ๊กซี สะพานควาย"],
  "totalDistanceKm": 5.32
}

Request

JSON. 1 IC per request, up to 100 stops.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

driverSizeintegerrequired

How many drivers; -1 lets the service choose.

originobjectrequired

Where the route starts: address, latitude, longitude.

routesarrayrequired

One object per stop: customerName, customerPhone, customerAddress and item required; customerMail, instructionCC for the customer care team, instructionDriver, latitude and longitude optional. A stop without coordinates is located from its address.

The legacy path /route-optimization answers at the same price.

Response

jobsarray

The stops in driving order, each with the fields you sent

routesarray

The addresses in that order

numberOfDropsinteger

How many stops

totalDistanceKmnumber

The route's length

Details

Measured

Limits

• Up to 100 stops per request.

Data handling

The service is GDPR and PDPA compliant.