API Reference
카카오맵 대중교통 길찾기
출발지에서 목적지까지의 대중교통 경로 목록을 조회합니다.
카카오맵 대중교통 길찾기
대중교통 경로 목록과 총 소요시간, 도보 시간, 대중교통 시간을 반환합니다.
엔드포인트
GET /v1/kakaomap-transit-directions
Upstream
- Base URL:
https://app.map.kakao.com - Path:
/route/pubtrans_v2.json
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
origin_lat | number | ✅ | - | 출발지 위도 |
origin_lng | number | ✅ | - | 출발지 경도 |
dest_lat | number | ✅ | - | 목적지 위도 |
dest_lng | number | ✅ | - | 목적지 경도 |
departure_time | string | ❌ | - | 출발 시각 HHmm |
sort | string | ❌ | - | 정렬 기준 |
요청 예시
{
"origin_lat": 37.554722,
"origin_lng": 126.970833,
"dest_lat": 37.566295,
"dest_lng": 126.977945,
"departure_time": "0830",
"sort": "time"
}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"itineraries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"duration": {
"type": "number"
},
"walkTime": {
"type": "number"
},
"transitTime": {
"type": "number"
}
},
"required": [
"duration",
"walkTime",
"transitTime"
],
"additionalProperties": false
}
}
},
"required": [
"itineraries"
],
"additionalProperties": false
}응답 예시
{
"data": {
"incity": {
"routes": [
{
"time": {
"total": 1800
},
"steps": [
{
"type": "WALK",
"walk": {
"time": 360,
"distance": 420
}
},
{
"type": "SUBWAY",
"walk": null
},
{
"type": "WALK",
"walk": {
"time": 240,
"distance": 260
}
}
]
},
{
"time": {
"total": 2100
},
"steps": [
{
"type": "WALK",
"walk": {
"time": 600,
"distance": 700
}
},
{
"type": "BUS",
"walk": null
}
]
}
]
}
},
"pagination": null,
"meta": {
"source": "kakaomap-transit-directions",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}