이 가이드에서는 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 제한인 16,384자 안에서 다수의 경유지를 입력할 수 있습니다. 경유지는 REST 또는 gRPC 요청 본문에서 위도/경도 좌표로 전송될 수 있으므로 Routes API에서는 이 기능이 필요하지 않습니다. 예를 보려면 경로 매트릭스 계산 문서의 HTTP 예 또는 중간 경유지 지정 문서의 중간 경유지 정의를 참고하세요.
매개변수 변환
다음 표에는 이름이 변경되거나 수정된 Directions API 및 Distance Matrix API의 매개변수 또는 정식 버전에서 지원되지 않는 매개변수가 나와 있습니다. 이러한 매개변수를 사용하는 경우 코드를 업데이트합니다.
매개변수 전환 요청
경로 또는 거리 행렬 매개변수 | Routes API 매개변수 | Notes |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
TRANSIT 모드에서만 사용할 수 있으며 departureTime 와 동시에 사용할 수 없습니다. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
arrivalTime 과(와) 동시에 사용할 수 없습니다. |
language |
languageCode |
Compute 경로에만 지원됩니다. |
mode |
travelMode |
|
region |
regionCode |
|
traffic_model |
trafficModel |
자세히 알아보기 |
transit_mode |
"travelMode": "TRANSIT" |
Directions API의 대중교통 경로에서 이동 모드가 동일한 경로 (예: 도보 또는 대중교통)의 각 구간은 한 단계로 간주되며 해당 이동 수단의 개별 경로는 하위 단계에 있습니다. 반면 Routes API에서 단계는 모든 유형의 이동에서 일관된 하나의 탐색 명령입니다. 따라서 각 탐색 명령은 단계이며 한 이동 수단의 여러 단계에 대해 Routes API는 'stepsOverview'에 해당 이동 수단의 단계 요약이 포함된 메타데이터를 제공합니다. 이 메타데이터를 요청하려면 `routes.legs.stepsOverview` 필드 마스크를 사용하세요. 자세히 알아보기 |
transit_routing_preference |
transitRoutingPreference |
자세히 알아보기 |
units |
경로 매트릭스에 사용할 수 없습니다. | |
waypoints |
intermediates |
인코딩된 다중선에 대한 지원이 삭제되었습니다. |
경유지의 경우 optimize=true |
"optimizeWaypointOrder": "true" |
자세히 알아보기 |
응답 매개변수 전환수
경로 또는 거리 행렬 매개변수 | Routes API 매개변수 | Notes |
---|---|---|
copyrights |
응답에 포함되지 않습니다. 사용자에게 결과를 표시할 때 다음 문을 포함해야 합니다.
예를 들면 다음과 같습니다.
|
|
distance |
distanceMeters |
거리는 미터 단위로만 제공됩니다. |
duration_in_traffic |
duration |
Routes API에서 삭제되었습니다. duration 를 사용합니다. |
status |
사용할 수 없음. API에서 보고된 오류에는 HTTP 응답 코드를 사용합니다. 자세한 내용은 요청 오류 처리를 참고하세요. | |
geocoded_waypoints |
geocoding_results |
Compute 경로에만 지원됩니다. 주소로 지정된 경유지에 대한 지오코딩 응답 정보만 포함됩니다. |
bounds |
viewport |
|
legs.end_address |
사용할 수 없음. | |
legs.start_address |
사용할 수 없음. | |
overview_polyline |
다중선 | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |