배차결과요청

배차 결과 요청

  • REQUSET (CURL / GET)

curl --request GET \
     --url 'https://apis.openapi.sk.com/tms/allocationData?routeYn=N' \
     --header 'Accept: application/json' \
     --header 'appKey: My Project의 Project Key'
  • RESPONSE (200 | application/json)

{
  "resultCode": "200",
  "vehicleCount": "1",
  "resultMessage": "success",
  "vehicleList": {
    "vehicleId": "vehicle01",
    "vehicleName": "12가1234",
    "deliveryCount": 1,
    "deliveryTime": 5909,
    "deliveryDistance": 149246,
    "deliveryWeight": 37393,
    "orderList": [{
      "orderId": "order01",
      "orderName": "마포지점01",
      "address": "서울특별시 마포구 독막로 291",
      "latitude": "37.544680",
      "longitude": "126.945455",
      "serviceTime": 10,
      "zoneCode": "0001",
      "expectedArrivalTime": "201908271720",
      "expectedDepartureTime": "201908271730"
    }]
  },
  "vehicleRouteList": {
    "vehicleId": "vehicle01",
    "vehicleName": "12가1234",
    "deliveryCount": 1,
    "deliveryTime": 5909,
    "deliveryDistance": 149246,
    "deliveryWeight": 37393,
    "orderList": [{
      "orderId": "order01",
      "orderName": "마포지점01",
      "address": "서울특별시 마포구 독막로 291",
      "latitude": "37.544680",
      "longitude": "126.945455",
      "serviceTime": 10,
      "zoneCode": "0001",
      "expectedArrivalTime": "201908271720",
      "expectedDepartureTime": "201908271730"
    }],
    "startLocation": {
      "address": "서울특별시 중구 을지로2가 11 ",
      "latitude": "37.565995",
      "longitude": "126.977707"
    },
    "endLocation": {
      "address": "서울특별시 중구 을지로2가 11 ",
      "latitude": "37.565995",
      "longitude": "126.977707"
    },
    "routeList": [{
      "route": "126.97730448,37.56597646|126.97726001,37.56703745|126.97725723,37.5672402…"
    }]
  }
}
  • RESPONSE (PARAMETERS)

Name

Type

Mandatory

Example

Description

resultCode

String

Y

200

HTTP Status Code

vehicleCount

Number

Y

1

배차된 차량의 카운트 정보입니다.

resultMessage

String

Y

success

결과 메시지 정보 입니다.

vehicleList

Node

Y

배차 결과 정보입니다.

vehicleId

String

Y

vehicle01

차량 아이디 정보 입니다.

vehicleName

String

N

12가1234

차량 이름 정보 입니다.

deliveryCount

Number

Y

1

배송할 배송지 목록 카운트 정보 입니다.

deliveryTime

Number

Y

5909

배송에 소요되는 예상 주행 시간 (단위 : 초)

deliveryDistance

Number

Y

149246

배송에 소요되는 예상 주행 거리 (단위 : m)

deliveryWeight

Number

Y

37393

배송할 무게 정보 입니다. (단위 : Kg)

orderList

Node

Y

해당 차량의 배송지 목록 정보 입니다

orderId

String

Y

order01

배송지 아이디 정보 입니다.

orderName

String

N

마포지점01

배송지 이름 정보 입니다.

address

String

N

서울특별시 마포구 독막로 291

배송지 주소 정보 입니다.

latitude

Number

Y

37.54468

배송지 위도 정보 입니다.

longitude

Number

Y

126.945455

배송지 경도 정보 입니다.

serviceTime

Number

Y

10

해당 배송지 서비스 시간 정보 (단위 : 분)

zoneCode

String

N

0001

해당 배송지의 권역 코드 정보 입니다.

expectedArrivalTime

String

N

201908271720

해당 배송지 도착 예정 시간 (2019년 08월 27일 17시 20분 일경우 201908271720)

expectedDepartureTime

String

N

201908271730

해당 배송지 출발 예정 시간 (2019년 08월 27일 17시 30분 일경우 201908271730)

vehicleRouteList

Node

Y

배차 결과 정보입니다.

vehicleId

String

Y

vehicle01

차량 아이디 정보 입니다.

vehicleName

String

N

12가1234

차량 이름 정보 입니다.

deliveryCount

Number

Y

1

배송할 배송지 목록 카운트 정보 입니다.

deliveryTime

Number

Y

5909

배송에 소요되는 예상 주행 시간 (단위 : 초)

deliveryDistance

Number

Y

149246

배송에 소요되는 예상 주행 거리 (단위 : m)

deliveryWeight

Number

Y

37393

배송할 무게 정보 입니다. (단위 : Kg)

orderList

Node

Y

해당 차량의 배송지 목록 정보 입니다.

orderId

String

Y

order01

배송지 아이디 정보 입니다.

orderName

String

N

마포지점01

배송지 이름 정보 입니다.

address

String

N

서울특별시 마포구 독막로 291

배송지 주소 정보 입니다.

latitude

Number

Y

37.54468

배송지 위도 정보 입니다.

longitude

Number

Y

126.945455

배송지 경도 정보 입니다.

serviceTime

Number

Y

10

해당 배송지 서비스 시간 정보 (단위 : 분)

zoneCode

String

N

1

해당 배송지의 권역 코드 정보 입니다.

expectedArrivalTime

String

N

201908271720

해당 배송지 도착 예정 시간 (2019년 08월 27일 17시 20분 일경우 201908271720)

expectedDepartureTime

String

N

201908271730

해당 배송지 출발 예정 시간 (2019년 08월 27일 17시 30분 일경우 201908271730)

startLocation

Node

Y

출발지 정보입니다.

address

String

N

서울특별시 중구 을지로2가 11

출발지 주소 정보 입니다.

latitude

Number

Y

37.565995

출발지 위도 정보 입니다.

longitude

Number

Y

126.977707

출발지 경도 정보 입니다.

endLocation

Node

Y

도착지 정보입니다.

address

String

N

서울특별시 중구 을지로2가 11

도착지주소 정보 입니다.

latitude

Number

Y

37.565995

도착지 위도 정보 입니다.

longitude

Number

Y

126.977707

도착지 경도 정보 입니다.

routeList

Node

Y

경로의 좌표 정보입니다.

route

String

Y

route: "126.97730448,37.56597646|126.97726001,37.56703745|126.97725723,37.5672402…"

경로의 좌표 정보입니다.(경도좌표와 위도의 구분자는 ','이고 좌표와 좌표의 구분자는 '|' 로 구성되어있습니다. Ex)경도,위도|경도,위도|…)