경로안내 샘플예제

타임머신 자동차 길 안내

  • REQUEST ( 타임머신 자동차 길 안내 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/routes/prediction?version=1&resCoordType=WGS84GEO&reqCoordType=WGS84GEO&sort=index' \
     --header 'Accept: application/json'
  • REQUEST PAYLOAD ( 타임머신 자동차 길 안내 )

Name

Date Type

Mandatory

Example

Default

Description

routesInfo

Node

Y

길 안내 요청 정보 입니다.

departure

Node

Y

출발지 정보 입니다.

name

String

Y

출발지 명칭 입니다.

lon

Number

Y

출발지 경도 좌표 입니다.

lat

Number

Y

출발지 위도 좌표 입니다.

depSearchFlag

String

N

출발지의 좌표를 획득한 방법을 선택하는 옵션 입니다.

  • 01 : 최근길
  • 02 : 즐겨찾기
  • 03 : 경위도검색(기본 값)
  • 04 : 명칭검색
  • 05 : 주소검색

destination

Node

Y

도착지 정보 입니다.

name

String

Y

도착지 명칭 입니다.

lon

Number

Y

도착지 경도 좌표 입니다.

lat

Number

Y

도착지 위도 좌표 입니다.

poiId

String

N

도착지 POI ID(POI 검색 결과로 얻은 값)입니다.

rpFlag

String

N

도착지 RP flag 입니다.
명칭(POI)통합 검색 사용시
결과로 리턴된 rpFlag를
사용하시면 됩니다.

destSearchFlag

String

N

도착지의 좌표를 획득한 방법을 선택하는 옵션 입니다.

  • 01 : 최근길검색
  • 02 : 즐겨찾기검색
  • 03 : 경위도검색(기본 값)
  • 04 : 명칭검색
  • 05 : 주소검색
  • 06 : 통합검색

wayPoints

Node

N

경유지 정보 입니다.

  • 경유지 정보 요청 시 필수 입니다.

wayPoint

Node

N

1

경유지 정보 입니다.

  • 경유지 정보 요청 시 필수 입니다.

lon

String

Y

경유지 경도 좌표 입니다.

  • 경유지 정보 요청 시 필수 입니다.

lat

String

Y

경유지 위도 좌표 입니다.

  • 경유지 정보 요청 시 필수 입니다.

poiId

String

N

경유지 POI ID 입니다.

predictionType

String

Y

경로 서비스의 구분 입니다.

  • departure : 출발시간 예측 길 안내.
  • arrival : 도착시간 예측 길 안내

predictionTime

String

Y

길 안내의 기준이 되는 출발 혹은 도착 시간 입니다.

  • predictionType = departure 일 때는 “도착시간”을, predictionType = arrival 일 경우에는 “출발시간”을 입력해야 합니다.
  • 형태 : ISO-8601 표준.
  • 예) 2013-05-19T18:31:22+0900

searchOption

String

N

경로탐색 시 우선순위를 정하는 옵션입니다.

  • 00 : 교통최적+추천 (기본 값)
  • 01 : 교통최적+무료우선
  • 02 : 교통최적+최소시간
  • 03 : 교통최적+초보
  • 04 : 교통최적+고속도로우선
  • 10 : 최단거리+유/무료
  • 19 : 교통최적+어린이보호구역 회피

tollgateCarType

String

N

톨게이트 요금의 기준이 되는 차량의 종류 입니다.

  • car : 승용차, 소형승합차(17인승이하), 소형화물차 (기본값)
  • mediumvan : 중형승합차(17인승초과~32인승이하), 중형화물차
  • largevan : 대형승합차(33인승초과), 2축 대형화물차
  • largetruck : 대형화물차(3축 대형화물차)
  • specialtruck : 특수화물차 (4축이상 특수화물차)
  • smallcar : 경차 (배기량 1000cc미만)
  • twowheel : 이륜차(오토바이)

trafficInfo

String

N

교통정보 표출 옵션입니다.
Y:
교통정보를 포함
N:
교통정보를 포함하지 않음

  • REQUEST payload 셈플 코드
{
  "routesInfo": {
    "departure": {
      "name": "test1",
      "lon": "126.963936",
      "lat": "37.536025",
      "depSearchFlag": "05"
    },
    "destination": {
      "name": "test2",
      "lon": "129.071724",
      "lat": "35.177188",
      "poiId": "1000559885",
      "rpFlag":"16",
      "destSearchFlag": "03"
    },
    "predictionType": "departure",
    "predictionTime": "2013-05-19T18:31:22+0900",
    "wayPoints": {
      "wayPoint": [
        {
          "lon": "126.814383",
          "lat": "35.157242",
          "poiId": "1000559888"
        },
        {
          "lon": "128.565503",
          "lat": "35.874493",
          "poiId": "1000559886"
        }
      ]
    },
    "searchOption": "00",
    "tollgateCarType": "car",
    "trafficInfo" : "N"
  }
}
function (
    {
      "routesInfo": {
        "departure": {
          "name": "test1",
          "lon": "126.963936",
          "lat": "37.536025",
          "depSearchFlag": "05"
        },
        "destination": {
          "name": "test2",
          "lon": "129.071724",
          "lat": "35.177188",
          "poiId": "1000559885",
          "rpFlag":"16",
          "destSearchFlag": "03"
        },
        "predictionType": "departure",
        "predictionTime": "2013-05-19T18:31:22+0900",
        "wayPoints": {
          "wayPoint": [
            {
              "lon": "126.814383",
              "lat": "35.157242",
              "poiId": "1000559888"
            },
            {
              "lon": "128.565503",
              "lat": "35.874493",
              "poiId": "1000559886"
            }
          ]
        },
        "searchOption": "00",
        "tollgateCarType": "car",
        "trafficInfo" : "N"
      }
    }
)
  • RESPONSE ( 타임머신 자동차 길 안내 )

