Roads API 개요

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

Roads API를 사용해야 하는 이유

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

  • 위도/경도 좌표를 도로나 도로와 연결합니다.
  • 좌표 집합에서 가장 가까운 도로 찾기
  • 도로 구간의 속도 제한 보기

Roads API로 할 수 있는 작업

Roads API를 사용하면 GPS 좌표를 도로의 도형에 매핑하고 도로 구간을 따라 속도 제한을 결정할 수 있습니다.

  • Snap to Roads 이 서비스는 제공된 GPS 좌표 집합을 기반으로 이동했을 가능성이 가장 높은 도로를 반환합니다. 경로를 따라 수집된 GPS 지점을 최대 100개까지 지정할 수 있습니다. 원하는 경우 서비스가 추가 지점을 보간하여 경로가 도로의 도형을 부드럽게 따라가도록 요청할 수도 있습니다.
  • 가장 가까운 도로 이 서비스는 GPS 지점에서 가장 가까운 도로 구간을 반환합니다. GPS 지점은 100개까지 지정할 수 있습니다. 지정하는 지점은 연속 경로의 일부가 아니어도 됩니다.
  • 속도 제한 이 서비스는 도로 구간에 명시된 속도 제한을 반환합니다. 속도 제한 서비스는 애셋 추적 라이선스가 있는 모든 고객에게 제공됩니다. 사용한 만큼만 지불하는 가격 모델로 전환한 Google Maps Platform 프리미엄 플랜 고객의 경우 이 기능이 그대로 유지됩니다.

Roads API 작동 방식

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를 통해 사용 가능한 리소스와 이 API가 반환하는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
도로에 스냅하기

경로에서 최대 100개의 GPS 지점 배열을 반환합니다. 장소 ID와 함께 도로에 맞춰진 경도/위도 좌표를 포함합니다. 자세한 내용은 도로에 스냅하기 가이드의 응답을 참고하세요.
  • JSON
가장 가까운 도로

지정된 각 지점에서 가장 가까운 도로의 장소 ID와 함께 최대 100개의 독립된 위도/경도 좌표의 배열입니다. 포인트가 연속적일 필요는 없습니다. 가장 가까운 도로 가이드의 응답에서 세부정보를 확인하세요.
속도 제한

최대 100개의 도로 메타데이터 요소의 배열입니다. 여기에는 속도 제한 및 장소 ID가 포함되며, 단위는 KPH 또는 MPH입니다. 속도 제한 가이드의 응답에서 자세한 내용을 확인하세요.

Roads API 사용 방법

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

사용 가능한 클라이언트 라이브러리

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

Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.

다음 단계