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에서 참조하세요. |
|
가장 가까운 도로 |
최대 100개의 독립적인 위도/경도 좌표 배열 지정된 각 지점에서 가장 가까운 도로에 대한 장소 ID도 표시됩니다. 포인트가 연속적일 필요는 없습니다. 자세한 내용은 다음을 참고하세요. 응답 가장 가까운 도로 참조하세요. |
|
속도 제한 |
최대 100개의 도로 메타데이터 요소의 배열입니다. 여기에는 속도, 제한과 장소 ID가 있으며, 단위는 KPH 또는 MPH입니다. 세부정보 보기 응답에서 속도 제한 참조하세요. |
Roads API 사용 방법
1 | 도로에 맞추기 데모 사용해 보기 | 데모를 클릭해 트랙을 만들고 Snap to Roads 엔드포인트가 어떻게 나타나는지 확인하세요 원활한 데이터를 제공합니다. 자세한 내용은 데모 도로에 스냅하기 가이드의 항목을 참조하세요. API 키는 필요하지 않습니다. |
2 | 설정하기 | 먼저 설정 Google Cloud 프로젝트를 선택하고 다음 안내에 따라 설정 안내를 완료합니다. 학습하고 API 키 사용 방법을 참조하세요. |
3 | 도로에 맞추기 요청 | 다음 중 한 가지 방법을 사용해 예시 를 살펴보고 사용 사례와 관련된 예시도 시도해 보세요. |
4 | 도로의 속도 제한 확인 | 도로에 맞추기 요청에 제공한 것과 동일한 경로 데이터를 사용하여 속도 제한 쿼리를 발행할 수 있습니다. 자세한 내용은 경로를 사용한 예시 요청. |
5 | 긴 경로 처리 방법 알아보기 | 다음 섹션을 따르세요. 긴 경로 처리 자세한 내용은 고급 개념 가이드를 참조하세요. |
6 | 도로 데이터를 자체 앱에 통합하세요. | 자세한 내용은 자세한 코드 예를 살펴보겠습니다. 자체 앱에 도로 데이터 기능을 빌드합니다. |
사용 가능한 클라이언트 라이브러리
이 API를 다음 언어로 호출 다음 클라이언트 라이브러리 중 하나를 통해 사용할 수 있습니다.
- 자바 Google 지도 서비스 클라이언트
- Python Google 지도 서비스 클라이언트
- Go 클라이언트 (Google 지도 서비스 사용 시)
- Node.js Google 지도 서비스 클라이언트
Google 지도용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트 서비스는 커뮤니티 지원 클라이언트 라이브러리로, Apache 2.0 라이선스. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.
다음 단계
- Roads API 사용해 보기: Roads Inspector로 이동합니다.
- Roads API 요청 방법 알아보기: 관심 있는 서비스로 이동합니다. 위치: <ph type="x-smartling-placeholder">
- 고급 개념 이해: 고급 개념으로 이동합니다.
- 권장사항 준수: 웹 서비스 권장사항으로 이동합니다.