result_code: Route search result code
Table 1 Route search result codes
| Code | Description |
|---|---|
| 0 | Successfully retrieved directions |
| 1 | Cannot retrieve any directions |
| 101 | Cannot find any road near the waypoint |
| 102 | Cannot find any road near the origin |
| 103 | Cannot find any road near the destination |
| 104 | Cannot search for a route because the origin and destination are set within 5 m of each other |
| 105 | A traffic incident exists on the road near the origin |
| 106 | A traffic incident exists on the road near the destination |
| 107 | A traffic incident exists on the road near a waypoint. The waypoint number is indicated in result_message, starting from 1. Example: • result_code: 107 • result_message: 경유지에 유고 정보 존재: 1번 경유지 (“A traffic incident exists at waypoint 1” — the API returns this message in Korean) |
| 201 | Multi-origin: The origin is not within the search area |
| 202 | Multi-origin: Failed to select roads because the maximum number of origins was exceeded |
| 203 | Multi-origin: Failed to select a road for the destination |
| 204 | Multi-origin: Route search processing time limit exceeded |
| 205 | Multi-origin: Unable to pass due to a traffic incident near the origin |
| 206 | Multi-origin: Unable to pass due to a traffic incident near the destination |
| 207 | Multi-origin: The origin is outside the configured directions search radius |
| 301 | Multi-destination: Failed to select a road for the origin |
| 302 | Multi-destination: Failed to select a road for the destination |
| 303 | Multi-destination: Route search failed because the maximum number of destinations was exceeded |
| 304 | Multi-destination: The destination is outside the configured directions search radius |
traffic_state: Current traffic state code
Table 2 Current traffic state codes
| Code | Description |
|---|---|
| 0 | No traffic state information |
| 1 | Heavy traffic |
| 2 | Delayed traffic |
| 3 | Slow traffic |
| 4 | Smooth traffic |
| 6 | Traffic accident (impassable) |
car_type: Car type
Table 3 Car types
| Value | Car Type | Classification Criteria | Examples |
|---|---|---|---|
| 1 | Small | Vehicle with 2 axles, wheel width of 279.4 mm or less | Passenger car, van for 16 passengers or fewer, truck under 2.5 tons |
| 2 | Medium | Vehicle with 2 axles, wheel width over 279.4 mm, tread of 1,800 mm or less | Van for 17–32 passengers, 2.5–5.5 ton truck |
| 3 | Large | Vehicle with 2 axles, wheel width over 279.4 mm, tread over 1,800 mm | Van for 33 passengers or more, 5.5–10 ton truck |
| 4 | Large truck | Vehicle with 3 axles | 10–20 ton truck |
| 5 | Special truck | Vehicle with 4 or more axles | Truck of 20 tons or more |
| 6 | Compact car | Vehicle with engine displacement under 1,000 cc and dimensions of 3.6 m (length), 1.6 m (width), 2.0 m (height) or less | - |
| 7 | Motorcycle | - | - |
type: Guidance type
Table 4 Guidance types
| Value | Description |
|---|---|
| 0 | Go straight |
| 1 | Turn left |
| 2 | Turn right |
| 3 | Make a U-turn |
| 5 | To the left |
| 6 | To the right |
| 7 | Highway exit |
| 8 | Expressway exit on your left |
| 9 | Expressway exit on your right |
| 10 | Highway entrance |
| 11 | Expressway entrance on your left |
| 12 | Expressway entrance on your right |
| 14 | Approaching an overpass |
| 15 | Approaching an underpass |
| 16 | Side road of an overpass |
| 17 | Side road of an underpass |
| 18 | To the right at your 1 o'clock |
| 19 | To the right at your 2 o'clock |
| 20 | To the right at your 3 o'clock |
| 21 | To the right at your 4 o'clock |
| 22 | To the right at your 5 o'clock |
| 23 | To your 6 o'clock |
| 24 | To the left at your 7 o'clock |
| 25 | To the left at your 8 o'clock |
| 26 | To the left at your 9 o'clock |
| 27 | To the left at your 10 o'clock |
| 28 | To the left at your 11 o'clock |
| 29 | To your 12 o'clock |
| 30 | To the right at your 1 o'clock at the rotary |
| 31 | To the right at your 2 o'clock at the rotary |
| 32 | To the right at your 3 o'clock at the rotary |
| 33 | To the right at your 4 o'clock at the rotary |
| 34 | To the right at your 5 o'clock at the rotary |
| 35 | To your 6 o'clock at the rotary |
| 36 | To the left at your 7 o'clock at the rotary |
| 37 | To the left at your 8 o'clock at the rotary |
| 38 | To the left at your 9 o'clock at the rotary |
| 39 | To the left at your 10 o'clock at the rotary |
| 40 | To the left at your 11 o'clock at the rotary |
| 41 | To your 12 o'clock at the rotary |
| 42 | Urban expressway exit |
| 43 | Urban expressway exit on your left |
| 44 | Urban expressway exit on your right |
| 45 | Urban expressway entrance |
| 46 | Urban expressway entrance on your left |
| 47 | Urban expressway entrance on your right |
| 48 | Entering the expressway on your left |
| 49 | Entering the expressway on your right |
| 61 | Entering a ferry route |
| 62 | Exiting a ferry route |
| 70 | To the right at your 1 o'clock at the roundabout |
| 71 | To the right at your 2 o'clock at the roundabout |
| 72 | To the right at your 3 o'clock at the roundabout |
| 73 | To the right at your 4 o'clock at the roundabout |
| 74 | To the right at your 5 o'clock at the roundabout |
| 75 | To your 6 o'clock at the roundabout |
| 76 | To the left at your 7 o'clock at the roundabout |
| 77 | To the left at your 8 o'clock at the roundabout |
| 78 | To the left at your 9 o'clock at the roundabout |
| 79 | To the left at your 10 o'clock at the roundabout |
| 80 | To the left at your 11 o'clock at the roundabout |
| 81 | To your 12 o'clock at the roundabout |
| 82 | Go straight on the left |
| 83 | Go straight on the right |
| 84 | Approaching a tollgate |
| 85 | Approaching a one-tolling zone (* One-tolling lets drivers pay the toll for the entire journey at the final tollgate, instead of paying at multiple tollgates along the way.) |
| 86 | Entering a merging section after a divergence |
| 100 | Origin |
| 101 | Destination |
| 1000 | Waypoint |
| 300 | Tollgate |
| 301 | Service area |