driving

개요

길찾기 API는 지도 앱 메인 화면에서 주요 지역까지의 소요 시간과 거리, 예상 유류비, 통행 요금 정보를 제공합니다.
그리고 경로상 분기점에서 안내가 필요한 경우 해당 지점에서의 guide code를 제공합니다.

요청

curl "https://naveropenapi.apigw.gov-ntruss.com/map-direction/v1/driving?start={출발지}&goal={목적지}&option={탐색옵션}" \
	-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
	-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

요청 파라미터

길찾기 API의 쿼리 스트링 파라미터에 공통으로 해당되는 내용입니다.

• 별도의 정보가 없으면 거리의 단위는 meter, 시간의 단위는 milisecond(1/1000초)를 사용합니다.
• 문자열 인코딩은 UTF-8을 사용합니다.

Request Position Format

• 필수 항목(경도, 위도)과 옵션 항목(이름, 지점 ID)을 , 문자로 연결한 문자열입니다.
• 옵션 항목은 항목에 맞는 prefix가 필요합니다.
• 옵션 항목값은 ,, : 또는 | 문자를 포함할 수 없습니다.
• 숫자가 아닌 문자는 URL 인코딩이 필요합니다.
• 옵션 항목 간의 순서는 상관 없습니다.

다음은 request position format의 사용 예입니다.

• 기본 예: 127.12345,37.12345
• 이름 옵션 항목을 추가한 예: 127.12345,37.12345,name=출발지이름

Multiple Request Position Format

request position format 여러 개를 : 문자로 연결한 문자열입니다.

• waypoints의 각 항목은 독립적인 경유지이므로 name을 사용한 여러 개의 request position format을 사용할 수 있습니다.
  • waypoints 예 1: 127.12345,37.12345:128.12345,38.12345
  • waypoints 예 2: 127.12345,37.12345:128.12345,38.12345,name=장소이름1
  • waypoints 예 3: 127.12345,37.12345,name=장소이름1:128.12345,38.12345,name=장소이름2

Multiple Request Position Format list

multiple request position format 여러 개를 | 문자로 연결한 리스트 문자열입니다. 경유지 파라미터인 waypoints가 이 형식을 사용합니다.

• 경유지가 두 개이고 각 경유지에 좌표가 두 개씩 있는 경우의 예: 127.12345,37.12345:127.23456,37.23456|128.12345,38.12345:128.23456,38.23456

Cartype Code

톨게이트 요금 계산용 차종 정보를 나타내는 코드입니다.

Fueltype Code

유류비 계산용 유종을 나타내는 코드입니다.

Option Code

탐색 옵션을 나타내는 코드입니다.(모든 경로는 교통정보를 반영하므로 출발지, 목적지, 옵션이 같더라도 같은 경로가 보장되지 않습니다.)

Language Code

지원되는 언어 종류를 나타내는 코드입니다.

요청 헤더

요청 바디

• 해당 API 는 요청 바디를 필요로 하지 않습니다.

응답

응답 바디

하위 구조체는 Object로 표현하며, route 내 각 항목의 속성은 일반적인 key-value 쌍("key": "value")으로 표현합니다.

Route Unit Ent

경로 안내를 위한 속성들의 대분류를 나타냅니다.

Summary

탐색된 경로의 요약 정보를 나타냅니다.

Section Unit

탐색된 경로 중 주요 도로의 정보를 나타냅니다. 도로명을 기준으로 주행 길이가 긴 경로의 정보입니다.

Guide Unit for Ent

회전 안내가 필요한 지점과 회전 안내까지의 거리 정보를 제공합니다.

Result Code

ResultCode가 0이 아니면 탐색 실패입니다.

lng-lat Position Format

경도, 위도로 된 좌표 정보를 나타냅니다. Length 2인 1차원 배열로, 경도, 위도 순서로 제공합니다(lng, lat).

예: [127.001122, 37.001122]

Response Position Format

출발지, 도착지, 경유지의 좌표 정보를 제공합니다.

View Direction Code

경로상의 도착지/경유지에서 실제 도착지/경유지로 지정한 지점의 방향을 나타냅니다. 경로상 진행 방향 중심으로 방향을 지정합니다.

Guide Code

경로상 회전이 발생하거나 추가 안내가 필요한 지점에서 어떻게 진행할지 안내합니다.

Congestion code

도로의 종별 및 실제 통행 속도 정보를 이용해 추정한 혼잡도 분류 코드입니다.

다음은 혼잡도를 기준으로 도로 종별 통행 속도를 나타낸 표입니다.

예시

요청 예시

curl "https://naveropenapi.apigw.gov-ntruss.com/map-direction/v1/driving?start=127.1058342,37.359708&goal=129.075986,35.179470&option=trafast" \
	-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
	-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

응답 예시

{
    "code": 0,
    "message": "길찾기를 성공하였습니다.",
    "currentDateTime": "2018-12-21T14:45:34",
    "route": {
        "trafast": [
            {
                "summary": {
                    "start": {
                        "location": [
                            127.1058342,
                            37.3597078
                        ]
                    },
                    "goal": {
                        "location": [
                            129.0759853,
                            35.1794697
                        ],
                        "dir": 2
                    },
                    "distance": 382403,
                    "duration": 15372873,
                    "bbox": [
                        [
                            127.0833901,
                            35.1793188
                        ],
                        [
                            129.0817364,
                            37.3599059
                        ]
                    ],
                    "tollFare": 24500,
                    "taxiFare": 319900,
                    "fuelPrice": 46027
                },
                "path": [
                    [
                        127.1059968,
                        37.3597093
                    ],

                    ....

                    [
                        129.0764276,
                        35.1795108
                    ],
                    [
                        129.0762855,
                        35.1793188
                    ]
                ],
                "section": [
                    {
                        "pointIndex": 654,
                        "pointCount": 358,
                        "distance": 22495,
                        "name": "죽양대로",
                        "congestion": 1,
                        "speed": 60
                    },
                    {
                        "pointIndex": 3059,
                        "pointCount": 565,
                        "distance": 59030,
                        "name": "낙동대로",
                        "congestion": 1,
                        "speed": 89
                    },
                    {
                        "pointIndex": 4708,
                        "pointCount": 433,
                        "distance": 23385,
                        "name": "새마을로",
                        "congestion": 1,
                        "speed": 66
                    }
                ],
                "guide": [
                    {
                        "pointIndex": 1,
                        "type": 3,
                        "instructions": "정자일로1사거리에서 '성남대로' 방면으로 우회전",
                        "distance": 21,
                        "duration": 4725
                    },
                    {
                        "pointIndex": 8,
                        "type": 3,
                        "instructions": "불정교사거리에서 '수원·용인, 미금역' 방면으로 우회전",
                        "distance": 186,
                        "duration": 42914
                    },

 					....

                    {
                        "pointIndex": 6824,
                        "type": 14,
                        "instructions": "연산교차로에서 '서면교차로, 시청·경찰청' 방면으로 오른쪽 1시 방향",
                        "distance": 910,
                        "duration": 125240
                    },
                    {
                        "pointIndex": 6842,
                        "type": 88,
                        "instructions": "목적지",
                        "distance": 895,
                        "duration": 111333
                    }
                ]
            }
        ]
    }
}