이 제품은 기존 상태입니다. 2026년 10월부터는 새 Google Cloud 프로젝트에서 Directions API (기존)를 더 이상 사용 설정할 수 없습니다. 기존 프로젝트는 계속해서 완전히 지원됩니다. 새로운 기능과 향상된 성능을 이용하려면 Routes API로 이전하세요.
요청 예
다음 요청은 온타리오주 토론토에서 퀘벡주 몬트리올까지의 운전 경로를 반환합니다.
URL
https://maps.googleapis.com/maps/api/directions/json?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'
mode 및 avoid 매개변수를 변경하면 주요 고속도로를 피하는 경치 좋은 자전거 경로를 반환하도록 초기 요청을 수정할 수 있습니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?avoid=highways &destination=Montreal &mode=bicycling &origin=Toronto &key=YOUR_API_KEYYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'
다음 요청은 뉴욕 브루클린에서 뉴욕 퀸즈까지의 대중교통 경로를 검색합니다. 요청에서 departure_time를 지정하지 않으므로 출발 시간은 기본적으로 현재 시간으로 설정됩니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'
다음 대중교통 요청에는 특정 출발 시간이 포함됩니다.
참고: 이 예시에서 출발 시간은 2012년 7월 30일 오전 9시 45분으로 지정되어 있습니다. 오류를 방지하려면 요청을 제출하기 전에 매개변수를 미래의 시간으로 변경해야 합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=1343641500 &destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'
다음 요청은 Plus Code를 사용하여 인도 콜카타의 H8MW+WP에서 GCG2+3M까지의 운전 경로를 반환합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=GCG2%2B3M%20Kolkata%20India &origin=H8MW%2BWP%20Kolkata%20India &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'
다음 요청은 장소 ID를 사용하여 영국 글래스고에서 영국 퍼스까지의 운전 경로를 반환합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE &keyYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'
이동 수단
경로를 계산할 때 사용할 이동수단(mode)을 지정할 수 있습니다. 기본적으로
경로는 driving 경로로 계산됩니다. 다음과 같은 이동 수단이 지원됩니다.
driving(기본값)은 도로망을 사용하는 일반 운전 경로를 나타냅니다.walking은 보행자 전용 도로와 인도를 경유하는 도보 경로를 요청합니다 (해당하는 경우).bicycling은 자전거 전용 도로 및 선호하는 거리를 경유하는 자전거 경로를 요청합니다 (해당하는 경우).transit은 대중교통 경로를 경유하는 경로를 요청합니다(해당하는 경우). 모드를transit로 설정하면 선택적으로departure_time또는arrival_time를 지정할 수 있습니다. 시간을 지정하지 않으면departure_time의 기본값은 '지금'입니다 (즉, 출발 시간의 기본값은 현재 시간). 선택적으로transit_mode또는transit_routing_preference를 포함할 수도 있습니다.
참고: 도보 및 자전거 경로에 명확한 보행자 전용 도로 또는 자전거 도로가 포함되지 않을 수도 있으므로 이러한 경로에서는 반환된 결과에 warnings를 반환하며, 이를 사용자에게 표시해야 합니다.
교통 정보
교통정보는 다음 사항이 모두 적용되는 경우에 사용됩니다 (경로 응답에서
duration_in_traffic 필드를 수신하는 데 필요한 조건).
- 이동
mode매개변수가driving이거나 지정되지 않았습니다(driving이 기본 이동 모드). - 요청에 유효한
departure_time매개변수가 포함되어 있습니다.departure_time은 현재 시간 또는 미래의 특정 시간으로 설정할 수 있습니다. 과거 시간으로 설정할 수는 없습니다. - 요청에 중간 기착 경유지가 포함되지 않습니다. 요청에 경유지가 포함된 경우 각 경유지 앞에
via:를 붙이면 경로에 영향을 주지만 중간 기착을 피할 수 있습니다. 예를 들면 다음과 같습니다.&waypoints=via:San Francisco|via:Mountain View|...
원하는 경우 요청에
traffic_model 매개변수를 포함하여 이동 시간을 계산할 때 사용할 가정을 지정할 수 있습니다.
다음 URL은 찰스타운과 렉싱턴을 경유하여 매사추세츠주 보스턴에서 매사추세츠주 콩코드로 가는 경로에 대한 Directions 요청을 시작합니다. 요청에 출발 시간이 포함되어 있으며, Directions 응답에서 duration_in_traffic 필드를 반환하기 위한 모든 요구사항을 충족합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=now &destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'
중간점
Directions API (Legacy)를 사용하여 경로를 계산할 때 경유지를 지정하여 중간 위치를 통과하거나 경유하는 경로를 반환할 수 있습니다. 운전, 도보, 자전거 경로에는 경유지를 추가할 수 있지만 대중교통 경로에는 추가할 수 없습니다.
waypoints 파라미터에 위치를 지정합니다.
장소 ID, 주소 또는 위도/경도 좌표 형식으로 파이프 문자(| 또는 %7C)로 구분된 하나 이상의 위치를 제공할 수 있습니다. 기본적으로 경로 서비스는 경유지를 지정된 순서대로 사용하여 경로를 계산합니다. 경유지 값을 파싱하는 우선순위는 장소 ID, 위도/경도 좌표, 주소 순입니다.
- 장소 ID를 전달하는 경우 앞에
place_id:를 붙여야 합니다. 장소 ID는 Geocoding API 및 Places API (Place Autocomplete 포함)에서 가져올 수 있습니다. Place Autocomplete의 장소 ID를 사용하는 예는 Place Autocomplete 및 경로를 참고하세요. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.효율성과 정확성을 위해 가능하면 장소 ID를 사용하세요. 이러한 ID는 위도/경도 값 쌍과 같이 고유하게 명시적이며 액세스 포인트 및 교통 변수와 같은 경로를 위한 지오코딩 이점을 제공합니다. 주소와 달리 ID는 서비스에서 장소 세부정보에 대한 검색 또는 중간 요청을 수행할 필요가 없으므로 성능이 더 좋습니다.
- 위도/경도 좌표를 전달하면 값이 프런트엔드 서버로 직접 전달되어 지오코딩 없이 경로를 계산합니다. 포인트가 도로에 스냅되며 앱에 필요한 정확성을 제공하지 못할 수 있습니다. 가능한 액세스 포인트나 추가 지오코딩 세부정보와 관계없이 값이 앱에서 경로를 지정하는 데 필요한 지점을 정확하게 지정한다고 확신하는 경우 좌표를 사용합니다. 위도와 경도 값이 공백 (
%20)이 아닌 쉼표 (%2C)로 구분되어 있는지 확인합니다. - 주소를 전달하면 Directions 서비스가 문자열을 지오코딩하고 위도/경도 좌표로 변환하여 경로를 계산합니다. 주소 값이 모호한 경우 유사한 주소와 구분하기 위해 검색을 유도할 수 있습니다. 예를 들어 '1st Street'는 '1st street NE' 또는 '1st St SE'의 전체 값 또는 부분 값일 수 있습니다. 이 결과는 Geocoding API에서 반환하는 결과와 다를 수 있습니다. 장소 ID를 사용하면 잘못 해석될 가능성을 방지할 수 있습니다. 경로 요청 결과 문제 해결을 참고하세요.
또는 인코딩된 다중선 알고리즘을 사용하여 인코딩된 지점 집합을 제공할 수 있습니다. 인코딩된 집합은 URL이 훨씬 짧기 때문에 많은 수의 경유지에 유용합니다. 모든 웹 서비스의 URL 제한은 16,384자(영문 기준)입니다.
- 인코딩된 다중선은 앞에
enc:를 붙이고 뒤에 콜론 (:)을 붙여야 합니다. 예:waypoints=enc:gfo}EtohhU: - 파이프 문자 (
|)로 구분된 여러 개의 인코딩된 다중선을 포함할 수도 있습니다. 예를 들면 다음과 같습니다.waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:
다음 URL은 매사추세츠주 보스턴과 매사추세츠주 콩코드 사이의 여정에 대한 경로 요청을 시작하며, 찰스타운과 렉싱턴을 순서대로 경유합니다. 이 예시에서는 다음 주소를 사용합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
경유지 및 통과 지점을 사용하여 경로에 영향 주기
요청의 각 경유지에 대해 경로 응답은 legs 배열에 항목을 추가하여 해당 구간의 중간 기착에 대한 세부정보를 제공합니다.
경유지를 추가하지 않고 경유지를 사용하여 경로에 영향을 주려면 경유지에 via: 접두사를 추가합니다. via: 프리픽스가 붙은 경유지는 legs 배열에 항목을 추가하지 않지만 경유지를 통해 여정을 라우팅합니다.
다음 URL은 이전 요청을 수정하여 이동 경로가 정차 없이 렉싱턴을 통과하도록 합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
via: 프리픽스는 사용자가 지도에서 경유지를 드래그하는 것에 대한 응답으로 경로를 만들 때 가장 효과적입니다. 이렇게 하면 사용자가 최종 경로가 어떻게 표시되는지 실시간으로 확인할 수 있으며, Directions API (기존)에서 액세스할 수 있는 위치에 경유지가 배치되도록 할 수 있습니다.
다음 URL은 위도/경도 좌표를 사용하여 경유지를 요청합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'
다음은 인코딩된 폴리라인을 사용한 동일한 요청입니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
via: 지정자를 위치 수정자와 자유롭게 혼합할 수 있습니다.
예를 들면 다음과 같습니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
경유지 최적화
기본적으로 경로 서비스는 제공된 경유지를 통해 지정된 순서대로 경로를 계산합니다. waypoints 매개변수 내에 optimize:true를 첫 번째 인수로 전달하여 경로 서비스에서 더 효율적인 순서로 경유지를 재정렬하여 제공된 경로를 최적화하도록 할 수도 있습니다. 이 최적화는 여행하는 영업사원 문제를 적용한 사례입니다. 이동 시간이 최적화되는 주요 요소이지만 가장 효율적인 경로를 결정할 때 거리, 방향 전환 횟수 등 여러 요인이 고려될 수 있습니다. 경로 서비스에서 경로를 최적화하려면 모든 경유지가 중간 기착지여야 합니다.
경로 서비스에서 경유지의 순서를 최적화하도록 지정한 경우 경유지의 순서는 routes 객체 내 waypoint_order 필드에 반환됩니다.
waypoint_order 필드는 0부터 시작하는 값을 반환합니다.
다음 예에서는 경로 최적화를 사용하여 사우스오스트레일리아 애들레이드에서 사우스오스트레일리아의 각 주요 와인 지역까지의 도로 여정을 계산합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Adelaide%2C%20SA &origin=Adelaide%2C%20SA &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'
계산된 경로를 검사하면 계산에서 다음과 같은 경유지 순서로 경유지를 사용함을 알 수 있습니다.
"waypoint_order": [ 3, 2, 0, 1 ]
제한사항
특정한 제한을 준수하여 찾아가는 길이 계산될 수도 있습니다. 제한사항은 avoid 매개변수와 피해야 할 제한사항을 나타내는 해당 매개변수의 인수를 사용하여 표시됩니다. 다음과 같은 제한이 지원됩니다.
avoid=tollsavoid=highwaysavoid=ferries
avoid 매개변수에 두 제한사항을 모두 전달하여 유료 도로, 고속도로, 페리의 조합을 피하는 경로를 요청할 수 있습니다. 예를 들면 다음과 같습니다.
avoid=tolls|highways|ferries.
참고: 제한사항을 추가해도 제한된 지형지물이 포함된 경로가 제외되지는 않으며, 더 적합한 경로로 결과가 편향됩니다.
단위 체계
경로 결과에는 경로의 특정 '단계'의 거리를 나타내기 위해 사용자에게 표시될 수 있는 distance 필드 내에 text가 포함됩니다. 기본적으로 이 텍스트는 출발지 국가 또는 지역의 단위 체계를 사용합니다.
예를 들어 '일리노이주, 시카고'에서 '온타리오주, 토론토'까지의 경로는 결과가 마일로 표시되고 그 반대 경로는 킬로미터로 표시됩니다. 요청의 units 파라미터 내에서 다음 값 중 하나를 전달하여 단위 체계를 명시적으로 설정하면 이 단위 체계를 재정의할 수 있습니다.
metric은 미터법 사용을 지정합니다. 텍스트 거리는 킬로미터와 미터를 사용하여 반환됩니다.imperial은 야드파운드법(영국) 사용을 지정합니다. 텍스트 거리는 마일과 피트를 사용하여 반환됩니다.
참고: 이 단위 체계 설정은 distance 필드 내에 표시되는 text에만 영향을 미칩니다. distance 필드에는 항상 미터 단위로 표시되는 values도 포함됩니다.
리전 상세 검색
region 매개변수를 사용하여 특정 지역의 결과를 반환하도록 경로 서비스를 설정할 수 있습니다. 이 매개변수는 지역 편향을 지정하는 두 자리 ccTLD(국가 코드 최상위 도메인) 인수를 사용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 alpha-2 코드와 동일하지만 일부 주목할 만한 예외가 있습니다.
예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(엄밀히 말하면 '영국 및 북아일랜드'의 항목). 지원되는 지역은 Google Maps Platform 노출 범위 세부정보를 참고하세요.
기본 Google 지도 애플리케이션에서 운전 경로를 실행한 모든 도메인을 사용할 수 있습니다.
예를 들어 region이 es로 설정되어 있고 'Toledo'가 스페인 도시로 해석되는 경우 'Toledo'에서 'Madrid'로의 경로 요청은 적절한 결과를 반환합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo ®ion=es &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 40.4165207, "lng": -3.7026134 }, "southwest": { "lat": 39.862808, "lng": -4.029406799999999 }, }, "copyrights": "Map data ©2022 Inst. Geogr. Nacional", "legs": [ { "distance": { "text": "74.3 km", "value": 74327 }, "duration": { "text": "57 mins", "value": 3446 }, "end_address": "Madrid, Spain", "end_location": { "lat": 40.4165207, "lng": -3.705076 }, "start_address": "Toledo, Spain", "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "steps": [ { "distance": { "text": "0.6 km", "value": 615 }, "duration": { "text": "2 mins", "value": 106 }, "end_location": { "lat": 39.8681019, "lng": -4.029378299999999 }, "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>", "polyline": { "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC", }, "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, ], "overview_polyline": { "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)", }, "summary": "A-42", "warnings": [], "waypoint_order": [], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>A-42</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>39.8681019</lat> <lng>-4.0293783</lng> </end_location> <polyline> <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points> </polyline> <duration> <value>106</value> <text>2 mins</text> </duration> <html_instructions>Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b></html_instructions> <distance> <value>615</value> <text>0.6 km</text> </distance> </step> <!-- Additional steps omitted for brevity --> <duration> <value>3446</value> <text>57 mins</text> </duration> <distance> <value>74327</value> <text>74.3 km</text> </distance> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>40.4165207</lat> <lng>-3.7050760</lng> </end_location> <start_address>Toledo, Spain</start_address> <end_address>Madrid, Spain</end_address> </leg> <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights> <overview_polyline> <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points> </overview_polyline> <bounds> <southwest> <lat>39.8628080</lat> <lng>-4.0294068</lng> </southwest> <northeast> <lat>40.4165207</lat> <lng>-3.7026134</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
region 매개변수 없이 전송된 'Toledo'에서 'Madrid'까지의 경로 요청은 결과를 반환하지 않습니다. 'Toledo'가 스페인이 아닌 오하이오주의 도시로 해석되기 때문입니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [], "status": "ZERO_RESULTS", }
XML
<DirectionsResponse> <status>ZERO_RESULTS</status> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
위치 한정자
위치 한정자를 사용하여 운전자가 특정 위치에 어떻게 접근해야 하는지를 나타낼 수 있습니다. side_of_road 매개변수를 사용하여 도로의 어느 쪽을 사용해야 하는지 지정하거나 방향을 지정하여 올바른 이동 방향을 나타낼 수 있습니다. 이러한 수정자는 중간 경유지의 via: 수정자와 자유롭게 혼합될 수 있습니다.
경로가 도로의 특정 측면을 통과해야 한다고 지정
경유지를 지정할 때 side_of_road: 접두사를 사용하여 경유지가 치우쳐 있는 도로의 어느 쪽이든 경로가 통과하도록 요청할 수 있습니다. 예를 들어 이 경로 요청은 차량이 경유지가 편향된 도로 측면에서 끝나도록 긴 경로를 반환합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=side_of_road%3A37.7663444%2C-122.4412006 &origin=37.7680296%2C-122.4375126 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'
인코딩된 다중선과 함께 side_of_road:를 사용하는 경우 매개변수는 다중선의 모든 위치에 적용됩니다.
side_of_road: 수정자는 다음 제한사항과 함께만 사용할 수 있습니다.
-
이동
mode매개변수가driving이거나 지정되지 않았습니다 (driving이 기본 이동 모드).
경로에 특정 방향이 있어야 한다고 지정
경유지를 지정할 때 경로가 특정 방향으로 경유지를 통과하도록 요청할 수 있습니다. 이 방향은 heading=X: 접두사로 지정됩니다. 여기서 X는 0 (포함)에서 360 (제외) 사이의 정수 도 값입니다. 방향이 0이면 북쪽, 90이면 동쪽을 나타내며 시계 방향으로 계속됩니다. 예를 들어 이 경로 요청에서 경로는 출발지에서 동쪽으로 이동한 다음 유턴합니다.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=37.773245%2C-122.469502 &origin=heading%3D90%3A37.773279%2C-122.468780 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'
heading=X: 수정자는 다음 제한사항과 함께만 사용할 수 있습니다.
-
이동
mode매개변수가driving,bicycling이거나 지정되지 않았습니다 (driving이 기본 이동 모드). side_of_road수정자가 동일한 위치에 지정되지 않았습니다.- 위치는 위도/경도 값으로 지정됩니다. 주소, 장소 ID 또는 인코딩된 다중선과 함께
heading를 사용할 수 없습니다.