Routes API는 경로, 거리, 이동 시간 계산 성능을 개선하므로 Directions API 및 Distance Matrix API를 사용하는 앱을 대체할 가치가 있습니다. Routes API의 대부분의 기능은 Directions API 및 Distance Matrix API와 모두 하위 호환됩니다.
이 가이드를 사용하여 대체 제품과 비교한 Routes API의 주요 차이점과 필요한 변경사항을 처리하는 방법을 알아보세요. 기타 Routes API 기능에 대한 자세한 내용은 제품 개요를 참고하세요.
주요 개선사항
이 섹션에서는 앱에서 Routes API를 사용할 때 예상되는 몇 가지 개선사항을 다룹니다.
요청 한도 증가
| Routes API Compute Route Matrix |
|
| Distance Matrix API |
|
더 빠른 요청 응답
Compute Route Matrix 기능은 다음과 같은 지연 시간 개선사항을 제공합니다.
- 전체 행렬이 계산되기 전에 대답의 스트리밍 요소를 수신합니다.
- 필드 마스크를 사용하여 응답 세부정보를 맞춤설정하고 필요한 데이터만 요청하세요. 비용을 절감하는 데도 도움이 되는 권장사항입니다.
- 트래픽에 대한 경로 계산이 개선되어 데이터 품질과 응답 시간 간의 균형을 조정할 수 있습니다.
라우팅 개선사항
경로 계산 기능은 다음과 같은 라우팅 개선사항을 제공합니다.
- 거리 및 도착 예정 시간 외에 통행료 정보
- 이륜차 경로
- 안전을 위해 경유지 웨이포인트를 검증합니다.
- 경유지의 이동 방향과 도로 측면을 설정하여 도착예정시간 정확도 향상
필요한 데이터만 요청
이제 반환할 필드를 지정하여 처리 시간과 청구 요금을 줄일 수 있습니다.
| Routes API Compute Routes Compute Route Matrix |
요청에서 필드 마스크를 사용하여 응답에서 반환할 필드를 지정해야 합니다. 필드 마스크를 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
자세한 내용은 반환할 필드 선택을 참고하세요. |
| Directions API Distance Matrix API |
앱에 엄격하게 필요하지 않더라도 기본 필드 목록을 반환합니다. 이로 인해 불필요한 처리 시간과 청구 요금이 발생할 수 있습니다. |
교통 상황에 맞게 향상된 경로 계산
Routes API는 교통 정보를 요청할 때 응답 지연 시간과 데이터 품질 간의 균형을 맞추는 데 사용할 수 있는 세 가지 라우팅 환경설정을 지원합니다.
자세한 내용은 품질과 지연 시간 구성을 참고하세요.
TRAFFIC_UNAWARE (기본값) |
실시간 트래픽 데이터가 아닌 평균 시간 독립 트래픽 데이터를 사용하여 경로를 계산하므로 응답 지연 시간이 가장 짧습니다. 이 설정은 Directions API 및 Distance Matrix API에서 교통정보를 사용하지 않는 경우와 동일합니다. |
TRAFFIC_AWARE (신규) |
지연 시간을 줄이기 위해 성능에 최적화된 실시간 트래픽 품질 TRAFFIC_AWARE_OPTIMAL와 달리 이 설정은 지연 시간을 크게 줄이도록 최적화를 적용합니다.
이 설정은 Directions API 또는 Distance Matrix API에 상응하는 항목이 없는 Routes API의 새로운 설정이기도 합니다.
|
TRAFFIC_AWARE_OPTIMAL |
고품질의 포괄적인 트래픽 데이터 이 설정은 지연 시간이 가장 길며 Directions API 및 Distance Matrix API의 departure_time 설정과 동일합니다. 이 환경설정은 maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 동일합니다. |
경로 계산 비교
다음 표에서는 Routes API와 Directions API 및 Distance Matrix API 서비스 간의 라우팅 옵션을 비교합니다.
| 트래픽 옵션 | Routes API | Directions API Distance Matrix API |
지연 시간 |
|---|---|---|---|
| 실시간 교통정보 없음 | TRAFFIC_UNAWARE |
departure_time 속성이 설정되지 않음 |
세 가지 모드 중 지연 시간이 가장 빠릅니다. |
| 실시간 교통상황이 적용됨 | TRAFFIC_AWARE |
- 동등한 보고서 없음 | Routes API에 의해 추가된 새로운 모드입니다. 지연 시간이 |
| 고품질의 포괄적인 실시간 교통 정보가 적용됨 | TRAFFIC_AWARE_OPTIMAL |
departure_time 속성 집합 |
maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 동일합니다. Compute Route Matrix의 경우 요청의 요소 수 (출발지 수 × 목적지 수)가 100을 초과할 수 없습니다. |
주요 차이점
이 섹션에서는 Routes API와 대체되는 서비스 간의 주요 차이점과 기존 앱에서 이러한 서비스로부터 마이그레이션할 때 이러한 차이점을 해결하는 방법을 설명합니다.
두 서비스 대신 하나의 서비스 호출
| Routes API | 앱에서 Compute Routes 및 Compute Route Matrix를 사용하려면 API 콘솔에서 하나의 서비스만 사용 설정하세요.
자세한 내용은 Google API 콘솔에서 설정을 참고하세요. |
| Directions API Distance Matrix API |
API 콘솔에서 Directions API와 Distance Matrix API를 별도의 서비스로 사용 설정합니다. |
HTTPS POST 요청 사용
| Routes API | HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 예는 다음을 참고하세요. - 경로 계산 - 경로 매트릭스 계산 |
| Directions API Distance Matrix API |
HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다. |
예상 도착 시간 응답 차이
Routes API는 아래 표와 같이 Directions API 및 Distance Matrix API 서비스와 다르게 ETA를 반환하고 duration 응답 속성을 사용합니다.
| 확장 텍스트 광고 유형 | Routes API | Directions API Distance Matrix API |
|---|---|---|
| 교통정보를 고려하지 않는 시간 독립적인 도착예정시간입니다. |
|
요청에서
|
| 실시간 교통정보를 고려한 도착 예정 시간입니다. |
|
요청에서
|
다중선 경유지
이 서비스는 POST 요청 본문을 지원하므로 더 이상 URL 문자열 제한의 영향을 받지 않으며, 이 서비스를 사용하면 위도/경도 좌표를 폴리라인 웨이포인트로 변환하지 않아도 됩니다. Distance Matrix API의 일부 사용자는 위도/경도 포인트를 폴리라인 경유지로 변환하여 요청 한도 문제를 해결했습니다.
형식이 지정된 주소 (역 지오코드)
Routes API는 응답에 형식이 지정된 주소를 제공하지 않습니다. 형식이 지정된 주소를 얻으려면 이 사용 사례를 위해 빌드되었으며 더 나은 품질의 결과를 제공하는 Geocoding API를 사용하세요.
사용 가능한 이동 수단
Directions API와 마찬가지로 Routes API는 경로 요청에서 이동 수단을 지정하지 않는 경우 DRIVE를 기본 모드로 사용합니다. 하지만 요청에서 경로의 이동 수단을 지정하는 경우 Routes API는 요청의 대체 선택사항으로 사용 가능한 이동 수단 배열을 반환하지 않습니다. 사용 사례가 이 기능을 사용하는 경우 Google에서 후속 조치를 취할 수 있도록 기능을 사용하는 방법을 설명하는 문제를 신고하세요.
XML을 응답 형식으로 사용
Routes API는 XML을 응답 형식으로 제공하지 않습니다. 목적에 맞는 JSON-XML 변환기를 온라인에서 찾을 수 있습니다.