Name

Date Type

Mandatory

Example

Description

type

String

Y

FeatureCollection

geojson 표준 프로퍼티입니다.

features

Node

N

포인트 및 라인의 형상 정보입니다. (geojson 표준 규격)

type

String

N

Feature

출발점, 안내점, 경유지, 도착점 정보입니다.

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

Point

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
    -형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)

index

Number

N

1

경로 순번입니다.

pointIndex

Number

N

1

안내점 노드의 순번입니다.

name

String

N

지점명칭 ? 서울시시청

안내지점의 명칭입니다.

description

String

N

길 안내 정보입니다.

nextRoadName

String

N

다음 구간의 도로 명칭입니다.

turnType

Number

N

회전 정보입니다.

  • 0: 휴게소
  • 1: 도곽에 의한 점
  • 2: 타일에 의한 점
  • 3: 고속도로에 의한 안내없음
  • 4: 일반도로에 의한 안내없음
  • 5: 특수한 경우 안내없음
  • 6: Y자 오른쪽 안내없음
  • 7: Y자 왼쪽 안내없음
  • 11: 직진
  • 12: 좌회전
  • 13: 우회전
  • 14: U턴
  • 15: P턴
  • 16: 8시 방향 좌회전
  • 17: 10시 방향 좌회전
  • 18: 2시 방향 우회전
  • 19: 4시 방향 우회전
  • 43: 오른쪽
  • 44: 왼쪽
  • 51: 직진 방향
  • 52: 왼쪽 차선
  • 53: 오른쪽 차선
  • 54: 1차선
  • 55: 2차선
  • 56: 3차선
  • 57: 4차선
  • 58: 5차선
  • 59: 6차선
  • 60: 7차선
  • 61: 8차선
  • 62: 9차선
  • 63: 10차선
  • 71: 첫번째 출구
  • 72: 두번째 출구
  • 73: 첫번째 오른쪽 길
  • 74: 두번째 오른쪽 길
  • 75: 첫번째 왼쪽 길
  • 76: 두번째 왼쪽 길
  • 101: 오른쪽 고속도로 입구
  • 102: 왼쪽 고속도로 입구
  • 103: 전방 고속도로 입구
  • 104: 오른쪽 고속도로 출구
  • 105: 왼쪽 고속도로 출구
  • 106: 전방 고속도로 출구
  • 111: 오른쪽 도시고속도로 입구
  • 112: 왼쪽 도시고속도로 입구
  • 113: 전방 도시고속도로 입구
  • 114: 오른쪽 도시고속도로 출구
  • 115: 왼쪽 도시고속도로 출구
  • 116: 전방 도시고속도로 출구
  • 117: 오른쪽 방향
  • 118: 왼쪽 방향
  • 119: 지하차도
  • 120: 고가도로
  • 121: 터널
  • 122: 교량
  • 123: 지하차도옆
  • 124: 고가도로옆
  • 130: 토끼굴 진입
  • 131: 1시 방향
  • 132: 2시 방향
  • 133: 3시 방향
  • 134: 4시 방향
  • 135: 5시 방향
  • 136: 6시 방향
  • 137: 7시 방향
  • 138: 8시 방향
  • 139: 9시 방향
  • 140: 10시 방향
  • 141: 11시 방향
  • 142: 12시 방향
  • 150: 졸음쉼터
  • 151: 휴게소
  • 182: 왼쪽방향 도착안내
  • 183: 오른쪽방향 도착안내
  • 184: 경유지
  • 185: 첫번째경유지
  • 186: 두번째경유지
  • 187: 세번째경유지
  • 188: 네번째경유지
  • 189: 다섯번째경유지
  • 191: 제한속도
  • 192: 사고다발
  • 193: 급커브
  • 194: 낙석주의
  • 200: 출발지
  • 201: 도착지
  • 203: 목적지건너편
  • 233: 직진 임시

pointType

String

N

안내지점의 구분입니다.

  • S: 출발지
  • E: 도착지
  • B1: 경유지1
  • B2: 경유지2
  • B3: 경유지3
  • N: 일반 안내점

totalDistance

Number

N

3000

경로 총 길이(단위: m)입니다.

  • pointType=S 일때 응답되는 정보입니다.

totalTime

Number

N

600

경로 총 소요 시간(단위: 초)입니다.

  • pointType=S 일때 응답되는 정보입니다.

totalFare

Number

N

1500

