Reference

This section provides an overview of the common codes used in the Driving direction API.

result_code: Route search result code

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

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

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

Code	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

RPFlag

RPFlag (Route Planning Flag) is a precise point guiding you to the specified destination. These points can be set by combining RPFlag attribute values according to different road conditions and user needs based on waypoint/destination coordinates.

Attributes that make up the point include RPF_RIGHT, RPF_EXPWAY, RPF_MP, and RPF_FACILITY.

Unit attributes

Attribute name	Attribute value	Description
RPF_RIGHT	1	Sets the arrival link so that the destination is located on the right side of the road
	0	Not set
RPF_EXPWAY	1	Set expressways and motorways as points.
	0	Not set. Normal roads other than expressways and motorways are set as points.
RPF_MP	1	Pin multiple roads near the destination as points. For example, on a road where multiple roads meet, such as at an intersection, the user can set up points at different locations around the destination. The trip is complete once the user reaches one of the points.
	0	Not set. Set a single point. The trip will be completed once the user reaches this point.
RPF_FACILITY	1	Set roads with facilities such as elevated roads, underpasses, piers (bridge supports), and tunnels as points.
	0	Not set. Set roads excluding facilities as points.

RPFlag code

A code value can be assigned by combining the four-unit attribute values above.

For example, the code "8" in the table below indicates the following:

1. the destination is on the right side of the road,
2. it directs you to normal roads instead of expressways,
3. it excludes facilities,
4. the trip is complete only when the user reaches the single precise destination link point.

Set the point using the values in the table below.

[Default code value]

'*': Default value. It is used when the rpflag code value is not set and the unit attribute value is set to -1.

Code table

New code value	RPF_RIGHT	RPF_EXPWAY	RPF_MP	RPF_FACILITY	Old code value
'G'	0	0	0	0	0, G
'O'	0	0	0	1
'H'	0	0	1	0	1, 4, 5, H, K, L
'P'	0	0	1	1
'I'	0	1	0	0	2, I
'Q'	0	1	0	1
'J'	0	1	1	0	3, 6, 7, J, M, N
'R'	0	1	1	1
'8'	1	0	0	0	8
'S'	1	0	0	1
'D'	1	0	1	0	9, C, D
'T'	1	0	1	1
'A'	1	1	0	0	A
'U'	1	1	0	1
'F'	1	1	1	0	B, E, F
'W'	1	1	1	1