Interface RoutingProviderExperimental

Provider-pluggable routing contract. Adapters normalize into the same typed result shape; capability differences are declared, not discovered at runtime. Operations outside capabilities throw HonuaCapabilityNotSupportedError under the "strict" capability policy (the default).

interface RoutingProvider {
    attribution: string;
    capabilities: readonly "route"[];
    id: string;
    usagePolicyUrl?: string;
    route(waypoints: readonly RouteWaypoint[]): Promise<ProviderRouteResult>;
}

Properties

attribution: string

Human-readable data attribution the host is obliged to display.

capabilities: readonly "route"[]

Operations this provider supports.

id: string

Stable provider identifier, e.g. "osrm".

usagePolicyUrl?: string

Usage/acceptable-use policy for the configured endpoint, when known.

Methods