경로 총 요금 정보(단위:원)입니다.

  • pointType=S 일때 응답되는 정보입니다.

taxiFare

Number

N

363000

택시 예상 요금 정보(단위:원)입니다.

departureTime

Date

N

2013-05-19T18:31:22+00:00

출발 시간 입니다.

  • 형식 : ISO-8601 표준

arrivalTime

Date

N

2013-05-19T18:31:22+00:00

도착 시간 입니다.

  • 형식 : ISO-8601 표준

type

String

N

Feature

구간의 정보입니다.

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

LineString

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
  • 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)

index

Number

N

1

경로 순번입니다.

lineIndex

String

N

링크의 순번입니다.

name

String

N

구간명칭- 동일로

구간 명칭 또는 안내지점의 명칭입니다.

description

String

N

길 안내 정보입니다.

distance

Number

N

구간 거리(단위: m)입니다.

time

Number

N

구간 통과 시간(단위:초) 입니다.

roadType

Number

N

도로 타입 정보입니다.
<도로 타입 코드(상세 위치 구분)>

  • 0: 고속국도
  • 1: 자동차전용
  • 2: 국도
  • 3: 국가지원 지방도
  • 4: 지방도
  • 5: 주요도로1(일반도로 1중 6,5차로)
  • 6: 주요도로2(일반도로 1 중 4,3 차로)
  • 7: 주요도로3(일반도로 1 중 2차로)
  • 8: 기타도로1(일반도로 1 중 1차로)
  • 9: 기타도로2(이면도로)
  • 10: 페리항로
  • 11: 단지내도로(아파트단지내 도로)
  • 12: 단지 내 도로(시장내 도로)
  • 16: 일반도로
  • 20: 번화가링크

facilityType

Number

N

구간의 시설물 타입 정보입니다.

<구간의 시설물 타입>

  • 0: 일반도로
  • 1: 교량
  • 2: 터널
  • 3: 고가도로
  • 4: 지하도로
  • 5: 교차로통과
  • 6: 철도건널목
  • 7: 댐/방파제
  • 13: 토끼굴
  • 90: 한강교량
  • 타임머신 자동차 길 안내 RESPONSE ( type : json )
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.9823439963945,
          37.56461982743129
        ]
      },
      "properties": {
        "totalDistance": 421057,
        "totalTime": 18720,
        "totalFare": 0,
        "taxiFare": 34210,
        "departureTime": "2013-05-19T18:31:22+00:00",
        "arrivalTime": "2013-05-19T18:31:22+00:00",
        "index": 1,
        "pointIndex": 1,
        "name": "출발지",
        "description": "소공로 을 따라 소공로 방면으로 310m 이동",
        "nextRoadName": "소공로",
        "turnType": 200,
        "pointType": "S"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.9823439963945,
            37.56461982743129
          ],
          [
            126.98230789017299,
            37.564453179812105
          ],
          [
            126.98210513804034,
            37.563703265276516
          ],
          [
            126.98207180945346,
            37.56352550784786
          ],
          [
            126.9817857308457,
            37.56284502921221
          ],
          [
            126.98166907678578,
            37.562633941789535
          ],
          [
            126.98157186492477,
            37.56247284870586
          ],
          [
            126.98128300624569,
            37.56205345097403
          ],
          [
            126.98124689891416,
            37.56200067907546
          ]
        ]
      },
      "properties": {
        "index": 2,
        "lineIndex": 1,
        "name": "소공로",
        "description": "소공로, 310m",
        "distance": 310,
        "roadType": 0,
        "facilityType": 0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.98124689891416,
          37.56200067907546
        ]
      },
      "properties": {
        "index": 3,
        "pointIndex": 2,
        "name": "",
        "description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
        "nextRoadName": "소공로",
        "turnType": 12,
        "pointType": "N"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.98124689891416,
            37.56200067907546
          ],
          [
            126.98156909903298,
            37.561278542345434
          ],
          [
            126.98159131967861,
            37.561234103176794
          ],
          [
            126.98162742833591,
            37.5611507797013
          ],
          [
            126.98175797500768,
            37.560850815192815
          ],
          [
            126.9819857366794,
            37.56038975880062
          ]
        ]
      },
      "properties": {
        "index": 4,
        "lineIndex": 2,
        "name": "소공로",
        "description": "소공로, 190m",
        "distance": 190,
        "roadType": 0,
        "facilityType": 0
      }
    }
  ]
}
  • 타임머신 자동차 길 안내 RESPONSE ( type : javascript )
