import type * as geoRoutes from "@distilled.cloud/aws/geo-routes";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
/**
* Runtime binding for `geo-routes:SnapToRoads` — match a GPS trace (a list of
* possibly-noisy trace points) to the roads most likely traveled on, e.g.
* clean up vehicle telemetry before computing distance driven.
*
* geo-routes is a standalone, pay-per-call Amazon Location API with no
* resource to manage: the binding takes no arguments and grants the function
* `geo-routes:SnapToRoads`. Requests and responses are raw distilled types
* (positions are `[longitude, latitude]` pairs).
*
* ### Snapping GPS Traces to Roads
* Provide the `SnapToRoadsHttp` implementation layer on the Function effect
* (`.pipe(Effect.provide(AWS.GeoRoutes.SnapToRoadsHttp))`), bind in the init
* phase, then call the client at runtime.
*
* **Example:** Snap a two-point GPS trace to the road network
* ```typescript
* // init
* const snapToRoads = yield* AWS.GeoRoutes.SnapToRoads();
*
* // runtime — positions are [longitude, latitude]
* const result = yield* snapToRoads({
* TracePoints: [
* { Position: [-122.339, 47.61] },
* { Position: [-122.335, 47.608] },
* ],
* TravelMode: "Car",
* });
* const snapped = result.SnappedTracePoints.map((p) => p.SnappedPosition);
* ```
*
* @binding
*/
export interface SnapToRoads extends Binding.Service<
SnapToRoads,
"AWS.GeoRoutes.SnapToRoads",
() => Effect.Effect<
(
request: geoRoutes.SnapToRoadsRequest,
) => Effect.Effect<geoRoutes.SnapToRoadsResponse, geoRoutes.SnapToRoadsError>
>
> {}
export const SnapToRoads = Binding.Service<SnapToRoads>("AWS.GeoRoutes.SnapToRoads");