---
title: "경로 매트릭스"
method: POST
path: "/matrix"
---

# 경로 매트릭스

`POST /matrix`

## Query parameters

- `version` string, required
- `callback` string

## Headers

- `appKey` string, required

## Request body

- object
  - `origins` object[] — origins : 출발지 목록 입니다. 목록 전체는 대괄호[] 각각의 리스트는 중괄호{}로 묶습니다.<br>- lon : 출발지 경도 좌표입니다.<br> - lat : 출발지 위도 좌표입니다.<br> - poiId : 출발지 POI ID(POI 검색 결과로 얻은 값)입니다.<br> - rpFlag : 출발지의 RP Flag 정보입니다. 명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다.
    - `lon` string, required
    - `lat` string, required
    - `poiId` string
    - `rpFlag` 'S' | 'G'
  - `destinations` object[] — 목적지 목록 입니다. 목록 전체는 대괄호[] 각각의 리스트는 중괄호{}로 묶습니다.<br> - lon : 목적지 경도 좌표입니다.<br> - lat : 목적지 위도 좌표입니다.<br> - poiId : 목적지 POI ID(POI 검색 결과로 얻은 값)입니다.<br> - rpFlag : 목적지의 RP Flag 정보입니다. 명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다.
    - `lon` string, required
    - `lat` string, required
    - `poiId` string
    - `rpFlag` 'S' | 'G'
  - `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`

200

- object
  - `meta` object
    - `status` string
    - `message` string
    - `moduleVersion` string
    - `mapVersion` string
    - `elapsedTime` integer
    - `realTimeTrafficDateTime` string
    - `patternTrafficDate` string
    - `customizationDateTime` string
    - `algorithm` string
    - `metric` string
    - `requestId` string
    - `gasStationPriceDateTime` string
    - `transportMode` string
  - `origins` object[]
    - `link` object
      - `linkId` string
      - `direction` string
    - `poiId` string
    - `name` string
    - `coordinate` object
      - `latitude` number
      - `longitude` number
    - `rpFlag` string
  - `destinations` object[]
    - `link` object
      - `linkId` string
      - `direction` string
    - `poiId` string
    - `name` string
    - `coordinate` object
      - `latitude` number
      - `longitude` number
    - `rpFlag` string
  - `matrixRoutes` object[]
    - `status` string
    - `originIndex` integer
    - `destinationIndex` integer
    - `cost` integer
    - `duration` integer
    - `distance` number

## Other responses

- `400` — 400

---

[API](https://skmtc.net/sk/apis/tmap-api-2.md) · [All operations](https://skmtc.net/sk/apis/tmap-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sk/tmap-api-2/versions/2539b7eaa35a/schema)