function (
{
    "type": "FeatureCollection",
    "features": [
        {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.9823439963945,37.56461982743129 ]
                },
                "properties":{
                    "totalDistance": 421057,
                    "totalTime": 18720,
                    "totalFare": 0,
                    "taxiFare": 34210,
                    "departureTime": "2013-05-19T18:31:22+00:00",
                    "arrivalTime": "2013-05-19T18:31:22+00:00",
                    "index": 1,
                    "pointIndex": 1,
                    "name": "출발지",
                    "description": "소공로 을 따라 소공로 방면으로 310m 이동",
                    "nextRoadName": "소공로",
                    "turnType": 200,
                    "pointType": "S"
                }
        },
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                                [126.9823439963945,37.56461982743129 ],[126.98230789017299,37.564453179812105 ],[126.98210513804034,37.563703265276516 ],
                                [126.98207180945346,37.56352550784786 ],[126.9817857308457,37.56284502921221 ],[126.98166907678578,37.562633941789535 ],
                                [126.98157186492477,37.56247284870586 ],[126.98128300624569,37.56205345097403 ],[126.98124689891416,37.56200067907546 ]
                            ]
                },
                "properties":{
                    "index": 2,
                    "lineIndex": 1,
                    "name": "소공로",
                    "description": "소공로, 310m",
                    "distance": 310,
                    "roadType": 0,
                    "facilityType": 0
                }
        },
        {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.98124689891416,37.56200067907546 ]
                },
                "properties":{
                    "index": 3,
                    "pointIndex": 2,
                    "name": "",
                    "description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
                    "nextRoadName": "소공로",
                    "turnType": 12,
                    "pointType": "N"
                }
        },
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                                [126.98124689891416,37.56200067907546 ],[126.98156909903298,37.561278542345434 ],[126.98159131967861,37.561234103176794 ],
                                [126.98162742833591,37.5611507797013 ],[126.98175797500768,37.560850815192815 ],[126.9819857366794,37.56038975880062 ]
                            ]
                },
                "properties":{
                    "index": 4,
                    "lineIndex": 2,
                    "name": "소공로",
                    "description": "소공로, 190m",
                    "distance": 190,
                    "roadType": 0,
                    "facilityType": 0
                }
        }
    ]
} 
)
  • 타임머신 자동차 길 안내 RESPONSE ( type : json - totalValue=2 로 요청시 간소화 예제 )
{
    "type": "FeatureCollection",
    "features":[
        {
            "type": "Feature",
            "properties":{
                "totalDistance": 421057,
                "totalTime": 18720,
                "totalFare": 0,
                "taxiFare": 34210,
                "departureTime": "2013-05-19T10:58:46+0900",
                "arrivalTime": "2013-05-19T18:31:22+00:00"
            }
        }
    ]
}
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

직선 거리 계산

  • REQUEST ( 직선 거리 계산 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/routes/distance?version=1&startX=126.926139&startY=37.557495&endX=126.82613&endY=37.657495&reqCoordType=WGS84GEO&callback=function' \
     --header 'Accept: application/json'
  • RESPONSE ( 직선 거리 계산 )

Name

Date Type

Mandatory

Example

Description

distanceInfo

Node

Y

distance

String

Y

좌표 간 직선거리(단위: m)입니다.

  • 직선 거리 계산 RESPONSE ( type : javascript )
function (
{"distanceInfo": {
  "distance": 363856
 }}
)
  • 직선 거리 계산 RESPONSE ( type : json )
{"distanceInfo": {
  "distance": 363856
}}
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

보행자 경로안내

  • REQUEST ( 보행자 경로안내 )
curl --request POST \
     --url 'https://apis.openapi.sk.com/tmap/routes/pedestrian?version=1' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
     "angle": 0,
     "speed": 0,
     "reqCoordType": "WGS84GEO",
     "searchOption": "0",
     "resCoordType": "WGS84GEO",
     "sort": "index",
     "startX": 126.92365493654832,
     "startY": 37.556770374096615,
     "startName": "%EB%B3%B4%ED%96%89%EC%9E%90-%EA%B2%BD%EB%A1%9C%EC%95%88%EB%82%B4",
     "endName": "%EB%B3%B4%ED%96%89%EC%9E%90-%EA%B2%BD%EB%A1%9C%EC%95%88%EB%82%B4"
}
'
  • RESPONSE ( 보행자 경로안내 )

Name

Date Type

Mandatory

Example

Description

type

String

Y

FeatureCollection

geojson 표준 프로퍼티입니다.

features

Node

N

포인트 및 라인의 형상 정보입니다.
(geojson 표준 규격)

type

String

N

Feature

출발점, 안내점, 경유지, 도착점 정보입니다.

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

Point

형상 정보 데이터의 종류입니다.(geojson 표준 규격)

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
    -형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)

index

String

N

경로 순번입니다.

pointIndex

Node

N

1

안내점 노드의 순번입니다.

name

String

N

서울시시청

안내지점의 명칭입니다.

description

String

N

길 안내 정보입니다.

direction

String

N

방면 명칭입니다.

intersectionName

String

N

교차로 명칭입니다.

nearPoiX

String

N

안내지점 근방 poi X좌표 입니다.

nearPoiY

String

N

안내지점 근방 poi Y좌표 입니다.

nearPoiName

String

N

안내지점 근방 poi 입니다.

turnType

Number

N

