이 가이드에서는 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 |
응답에 포함되지 않습니다. 사용자에게 결과를 표시할 때 다음 문구를 포함해야 합니다.
예를 들면 다음과 같습니다.
|
|
departure_time |
departureTime |
|
distance |
distanceMeters |
거리는 미터 단위로만 확인할 수 있습니다. |
duration_in_traffic |
|
Routes API에서 삭제되었습니다. duration 를 사용하세요. 자세한 내용은 위의 새 Routes API 기능 변경을 참조하세요. |
language |
languageCode |
컴퓨팅 경로에만 지원됩니다. |
mode |
travelMode |
|
region |
regionCode |
|
status |
사용할 수 없음. API에서 보고하는 오류에는 HTTP 응답 코드를 사용합니다. 자세한 내용은 요청 오류 처리를 참조하세요. | |
traffic_model |
사용할 수 없음. | |
transit_mode |
TRANSIT 모드를 사용할 수 없으므로 사용할 수 없습니다. |
|
transit_routing_preference |
TRANSIT 모드를 사용할 수 없으므로 사용할 수 없습니다. |
|
units |
경로 매트릭스에 사용할 수 없습니다. | |
waypoints |
intermediates |
인코딩된 다중선에 대한 지원을 삭제했습니다. |
경유지의 경우 optimize=true |
사용할 수 없음. |