翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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}}'
```
------