회전 정보입니다.

  • 1~7: 안내 없음
  • 11: 직진
  • 12: 좌회전
  • 13: 우회전
  • 14: U-turn
  • 16: 8시 방향 좌회전
  • 17: 10시 방향 좌회전
  • 18: 2시 방향 우회전
  • 19: 4시 방향 우회전
  • 184: 경유지
  • 185: 첫번째 경유지
  • 186: 두번째 경유지
  • 187: 세번째 경유지
  • 188: 네번째 경유지
  • 189: 다섯번째 경유지
  • 125: 육교
  • 126: 지하보도
  • 127: 계단 진입
  • 128: 경사로 진입
  • 129: 계단+경사로 진입
  • 200: 출발지
  • 201: 목적지
  • 211: 횡단보도
  • 212: 좌측 횡단보도
  • 213: 우측 횡단보도
  • 214: 8시 방향 횡단보도
  • 215: 10시 방향 횡단보도
  • 216: 2시 방향 횡단보도
  • 217: 4시 방향 횡단보도
  • 218: 엘리베이터
  • 233: 직진 임시

pointType

String

N

안내지점의 구분입니다.

  • SP: 출발지
  • EP: 도착지
  • PP: 경유지
  • PP1: 경유지1
  • PP2: 경유지2
  • PP3: 경유지3
  • PP4: 경유지4
  • PP5: 경유지5
  • GP: 일반 안내점

facilityType

String

N

구간의 시설물 정보입니다.

<구간의 시설물 타입>

  • 1: 교량
  • 2: 터널
  • 3: 고가도로
  • 11: 일반보행자도로
  • 12: 육교
  • 14: 지하보도
  • 15: 횡단보도
  • 16: 대형시설물이동통로
  • 17: 계단

facilityName

String

N

교량

구간 시설물 타입의 명칭입니다.

totalDistance

Number

N

3000

경로 총 길이(단위:m)입니다.

  • pointType=SP 일때 응답되는 정보입니다

totalTime

Number

N

600

경로 총 소요시간(단위: 초)입니다.

  • pointType=SP 일때 응답되는 정보입니다

type

String

N

Feature 도로 구간의 정보입니다.

geometry

Node

N

형상 정보 입니다.(geojson 표준 규격)

type

String

N

LineString

형상 정보 데이터의 종류입니다.(geojson 표준 규격)

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
  • 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다.(geojson 표준 규격)

index

Number

N

1

경로 순번입니다.

lineIndex

Number

N

1

구간의 순번입니다.

name

String

N

동일로

도로 명칭 입니다.

description

String

N

길 안내 정보입니다.

time

Number

N

구간의 소요 시간(단위 : 초)입니다.

distance

Number

N

구간 거리(단위 : m)입니다.

roadType

Number

N

도로 타입 정보입니다.

<도로 타입 코드(상세 위치 구분)>

  • 21: 보행자도로 1 (차도와 인도가 분리되어 있으며 정해진 횡단구역으로만 횡단 가능한 보행자 도로 )
  • 22: 보행자도로 2 (차도와 인도가 분리되어 있지 않거나, 보행자 횡단에 제약이 없는 보행자도로 )
  • 23: 보행자도로 3 (차량 통행이 불가능한 보행자도로 )
  • 24: 보행자도로 4 (쾌적하지 않은 도로 )

categoryRoadType

Number

N

특화거리 정보입니다.

<특화거리 코드>

  • 0: 미분류
  • 1: 특화거리
  • 2: 테마거리
  • 3: 청소년출입금지
  • 보행자 경로 안내 RESPONSE ( type : json )
{
    "type": "FeatureCollection",
    "features": [
             
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92364104902308,37.556759264185274 ]
                },
                "properties":{
                    "index": 1,
                    "pointIndex": 1,
                    "name": "",
                    "guidePointName": "",
                    "description": "양화로 을 따라 양화로 방면으로 6m 이동",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 200,
                    "pointType": "SP"
                }
            },
            {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                            [126.92364104902308,37.556759264185274 ],[126.92359383142113,37.55672315696065 ]
                            ]
                },
                "properties":{
                    "index": 2,
                    "lineIndex": 1,
                    "name": "양화로",
                    "roadName": "양화로",
                    "description": "양화로, 6m",
                    "distance": 6,
                    "time": 5,
                    "roadType": 23,
                    "categoryRoadType": 0,
                    "facilityType": 17,
                    "facilityName": "일반보행자도로"
                }
            },
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92359383142113,37.55672315696065 ]
                },
                "properties":{
                    "index": 3,
                    "pointIndex": 2,
                    "name": "",
                    "guidePointName": "",
                    "description": "양화로 방면으로 좌측 횡단보도 후 양화로 을 따라 19m 이동 ",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 212,
                    "pointType": "GP"
                }
            },
            {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                            [126.92359383142113,37.55672315696065 ],[126.92372993148247,37.55659261733597 ]
                            ]
                },
                "properties":{
                    "index": 4,
                    "lineIndex": 2,
                    "name": "양화로",
                    "roadName": "양화로",
                    "description": "양화로, 19m",
                    "distance": 19,
                    "time": 73,
                    "roadType": 23,
                    "categoryRoadType": 0,
                    "facilityType": 17,
                    "facilityName": "일반보행자도로"
                }
            },
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92372993148247,37.55659261733597 ]
                },
                "properties":{
                    "index": 5,
                    "pointIndex": 3,
                    "name": "대한생명 홍익BRANCH",
                    "guidePointName": "대한생명 홍익BRANCH",
                    "description": "대한생명 홍익BRANCH 에서 대한생명 홍익BRANCH 방면으로 우회전 후 양화로 을 따라 94m 이동 ",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 13,
                    "pointType": "GP"
                }
            }
    ]
}
  • 보행자 경로 안내 RESPONSE ( type : javascript )
