Roads API 개요

Roads API는 다음을 사용하여 HTTPS 요청을 수락하는 서비스입니다. 지도에 있는 하나 이상의 지점에 대한 위도/경도 좌표입니다. 이 백도어는 지점을 사용하여 주변 도로 구간을 찾고 메타데이터와 함께 장소 ID를 반환합니다. 정보를 제공할 수 있습니다.

Roads API를 사용해야 하는 이유

Roads API를 사용하면 교통체증, 예상 속도, 다른 도로 메타데이터를 포함할 수 있습니다. 이 도로 포함 메타데이터를 활용하면 다음 기능으로 운전 앱을 개선할 수 있습니다.

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

Roads API로 할 수 있는 작업

Roads API를 사용하면 GPS 좌표를 도로의 형태, 도로상의 제한 속도 결정 세그먼트.

  • Snap to Roads 이 서비스는 제공된 GPS 좌표 집합을 기반으로 이동한 도로입니다. 최대 100개 경로를 따라 수집된 GPS 지점입니다. 원하는 경우 서비스가 추가 점을 보간하면 경로가 평평하게 따라가는 형태가 됩니다. 표시됩니다.
  • 가장 가까운 도로 이 서비스는 가장 가까운 도로를 반환합니다. 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 및 반환된 데이터

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

경로에서 최대 100개의 GPS 지점 배열을 반환합니다. 제공 서비스 도로에 맞춰 정렬된 경도/위도 좌표 할 수 있습니다. 자세한 내용은 다음을 참고하세요. 응답 Snap to Roads에서 참조하세요.
  • JSON
가장 가까운 도로

최대 100개의 독립적인 위도/경도 좌표 배열 지정된 각 지점에서 가장 가까운 도로에 대한 장소 ID도 표시됩니다. 포인트가 연속적일 필요는 없습니다. 자세한 내용은 다음을 참고하세요. 응답 가장 가까운 도로 참조하세요.
속도 제한

최대 100개의 도로 메타데이터 요소의 배열입니다. 여기에는 속도, 제한과 장소 ID가 있으며, 단위는 KPH 또는 MPH입니다. 세부정보 보기 응답에서 속도 제한 참조하세요.

Roads API 사용 방법

1 도로에 맞추기 데모 사용해 보기 데모를 클릭해 트랙을 만들고 Snap to Roads 엔드포인트가 어떻게 나타나는지 확인하세요 원활한 데이터를 제공합니다. 자세한 내용은 데모 도로에 스냅하기 가이드의 항목을 참조하세요. API 키는 필요하지 않습니다.
2 설정하기 먼저 설정 Google Cloud 프로젝트를 선택하고 다음 안내에 따라 설정 안내를 완료합니다. 학습하고 API 키 사용 방법을 참조하세요.
3 도로에 맞추기 요청 다음 중 한 가지 방법을 사용해 예시 를 살펴보고 사용 사례와 관련된 예시도 시도해 보세요.
4 도로의 속도 제한 확인 도로에 맞추기 요청에 제공한 것과 동일한 경로 데이터를 사용하여 속도 제한 쿼리를 발행할 수 있습니다. 자세한 내용은 경로를 사용한 예시 요청.
5 긴 경로 처리 방법 알아보기 다음 섹션을 따르세요. 긴 경로 처리 자세한 내용은 고급 개념 가이드를 참조하세요.
6 도로 데이터를 자체 앱에 통합하세요. 자세한 내용은 자세한 코드 예를 살펴보겠습니다. 자체 앱에 도로 데이터 기능을 빌드합니다.

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

이 API를 다음 언어로 호출 다음 클라이언트 라이브러리 중 하나를 통해 사용할 수 있습니다.

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

다음 단계