---
title: "보행자 경로안내"
method: POST
path: "/routes/pedestrian"
---

# 보행자 경로안내

`POST /routes/pedestrian`

## Query parameters

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

## Headers

- `appKey` string, required

## Request body

- object
  - `startX` number, float, required — 출발지 X좌표입니다.<br>- 경도를 의미합니다.
  - `startY` number, float, required — 출발지 Y좌표입니다.<br>- 위도를 의미합니다.
  - `angle` integer — 각도입니다.<br>- 유효값: 0 ~ 359
  - `speed` integer — 진행속도(Km/h)입니다.
  - `endPoiId` string — 목적지의 POI ID입니다
  - `endX` number, float, required — 목적지 X좌표입니다.<br>- 경도를 의미합니다.
  - `endY` number, float, required — 목적지 Y좌표입니다.<br>- 위도를 의미합니다.
  - `passList` string — 경유지들의 X 좌표, Y 좌표를 콤마(,)와 밑줄(_)로 구분하여 순서대로 나열합니다.(최대 5곳)<br><br>[Example] EPSG3857 : 14129532.299387,4516604.799424<br>WGS84GEO : 126.92774822,37.55395475<br>KATECH : 550731.50961,305456.416955
  - `reqCoordType` string — 출발지, 경유지, 목적지 좌표계 유형을 지정합니다.<br>지구 위의 위치를 나타내는 좌표 타입입니다. <br>1) EPSG3857 - Google Mercator<br>2) WGS84GEO(기본값) - 경위도<br>3) KATECH - TM128(Transverse Mercator:횡메카토르): 한국 표준
  - `startName` string, required — 출발지 명칭입니다.<br>- UTF-8 기반 URL인코딩으로 처리 해야 합니다.
  - `endName` string, required — 목적지 명칭입니다.<br>- UTF-8 기반 URL인코딩으로 처리 해야 합니다.
  - `searchOption` string — 경로 탐색 옵션입니다.<br>- 0: 추천 (기본값)<br>- 4: 추천+대로우선<br>- 10: 최단<br>- 30: 최단거리+계단제외
  - `resCoordType` string — 받고자 하는 응답 좌표계 유형을 지정합니다.<br>지구 위의 위치를 나타내는 좌표 타입입니다.<br><br>1) EPSG3857 - Google Mercator<br>2) WGS84GEO(기본값) - 경위도<br>3) KATECH - TM128(Transverse Mercator:횡메카토르): 한국 표준
  - `sort` string — 지리정보 개체의 정렬 순서를 지정합니다.<br>1) index(기본값)<br>- 노드의 종류에 상관없이 인덱스의 순서로 정렬을 합니다.<br>2) custom<br>- 라인노드, 포인트노드의 순서로 정렬을 합니다.

## Response `200`

200

- object

## Other responses

- `401` — 401

---

[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)