function (
{
    "type": "FeatureCollection",
    "features": [
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92365493681676,37.55674259953098]
                },
                "properties":{
                    "index": 0,
                    "pointIndex": 0,
                    "name": "test",
                    "description": "양화로 방면으로 3m 이동",
                    "pointType": "SP"
                }
            },
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92364104902308,37.556759264185274 ]
                },
                "properties":{
                    "index": 1,
                    "pointIndex": 1,
                    "name": "",
                    "guidePointName": "",
                    "description": "양화로 을 따라 양화로 방면으로 6m 이동",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 200,
                    "pointType": "GP"
                }
            },
            {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                            [126.92364104902308,37.556759264185274 ],[126.92359383142113,37.55672315696065 ]
                            ]
                },
                "properties":{
                    "index": 2,
                    "lineIndex": 1,
                    "name": "양화로",
                    "roadName": "양화로",
                    "description": "양화로, 6m",
                    "distance": 6,
                    "time": 5,
                    "roadType": 23,
                    "categoryRoadType": 0,
                    "facilityType": 17,
                    "facilityName": "일반보행자도로"
                }
            },
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92359383142113,37.55672315696065 ]
                },
                "properties":{
                    "index": 3,
                    "pointIndex": 2,
                    "name": "",
                    "guidePointName": "",
                    "description": "양화로 방면으로 좌측 횡단보도 후 양화로 을 따라 19m 이동 ",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 212,
                    "pointType": "GP"
                }
            },
            {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [
                            [126.92359383142113,37.55672315696065 ],[126.92372993148247,37.55659261733597 ]
                            ]
                },
                "properties":{
                    "index": 4,
                    "lineIndex": 2,
                    "name": "양화로",
                    "roadName": "양화로",
                    "description": "양화로, 19m",
                    "distance": 19,
                    "time": 73,
                    "roadType": 23,
                    "categoryRoadType": 0,
                    "facilityType": 17,
                    "facilityName": "일반보행자도로"
                }
            },
            {"type": "Feature",
                "geometry": {
                        "type": "Point",
                        "coordinates": [126.92372993148247,37.55659261733597 ]
                },
                "properties":{
                    "index": 5,
                    "pointIndex": 3,
                    "name": "대한생명 홍익BRANCH",
                    "guidePointName": "대한생명 홍익BRANCH",
                    "description": "대한생명 홍익BRANCH 에서 대한생명 홍익BRANCH 방면으로 우회전 후 양화로 을 따라 94m 이동 ",
                    "direction": "",
                    "intersectionName": "",
                    "nearPoiName": "",
                    "nearPoiX": "0.0",
                    "nearPoiY": "0.0",
                    "crossName": "",
                    "turnType": 13,
                    "pointType": "GP"
                }
            }
    ]
} 
)
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

자동차 경로안내

  • REQUEST ( 자동차 경로안내 )
curl --request POST \
     --url 'https://apis.openapi.sk.com/tmap/tmap/routes?version=1' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
     "endRpFlag": "G",
     "reqCoordType": "WGS84GEO",
     "carType": 0,
     "detailPosFlag": "2",
     "resCoordType": "WGS84GEO",
     "sort": "index",
     "endX": 14368651.605895586,
     "endY": 4188210.3283031476,
     "startX": 14135591.321771959,
     "startY": 4518111.822510956
}
'
  • RESPONSE ( 자동차 경로안내 )

Name

Date Type

Mandatory

Example

Description

type

String

Y

FeatureCollection

geojson 표준 프로퍼티입니다.

features

Node

N

포인트 및 라인의 형상 정보입니다.
(geojson 표준 규격)

type

String

N

Feature

출발점, 안내점, 경유지, 도착점 정보입니다.

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

Point

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
    -형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)

index

String

N

경로 순번입니다.

lineIndex

String

N

링크의 순번입니다.

pointIndex

Node

N

아이콘 노드입니다.

name

String

N

지점명칭 ? 서울시시청

안내지점의 명칭입니다.

description

String

N

길 안내 정보입니다.

nextRoadName

String

N

다음 구간의 도로 명칭입니다.

turnType

Number

N

