이 가이드에서는 다음 중 하나를 사용하는 앱을 이전하는 방법을 설명합니다. 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를 사용하여 경유지의 개수는 16,384자로 제한됩니다. 이 기능은 에서 경유지가 전송될 수 있으므로 Routes API에서 위도/경도 좌표로 표현되는 REST 또는 gRPC 요청 본문입니다. 예를 들어 자세한 내용은 HTTP 예시 경로 행렬 계산 문서에서 중간 경유지 정의 (중간 경유지 지정 문서 참조)
매개변수 변환
다음 표에는 Directions API 및 Distance Matrix API는 또는 GA에서 지원되지 않는 매개변수가 변경되거나 있습니다. 이러한 매개변수를 사용하는 경우 코드를 업데이트하세요.
매개변수 변환 요청
| 경로 또는 거리 행렬 매개변수 | Routes API 매개변수 | 참고 |
|---|---|---|
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 매개변수 | 참고 |
|---|---|---|
copyrights |
대답에 포함되지 않았습니다. 다음을 포함해야 합니다. 명령문을 사용합니다.
예를 들면 다음과 같습니다.
|
|
distance |
distanceMeters |
거리는 미터 단위로만 제공됩니다. |
duration_in_traffic |
duration |
Routes API에서 삭제되었습니다. duration를 사용하세요. |
status |
사용할 수 없음. HTTP 응답 코드를 사용하여 오류를 반환합니다. 요청 오류 처리를 참고하세요. 를 참조하세요. | |
geocoded_waypoints |
geocoding_results |
Compute 경로에만 지원됩니다. 주소로 지정된 경유지에 대한 지오코딩 응답 정보만 포함합니다. |
bounds |
viewport |
|
legs.end_address |
사용할 수 없음. | |
legs.start_address |
사용할 수 없음. | |
overview_polyline |
다중선 | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |