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 제한인 16,384자 내에 많은 수의 경로를 맞출 수 있습니다. 경유지가 REST 또는 gRPC 요청 본문에서 위도/경도 좌표로 전송될 수 있으므로 Routes API에서는 이 기능이 필요하지 않습니다. 예를 보려면 경로 매트릭스 계산 문서의 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 Routes에서만 지원됩니다.
mode travelMode

TWO_WHEELER 및 TRANSIT 지원을 추가했습니다.
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

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

Powered by Google, ©YEAR Google

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

Powered by Google, ©2022 Google
distance distanceMeters 거리는 미터 단위로만 사용할 수 있습니다.
duration_in_traffic duration Routes API에서 삭제되었습니다. duration를 사용하세요.
status 사용할 수 없음. API에서 보고된 오류에는 HTTP 응답 코드를 사용합니다. 자세한 내용은 요청 오류 처리를 참고하세요.
geocoded_waypoints geocoding_results Compute Routes에서만 지원됩니다. 주소로 지정된 경유지에 대한 지오코딩 응답 정보만 포함합니다.
bounds viewport
legs.end_address 사용할 수 없음.
legs.start_address 사용할 수 없음.
overview_polyline 다중선
summary description
waypoint_order optimizedIntermediateWaypointIndex