# Application Maps and Location: Route Planner

Ordered stop timeline with per leg distances and ETAs beside a static map tracing the route with numbered markers and a vehicle dot.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/route-planner
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Maps and Location](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location)
- Created: 2026-07-02
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/route-planner.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-maps-location-route-planner
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: badge, button
- Installs to: `@/components/blocks/application-pro/maps-location/route-planner`

## About this block

Route Planner is the delivery route panel, an ordered
stop timeline (Depot 12 departed at 8:04 AM, Fern & Co.
badged as the next stop, Marlow Coffee and Beacon Books
scheduled) with per leg distance and drive time between
rows, beside a static map blueprint that traces the
route as right angle street segments with numbered stop
markers and a live vehicle dot. The completed leg
renders solid, the remaining legs render dashed, and a
totals strip carries distance, drive time, stops
completed, and final ETA.

Stops are one array with SVG coordinates, status, time,
and leg fields, so the timeline, the map markers, and
the header counts stay in sync from a single source.
The map is self-contained inline SVG with no tile
provider or embed.

## When to use

Reach for this block in dispatch consoles, courier
apps, and field service tools where someone tracks a
route with several stops in progress. Wire the stop
array to your routing API and move the vehicle dot and
the solid leg boundary from live telemetry.

A natural flow around it on an Application Pro page:

**Before**

- [App shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)
- [Filters and search](https://www.shadcn-ui-blocks.com/blocks/application-pro/filters-and-search)

**After**

- [Territory list](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location)
- [Activity feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity)

## What you can display

One strong use is the courier route in progress. Other
route planner surfaces:

- **Field service day plan.** A technician's visits in
  order with job windows instead of delivery ETAs.
- **Sales visit loop.** Account stops for a rep's day
  with meeting times on the right rail.
- **Shuttle schedule.** A fixed loop where every stop
  repeats and the totals strip shows headway instead
  of a final ETA.

> Tip: keep completed stops in the list instead of
> removing them; the solid leg plus the check markers
> is what tells the story of progress at a glance.

## More in Application Maps and Location

- [Address Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/address-card)
- [Distance Radius Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/distance-radius-card)
- [Geofence Zones](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/geofence-zones)
- [IP Lookup Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/ip-lookup-panel)
- [Location History](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/location-history)
- [Location Picker](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/location-picker)
- [Location Sharing Settings](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/location-sharing-settings)
- [Map With Pins Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/map-with-pins-blueprint)
- [Region Selector](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/region-selector)
- [Territory List](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/territory-list)
- [Timezone Overlap](https://www.shadcn-ui-blocks.com/blocks/application-pro/maps-location/timezone-overlap)
