기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# SnapToRoads 사용 방법 알아보기
이 주제에서는 `SnapToRoads`를 사용하여 GPS 트레이스를 도로 네트워크에 정렬하여 탐색 및 플릿 관리 애플리케이션의 위치 정확도를 높이는 방법을 설명합니다. 이 API는 이동 모드 제한을 준수하면서 좌표를 가장 가까운 도로 세그먼트로 스냅하여 GPS 드리프트 및 신호 손실을 수정합니다. 예제에서는 GPS 트레이스 오버레이, 데이터 갭 채우기, 보다 명확한 경로 시각화를 위한 노이즈 감소와 같은 실제 사용을 보여줍니다.
**Topics**
+ [GPS 추적과 도로망을 일치시키는 방법](how-to-match-gps-traces.md)
# GPS 추적과 도로망을 일치시키는 방법
SnapToRoads API를 사용하면 GPS 추적을 도로망에 일치시킬 수 있습니다. GPS 추적에는 GPS 디바이스를 사용하여 기록되는 타임스탬프, 속도, 헤딩과 같은 위치 및 메타데이터가 포함됩니다. 이러한 추적에는 종종 오류 범위가 있으므로 분석 및 시각화에 직접 사용하기 어렵습니다.
SnapToRoads는 추적과 일치하면서 지정된 이동 모드에 대한 법적 제한 및 시간 제한을 고려합니다. 추적에서 제한 위반이 강력하게 제안되는 경우 실제로 이동한 경로가 유지됩니다.
## 잠재적 사용 사례
+ **가장 가능성이 높은 주행 도로에 GPS 추적 오버레이:** 이 기능은 GPS 데이터를 도로망의 가장 정확한 경로에 맞춰 보다 명확한 데이터 시각화를 지원하는 데 도움이 됩니다.
+ **GPS 추적에서 격차 보간:** SnapToRoads는 도로망에 좌표를 스냅하여 격차를 메울 수 있으므로 애플리케이션에 대해 더 지속적이고 유용한 데이터세트를 생성할 수 있습니다.
+ **노이즈 및 이상치 필터링:** 이 API는 가장 가까운 도로에 스냅하여 이상치를 제거하고 GPS 노이즈를 줄여 분석을 위한 데이터 신뢰성을 개선하는 데 도움이 될 수 있습니다.
## 예제
### 차량 모드를 사용하여 GPS 추적 일치
------
#### [ Sample request ]
```
{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"Notices": [],
"SnappedGeometry": {
"Polyline": "Redacted"
},
"SnappedGeometryFormat": "FlexiblePolyline",
"SnappedTracePoints": [
{
"Confidence": 1,
"OriginalPosition": [8.53404, 50.16364],
"SnappedPosition": [8.53402, 50.16367]
},
{
"Confidence": 0.86,
"OriginalPosition": [8.53379056, 50.16352417],
"SnappedPosition": [8.53375, 50.16356]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Car"
```
------
### 옵션과 함께 트럭 모드를 사용하여 GPS 추적 일치
------
#### [ Sample request ]
```
{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Truck",
"TravelModeOptions": {
"Truck": {
"GrossWeight": 10000
}
}
}
```
------
#### [ Sample response ]
```
{
"Notices": [],
"SnappedGeometry": {
"Polyline": "Redacted"
},
"SnappedGeometryFormat": "FlexiblePolyline",
"SnappedTracePoints": [
{
"Confidence": 1,
"OriginalPosition": [8.53404, 50.16364],
"SnappedPosition": [8.53402, 50.16367]
},
{
"Confidence": 0.86,
"OriginalPosition": [8.53379056, 50.16352417],
"SnappedPosition": [8.53375, 50.16356]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Truck",
"TravelModeOptions": {
"Truck": {
"GrossWeight": 10000
}
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Truck" \
--travel-mode-options '{"Truck": {"GrossWeight": 10000}}'
```
------