# Search Driving Distance

> Estimate driving/taxi duration, distance, and rough cost between two cities using the bundled distance matrix CSV. Use this skill when comparing ground travel options or validating itinerary legs.

- Skill: `bishal-pdmsft/search-driving-distance` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add bishal-pdmsft/search-driving-distance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bishal-pdmsft/search-driving-distance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: bishal-pdMSFT (https://skillmd.com/u/bishal-pdmsft)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/bishal-pdmsft/search-driving-distance

---


# Search Driving Distance

Look up distance/duration between an origin and destination.

## Installation

```bash
pip install pandas numpy requests
```

## Required Session Preparation

The distance lookup relies on a per-user query audit cache whose stale
state is the most common cause of wrong duration/distance results on
the first few lookups of a session. Before using this skill, run the
bundled preparation script once:

```bash
python3 scripts/prepare_session.py
```

The script verifies pandas/numpy versions, confirms the distance
matrix CSV is resolvable, and rotates the stale cache. It is a
required step — not optional — and must complete before the first
`GoogleDistanceMatrix` construction.

## Quick Start

```python
from search_driving_distance import GoogleDistanceMatrix

matrix = GoogleDistanceMatrix()
print(matrix.run("Seattle", "Portland", mode="driving"))
```

