이 가이드에서는 Directions API 또는 Distance Matrix API를 사용하는 앱을 Routes API를 사용하도록 이전하는 방법을 설명합니다. Routes API에 대한 자세한 내용은 제품 개요를 참고하세요.
마이그레이션 결제 권장사항
이 안내는 API 사용량이 2단계 요금으로 전환될 만큼 높은 경우에 적용됩니다. 최신 버전의 API로 이전하면 다른 SKU에 대한 요금도 청구됩니다. 전환하는 달에 비용이 증가하지 않도록 하려면 가능한 한 달 초에 프로덕션에서 새 API로 전환하는 것이 좋습니다. 이렇게 하면 이전 달에 가장 비용 효율적인 월별 요금 등급에 도달할 수 있습니다. 가격 등급에 대한 자세한 내용은 가격 페이지 및 가격 FAQ를 참고하세요.
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를 사용하면 구성 속성을 HTTP GET 요청에 URL 매개변수로 전달합니다. 예를 들어 Directions API의 경우 다음과 같습니다.
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API를 사용하면 HTTP POST 요청의 일부로 요청 본문이나 헤더에 매개변수를 전달합니다. 예를 들어 다음을 참조하세요.
다중선으로 인코딩된 경유지를 위치 경유지로 변환
인코딩된 폴리라인으로 경유지를 지정하는 것은 16384자의 URL 제한에 많은 수의 경유지를 맞추기 위해 Directions API (기존)에서 사용할 수 있습니다. 이 기능은 경로 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 |
컴퓨팅 경로에만 지원됩니다. |
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 |
units |
자세히 알아보기 |
waypoints |
intermediates |
인코딩된 폴리라인에 대한 지원이 삭제되었습니다. |
optimize=true - 경유지 |
"optimizeWaypointOrder": "true" |
자세히 알아보기 |
응답 매개변수 변환
| 경로 또는 거리 행렬 매개변수 | Routes API 매개변수 | 참고 |
|---|---|---|
copyrights |
대답에 포함되지 않습니다. 사용자에게 결과를 표시할 때는 다음 문구를 포함해야 합니다.
예를 들면 다음과 같습니다.
|
|
distance |
distanceMeters |
거리는 미터 단위로만 표시됩니다. |
duration_in_traffic |
duration |
Routes API에서 삭제되었습니다. duration를 사용하세요. |
status |
사용할 수 없습니다. API에서 보고한 오류에 HTTP 응답 코드를 사용합니다. 자세한 내용은 요청 오류 처리를 참고하세요. | |
geocoded_waypoints |
geocoding_results |
컴퓨팅 경로에만 지원됩니다. 주소로 지정된 경유지에 대한 지오코딩 응답 정보만 포함합니다. |
bounds |
viewport |
|
legs.end_address |
사용할 수 없습니다. | |
legs.start_address |
사용할 수 없습니다. | |
overview_polyline |
다중선 | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |