Roads API 개요

Roads API는 지도에서 하나 이상의 지점에 대한 위도/경도 좌표가 포함된 HTTPS 요청을 수락하는 서비스입니다. 이러한 지점을 사용하여 주변 도로 구간을 찾고 가장 가까운 도로 구간 및 속도 제한과 같은 메타데이터와 함께 장소 ID를 반환합니다.

Roads API를 사용하는 이유

Roads API를 사용하면 속도 제한, 예상 도착 시간 또는 기타 도로 메타데이터를 가져올 수 있습니다. 이 도로 메타데이터를 사용하면 다음과 같은 기능을 통해 운전 앱을 개선할 수 있습니다.

Roads API를 사용하면 GPS 좌표를 도로의 지오메트리에 매핑하고 도로 구간의 속도 제한을 확인할 수 있습니다.

Snap to Roads 이 서비스는 제공된 GPS 좌표 집합을 기반으로 이동한 것으로 가장 가능성이 높은 도로를 반환합니다. 경로를 따라 수집된 최대 100개의 GPS 지점을 지정할 수 있습니다. 원하는 경우 서비스에서 추가 지점을 보간하도록 요청할 수도 있습니다. 이렇게 하면 도로의 지오메트리를 부드럽게 따르는 경로가 생성됩니다.
가장 가까운 도로 이 서비스는 GPS 지점의 가장 가까운 도로 구간을 반환합니다. 최대 100개의 GPS 지점을 지정할 수 있습니다. 지정하는 지점은 연속 경로의 일부일 필요가 없습니다.
속도 제한 이 서비스는 도로 구간의 규정 속도 제한을 반환합니다. 속도 제한 서비스는 애셋 추적 라이선스가 있는 모든 고객이 사용할 수 있습니다. 사용한 만큼만 지불하는 가격 책정으로 전환한 Google Maps Platform 프리미엄 플랜 고객의 경우 이 기능이 계속 활성 상태로 유지됩니다.

Roads API는 위도/경도 좌표 또는 장소 ID를 허용하는 세 개의 엔드포인트를 사용하여 도로 경로, 구간 또는 속도 제한 데이터를 제공합니다. 다음 예에서는 위도/경도 좌표 집합을 기반으로 가장 가까운 도로를 요청하는 방법을 보여줍니다.

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

다음 표에서는 Roads API를 통해 사용할 수 있는 리소스와 반환되는 데이터를 요약합니다.

데이터 리소스	반환된 데이터	반환 형식
Snap to Roads	경로에서 최대 100개의 GPS 지점 배열을 반환합니다. 장소 ID와 함께 도로에 스냅된 경도/위도 좌표가 포함됩니다. _Snap to Roads_ 가이드의 응답에서 세부정보를 확인하세요.	JSON
Nearest Roads	최대 100개의 독립된 위도/경도 좌표 배열 과 각 지정된 지점의 가장 가까운 도로의 장소 ID가 포함됩니다. 지점은 연속될 필요가 없습니다. _Nearest Roads_ 가이드의 응답에서 세부정보를 확인하세요.
속도 제한	최대 100개의 도로 메타데이터 요소 배열입니다. 여기에는 속도 제한과 장소 ID가 포함되며 단위는 KPH 또는 MPH입니다. _속도 제한_ 가이드의 응답에서 세부정보를 확인하세요.

1	Snap to Roads 데모 사용해 보기	데모를 클릭하여 트랙을 만들고 Snap to Roads 엔드포인트 가 원활한 데이터를 제공하는 방법을 확인합니다. 데모 를 Snap to Roads 가이드에서 확인하세요. API 키는 필요하지 않습니다.
2	설정하기	Google Cloud 프로젝트 설정하기 로 시작하고 이어지는 설정 안내를 완료한 후 API 키를 사용하는 방법을 알아봅니다.
3	Snap to Roads 요청해 보기	Snap to Roads 예시 중 하나를 사용하고 사용 사례와 관련된 예시를 사용해 봅니다.
4	도로 경로의 속도 제한 가져오기	Snap to Roads 요청에 제공한 것과 동일한 경로 데이터를 사용하여 속도 제한 쿼리를 실행합니다. 경로를 사용하는 요청 예시를 참고하세요. .
5	긴 경로를 처리하는 방법 알아보기	긴 경로 처리 섹션을 고급 개념 가이드에서 따르세요.
6	도로 데이터를 자체 앱에 통합하기	도로 스냅 데모의 상세 코드 예시를 참고하여 자체 앱에 도로 데이터 기능을 빌드합니다.

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.