회전 정보입니다.

  • 0: 휴게소
  • 1: 도곽에 의한 점
  • 2: 타일에 의한 점
  • 3: 고속도로에 의한 안내없음
  • 4: 일반도로에 의한 안내없음
  • 5: 특수한 경우 안내없음
  • 6: Y자 오른쪽 안내없음
  • 7: Y자 왼쪽 안내없음
  • 11: 직진
  • 12: 좌회전
  • 13: 우회전
  • 14: U턴
  • 15: P턴
  • 16: 8시 방향 좌회전
  • 17: 10시 방향 좌회전
  • 18: 2시 방향 우회전
  • 19: 4시 방향 우회전
  • 43: 오른쪽
  • 44: 왼쪽
  • 51: 직진 방향
  • 52: 왼쪽 차선
  • 53: 오른쪽 차선
  • 54: 1차선
  • 55: 2차선
  • 56: 3차선
  • 57: 4차선
  • 58: 5차선
  • 59: 6차선
  • 60: 7차선
  • 61: 8차선
  • 62: 9차선
  • 63: 10차선
  • 71: 첫번째 출구
  • 72: 두번째 출구
  • 73: 첫번째 오른쪽 길
  • 74: 두번째 오른쪽 길
  • 75: 첫번째 왼쪽 길
  • 76: 두번째 왼쪽 길
  • 101: 오른쪽 고속도로 입구
  • 102: 왼쪽 고속도로 입구
  • 103: 전방 고속도로 입구
  • 104: 오른쪽 고속도로 출구
  • 105: 왼쪽 고속도로 출구
  • 106: 전방 고속도로 출구
  • 111: 오른쪽 도시고속도로 입구
  • 112: 왼쪽 도시고속도로 입구
  • 113: 전방 도시고속도로 입구
  • 114: 오른쪽 도시고속도로 출구
  • 115: 왼쪽 도시고속도로 출구
  • 116: 전방 도시고속도로 출구
  • 117: 오른쪽 방향
  • 118: 왼쪽 방향
  • 119: 지하차도
  • 120: 고가도로
  • 121: 터널
  • 122: 교량
  • 123: 지하차도옆
  • 124: 고가도로옆
  • 130: 토끼굴 진입
  • 131: 1시 방향
  • 132: 2시 방향
  • 133: 3시 방향
  • 134: 4시 방향
  • 135: 5시 방향
  • 136: 6시 방향
  • 137: 7시 방향
  • 138: 8시 방향
  • 139: 9시 방향
  • 140: 10시 방향
  • 141: 11시 방향
  • 142: 12시 방향
  • 150: 졸음쉼터
  • 151: 휴게소
  • 182: 왼쪽방향 도착안내
  • 183: 오른쪽방향 도착안내
  • 184: 경유지
  • 185: 첫번째경유지
  • 186: 두번째경유지
  • 187: 세번째경유지
  • 188: 네번째경유지
  • 189: 다섯번째경유지
  • 191: 제한속도
  • 192: 사고다발
  • 193: 급커브
  • 194: 낙석주의
  • 200: 출발지
  • 201: 도착지
  • 203: 목적지건너편
  • 211: 횡단보도
  • 212: 좌측 횡단보도
  • 213: 우측 횡단보도
  • 214: 8시 방향 횡단보도
  • 215: 10시 방향 횡단보도
  • 216: 2시 방향 횡단보도
  • 217: 4시 방향 횡단보도
  • 218: 엘리베이터
  • 233: 직진 임시

pointType

String

N

안내지점의 구분입니다.

  • S: 출발지
  • E: 도착지
  • B1: 경유지1
  • B2: 경유지2
  • B3: 경유지3
  • N: 일반 안내점

totalDistance

Number

N

3000

경로 총 길이(단위: m)입니다.

  • pointType=S 일때 응답되는 정보입니다.

totalTime

Number

N

600

경로 총 소요 시간(단위: 초)입니다.

  • pointType=S 일때 응답되는 정보입니다.

totalFare

Number

N

1500

경로 총 요금 정보(단위:원)입니다.

  • pointType=S 일때 응답되는 정보입니다.

taxiFare

Number

N

363000

택시 예상 요금 정보(단위:원)입니다.

type

String

N

Feature

구간의 정보입니다.

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

LineString

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
  • 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

traffic

String

N

교통 정보입니다.
[시작index, 마지막index,
혼잡도, 속도]

< 혼잡도 >

  • 0: 정보없음
  • 1: 원할
  • 2: 서행
  • 3: 지체
  • 4: 정체

properties

Node

N

사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)

index

Number

N

경로 순번입니다.

name

String

N

1

구간 명칭 또는 안내지점의 명칭입니다.

description

String

N

구간명칭- 동일로

길 안내 정보입니다.

distance

Number

N

구간 거리(단위: m)입니다.

time

Number

N

구간 통과 시간(단위:초) 입니다.

roadType

Number

N

도로 타입 정보입니다.
<도로 타입 코드(상세 위치 구분)>

  • 0: 고속도로
  • 1: 자동차전용
  • 2: 국도
  • 3: 국가지원 지방도
  • 4: 지방도
  • 5: 주요도로1(일반도로 1중 6,5차로)
  • 6: 주요도로2(일반도로 1 중 4,3 차로)
  • 7: 주요도로3(일반도로 1 중 2차로)
  • 8: 기타도로1(일반도로 1 중 1차로)
  • 9: 기타도로2(이면도로)
  • 10: 페리항로
  • 11: 단지내도로(아파트단지내 도로)
  • 12: 단지 내 도로(시장내 도로)
  • 16: 일반도로
  • 20: 번화가링크

facilityType

Number

N

구간의 시설물 타입 정보입니다.

<구간의 시설물 타입>

  • 0: 일반도로
  • 1: 교량
  • 2: 터널
  • 3: 고가도로
  • 4: 지하도로
  • 5: 교차로통과
  • 6: 철도건널목
  • 7: 댐/방파제
  • 13: 토끼굴
  • 90: 한강교량
  • 자동차 경로안내 RESPONSE ( type : json )
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.9823439963945,
          37.56461982743129
        ]
      },
      "properties": {
        "totalDistance": 421057,
        "totalTime": 18720,
        "totalFare": 0,
        "taxiFare": 31420,
        "index": 1,
        "pointIndex": 1,
        "name": "출발지",
        "description": "소공로 을 따라 소공로 방면으로 310m 이동",
        "nextRoadName": "소공로",
        "turnType": 200,
        "pointType": "S"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.9823439963945,
            37.56461982743129
          ],
          [
            126.98230789017299,
            37.564453179812105
          ],
          [
            126.98210513804034,
            37.563703265276516
          ],
          [
            126.98207180945346,
            37.56352550784786
          ],
          [
            126.9817857308457,
            37.56284502921221
          ],
          [
            126.98166907678578,
            37.562633941789535
          ],
          [
            126.98157186492477,
            37.56247284870586
          ],
          [
            126.98128300624569,
            37.56205345097403
          ],
          [
            126.98124689891416,
            37.56200067907546
          ]
        ],
        "traffic": [0, 8, 4, 12]
      },
      "properties": {
        "index": 2,
        "lineIndex": 1,
        "name": "소공로",
        "description": "소공로, 310m",
        "distance": 310,
        "roadType": 0,
        "facilityType": 0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.98124689891416,
          37.56200067907546
        ]
      },
      "properties": {
        "index": 3,
        "pointIndex": 2,
        "name": "",
        "description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
        "nextRoadName": "소공로",
        "turnType": 12,
        "pointType": "N"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.98124689891416,
            37.56200067907546
          ],
          [
            126.98156909903298,
            37.561278542345434
          ],
          [
            126.98159131967861,
            37.561234103176794
          ],
          [
            126.98162742833591,
            37.5611507797013
          ],
          [
            126.98175797500768,
            37.560850815192815
          ],
          [
            126.9819857366794,
            37.56038975880062
          ]
        ],
        "traffic": [0, 5, 2, 17]
      },
      "properties": {
        "index": 4,
        "lineIndex": 2,
        "name": "소공로",
        "description": "소공로, 190m",
        "distance": 190,
        "roadType": 0,
        "facilityType": 0
      }
    }
  ]
}
  • 자동차 경로안내 RESPONSE ( type : javascript )
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.9823439963945,
          37.56461982743129
        ]
      },
      "properties": {
        "totalDistance": 421057,
        "totalTime": 18720,
        "totalFare": 0,
        "taxiFare": 34300,
        "index": 1,
        "pointIndex": 1,
        "name": "출발지",
        "description": "소공로 을 따라 소공로 방면으로 310m 이동",
        "nextRoadName": "소공로",
        "turnType": 200,
        "pointType": "S"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.9823439963945,
            37.56461982743129
          ],
          [
            126.98230789017299,
            37.564453179812105
          ],
          [
            126.98210513804034,
            37.563703265276516
          ],
          [
            126.98207180945346,
            37.56352550784786
          ],
          [
            126.9817857308457,
            37.56284502921221
          ],
          [
            126.98166907678578,
            37.562633941789535
          ],
          [
            126.98157186492477,
            37.56247284870586
          ],
          [
            126.98128300624569,
            37.56205345097403
          ],
          [
            126.98124689891416,
            37.56200067907546
          ]
        ],
        "traffic": [0, 8, 4, 12]
      },
      "properties": {
        "index": 2,
        "lineIndex": 1,
        "name": "소공로",
        "description": "소공로, 310m",
        "distance": 310,
        "roadType": 0,
        "facilityType": 0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          126.98124689891416,
          37.56200067907546
        ]
      },
      "properties": {
        "index": 3,
        "pointIndex": 2,
        "name": "",
        "description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
        "nextRoadName": "소공로",
        "turnType": 12,
        "pointType": "N"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            126.98124689891416,
            37.56200067907546
          ],
          [
            126.98156909903298,
            37.561278542345434
          ],
          [
            126.98159131967861,
            37.561234103176794
          ],
          [
            126.98162742833591,
            37.5611507797013
          ],
          [
            126.98175797500768,
            37.560850815192815
          ],
          [
            126.9819857366794,
            37.56038975880062
          ]
        ],
        "traffic": [0, 5, 2, 17]
      },
      "properties": {
        "index": 4,
        "lineIndex": 2,
        "name": "소공로",
        "description": "소공로, 190m",
        "distance": 190,
        "roadType": 0,
        "facilityType": 0
      }
    }
  ]
}
  • 자동차 경로안내 RESPONSE ( type : json - totalValue="2"로 요청시 간소화)
{
    "type": "FeatureCollection",
    "features":[
        {
            "type": "Feature",
            "properties":{
                "totalDistance": 421057,
                "totalTime": 18720,
                "totalFare": 0,
                "taxiFare": 34300
            }
        }
    ]
}
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.