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-backend.googleapis.com - 인증: API 키
- 시작하기: Directions API 설정
- 참조: Directions API 참조
- 가격 책정: Directions API 사용량 및 결제
- 정책: Directions 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를 참고하세요.