Directions API 또는 Distance Matrix API에서 이전

이 가이드에서는 Directions API 또는 Distance Matrix API를 사용하는 앱을 Routes API를 사용하여 이전하는 방법을 설명합니다. Routes API에 대한 자세한 내용은 제품 개요를 참조하세요.

REST API 엔드포인트 업데이트

새로운 Routes API 엔드포인트를 사용하도록 코드 업데이트

Directions API에서 추가

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Distance Matrix API에서

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

HTTPS 요청 본문을 사용하도록 URL 매개변수 변환

Directions API와 Distance Matrix API를 사용하면 구성 속성을 URL 매개변수로 HTTP GET 요청에 전달할 수 있습니다. 예를 들어 Directions API의 경우 다음과 같습니다.

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Routes API를 사용하면 HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달할 수 있습니다. 예를 들어 다음을 참조하세요.

인코딩된 다중선으로 표시되는 경유지를 중간 경유지로 변환하기

Directions API에서 URL을 8,192자(영문 기준)로 제한하여 경유지를 다량으로 늘릴 수 있도록 경유지를 인코딩된 다중선으로 지정할 수 있습니다. 경유지 또는 REST 요청 본문에 경유지를 중간 경유지로 전송할 수 있으므로 Routes API에는 이 기능이 필요하지 않습니다.

기존 매개변수를 Routes API 매개변수로 변환

다음 표에는 Directions API 및 Distance Matrix API의 이름이 변경되거나 수정된 매개변수 또는 GA 출시 버전에서 지원되지 않는 매개변수가 나와 있습니다. 이러한 매개변수 중 하나를 사용하는 경우 코드를 업데이트하세요.

Routes 또는 Distance Matrix 매개변수 Routes API 매개변수 메모
alternatives computeAlternativeRoutes
arrival_time TRANSIT 모드를 사용할 수 없으므로 사용할 수 없습니다.
avoid routeModifiers
copyrights

응답에 포함되지 않습니다. 사용자에게 결과를 표시할 때 다음 문구를 포함해야 합니다.

Powered by Google, ©YEAR Google

예를 들면 다음과 같습니다.

Powered by Google, ©2022 Google

departure_time departureTime
distance distanceMeters 거리는 미터 단위로만 확인할 수 있습니다.
duration_in_traffic Routes API에서 삭제되었습니다. duration를 사용하세요. 자세한 내용은 위의 새 Routes API 기능 변경을 참조하세요.
language languageCode 컴퓨팅 경로에만 지원됩니다.
mode travelMode

TWO_WHEELER 지원을 추가했습니다.

TRANSIT 모드를 사용할 수 없습니다.

region regionCode

status 사용할 수 없음. API에서 보고하는 오류에는 HTTP 응답 코드를 사용합니다. 자세한 내용은 요청 오류 처리를 참조하세요.
traffic_model 사용할 수 없음.
transit_mode TRANSIT 모드를 사용할 수 없으므로 사용할 수 없습니다.
transit_routing_preference TRANSIT 모드를 사용할 수 없으므로 사용할 수 없습니다.
units 경로 매트릭스에 사용할 수 없습니다.
waypoints intermediates 인코딩된 다중선에 대한 지원을 삭제했습니다.
경유지의 경우 optimize=true 사용할 수 없음.