Sign in

v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

경로 매트릭스

post/matrix

Query parameters

versionstring required

API의 버전 정보입니다.

callbackstring

jsonp 포맷에서 사용하는 callback 함수명 정보입니다. <br>application/javascript 일 때 필수로 입력해야 합니다.

Headers

appKeystring required

<a href="https://openapi.sk.com/mypage/project/" target="_blank">마이페이지>앱</a>>앱키(appKey) 탭에서 확인 가능

Request body

transportMode'car' | 'pedestrian'

경로 안내시 이동수단 설정 옵션입니다.<br> - car(기본값) : 자동차<br> - pedestrian : 보행자

metric'Recommendation' | 'Static' | 'HighStreet' | 'ShortestDistance' | 'ExcludeStairs'
  • Recommendation(기본값) : 추천 경로<br> - Static : 정적 경로(교통정보 제외)<br> - HighStreet : 큰길우선<br> - ShortestDistance : 최단거리<br> - ExcludeStairs : 계단회피<br> ※ transportMode 값에 따라 사용가능한 값이 다르며 아래의 설명을 참고 바랍니다.<br> - car : Recommendation, Static 가능<br> - pedestrian : Recommendation, HighStreet, ShortestDistance, ExcludeStairs 가능

Response

200

Example response

{
  "meta": {
    "status": "Ok",
    "message": "Ok",
    "moduleVersion": "1.7.1",
    "mapVersion": "20211207",
    "elapsedTime": 53,
    "realTimeTrafficDateTime": "2021-12-22 16:05",
    "patternTrafficDate": "2021-12-22",
    "customizationDateTime": "2021-12-22 16:05",
    "algorithm": "CCH_Dijkstra",
    "metric": "Recommendation",
    "requestId": "1d840d68-acc7-4629-a18d-41cd92c82239",
    "transportMode": "Car"
  },
  "origins": [
    {
      "link": {
        "linkId": "123",
        "direction": "TwoWay"
      },
      "poiId": "123",
      "coordinate": {
        "latitude": 37.503666,
        "longitude": 126.893489
      },
      "rpFlag": "S"
    }
  ],
  "destinations": [
    {
      "link": {
        "linkId": "999",
        "direction": "Backward"
      },
      "poiId": "456",
      "coordinate": {
        "latitude": 37.803666,
        "longitude": 126.893489
      },
      "rpFlag": "G"
    }
  ],
  "matrixRoutes": [
    {
      "status": "Ok",
      "cost": 106031,
      "duration": 4229,
      "distance": 49095.9
    }
  ]
}