Directions API 빠른 참조

Directions API(기존)는 경유지가 있는 다중 구간 경로를 포함하여 운전, 도보, 자전거, 대중교통의 위치 간 경로를 계산하고 경로, 구간, 단계를 JSON 또는 XML로 반환하는 웹 서비스입니다. 기존 상태입니다. 2026년 10월부터는 새 Google Cloud 프로젝트에 사용 설정할 수 없습니다. Routes API로 이전하세요.

Directions API: 주요 사실

  • 제품: Directions API
  • 다른 이름: Directions API(기존)
  • 카테고리: 경로
  • 플랫폼: 웹 서비스(REST)
  • 실행 위치: 서버(백엔드 코드)
  • 출시 단계: GA
  • 수명 주기: 기존
  • 대체: Routes API
  • 개요: Directions API 개요
  • 신청 가능 지역: 전 세계 적용 범위는 지역 및 이동 수단에 따라 다릅니다(대중교통은 대중교통 제공업체의 데이터에 따라 다름). (보증 범위 세부정보)

Directions API: 사용해야 하는 경우

Directions API를 사용하는 경우:

  • Directions API(기존)가 이미 사용 설정되어 있고 maps/api/directions를 호출하는 기존 Google Cloud 프로젝트를 유지합니다.
  • 기존 프로젝트에서 JSON 또는 XML 형식의 운전, 도보, 자전거 또는 대중교통(대중교통이 아닌 모드의 경유지만 해당)에 대한 서버 측 경로가 필요합니다.

다음과 같은 경우에는 Directions API를 사용하지 마세요.

  • 새 Google Cloud 프로젝트를 시작하는 경우 2026년 10월부터 새 프로젝트에 Directions API(기존)를 사용 설정할 수 없습니다. 대신 Routes API를 사용하세요.
  • 새로운 라우팅 기능과 개선된 성능이 필요합니다. 대신 Routes API를 사용하세요.
  • 한 번의 요청으로 여러 출발지와 목적지의 이동 시간과 거리가 필요합니다. 대신 Routes API를 사용하세요.

Directions API: 설정

Directions API: 일반적인 실수

  • 문제: 기존 API가 사용 설정되지 않은 프로젝트에서 Directions API(기존)에 대한 요청이 LegacyApiNotActivatedMapError 오류와 함께 실패합니다. 해결 방법: 앱을 소유하고 있다면 Routes API로 이전하세요. 이전하는 동안 또는 앱 업데이트를 기다리는 동안 단기적인 해결 방법으로 기존 API 활성화 양식을 작성하여 기존 API를 활성화할 수 있습니다. /maps/legacy를 참고하세요.
  • 문제: 경유지에 via: 접두사를 사용하면 엄격한 통과 지점이 되므로 심각한 우회 또는 ZERO_RESULTS 상태가 발생할 수 있습니다. 해결 방법: 엄격한 통과 지점이 필요하지 않은 경우 경유지 경유 지점(via: 접두사 없음)을 사용합니다. /maps/documentation/directions/get-directions를 참고하세요.
  • 문제: 경유지가 11~25개인 요청, optimize:true, 교통정보를 고려한 소요 시간(duration_in_traffic) 또는 side_of_road 또는 heading 위치 수정자가 포함된 요청은 더 높은 Directions Advanced(Pro) SKU로 청구됩니다. 해결 방법: 이러한 기능은 필요할 때만 사용하세요. Essentials SKU를 유지하려면 경유지를 10개 이하로 유지하고 optimize:true, departure_time(운전의 경우), side_of_road, heading를 생략하세요. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku를 참고하세요.
  • 문제: 운전의 경우 departure_time가 과거일 수 없습니다(요청이 INVALID_REQUEST로 실패함). departure_time가 없으면 경로와 소요 시간은 시간에 구애받지 않는 평균 교통량을 사용하며 duration_in_traffic가 반환되지 않습니다. 해결 방법: departure_time를 now 또는 mode=driving를 사용하여 미래 시간으로 설정하여 duration_in_traffic를 가져옵니다. duration_in_traffic를 반환하는 요청은 Directions Advanced(Pro) SKU로 청구됩니다. /maps/documentation/directions/get-directions를 참고하세요.