# Google Maps Directions Scraper (`crawlerbros/google-maps-directions`) Actor

Extract driving, walking, bicycling, and transit directions between any two locations from Google Maps - distance, duration, traffic, route alternatives, and turn-by-turn steps.

- **URL**: https://apify.com/crawlerbros/google-maps-directions.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Travel, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Google Maps Directions Scraper

Extract driving, walking, bicycling, and transit directions between any two locations from Google Maps — including distance, duration, traffic conditions, route alternatives, and turn-by-turn steps.

### What It Does

Provide an origin and a destination (as addresses, place names, or `lat,lng` coordinates), and this actor returns:

- **All route alternatives** Google Maps offers (up to 5)
- **Distance** in both human-readable form (`"1.2 mi"`) and integer meters
- **Duration** in human-readable form (`"8 min"`) and integer seconds
- **"via" road** for each route (e.g. `"via Broadway"`)
- **Traffic condition** notes when available (e.g. `"Moderate traffic"`)
- **Turn-by-turn step instructions** for the primary route (best-effort)
- **Resolved origin and destination** strings (what Google actually matched)
- **The final Google Maps directions URL** you can share or open in a browser

### Use Cases

- ETA calculators, courier and logistics planning, dispatch dashboards
- Travel-time monitoring between business locations
- Field-service routing and territory planning
- Sales and customer-visit scheduling
- Real-estate commute analyses
- Tourism / transit research

### Input

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `origin` | String | yes | — | Starting location (address, place name, or `lat,lng`) |
| `destination` | String | yes | — | Ending location (address, place name, or `lat,lng`) |
| `travelMode` | Enum | no | `driving` | One of `driving`, `walking`, `bicycling`, `transit` |
| `language` | Enum | no | `en` | UI language (affects instruction text) |
| `units` | Enum | no | `metric` | `metric` or `imperial` distance preference |
| `avoidTolls` | Boolean | no | `false` | Driving mode — avoid toll roads |
| `avoidHighways` | Boolean | no | `false` | Driving mode — avoid highways/motorways |
| `avoidFerries` | Boolean | no | `false` | Driving mode — avoid ferry routes |
| `departureTime` | String | no | — | Optional ISO 8601 datetime for transit routing |
| `proxyConfiguration` | Object | no | — | Optional Apify proxy (used only as a fallback) |

**Example input:**

```json
{
  "origin": "Times Square, New York, NY",
  "destination": "Central Park, New York, NY",
  "travelMode": "driving"
}
````

**Walking directions:**

```json
{
  "origin": "Eiffel Tower, Paris",
  "destination": "Louvre Museum, Paris",
  "travelMode": "walking",
  "language": "en"
}
```

### Output

Each route alternative produces one dataset record:

```json
{
  "origin": "Times Square, New York, NY",
  "destination": "Central Park, New York, NY",
  "originResolved": "Times Square",
  "destinationResolved": "Central Park",
  "midpointLocation": { "lat": 40.7700, "lng": -73.9758 },
  "travelMode": "driving",
  "language": "en",
  "units": "metric",
  "routeIndex": 0,
  "distance": "1.2 mi",
  "distanceMeters": 1931,
  "duration": "8 min",
  "durationSeconds": 480,
  "via": "via Broadway",
  "trafficCondition": "Moderate traffic",
  "steps": [
    { "instruction": "Head north on Broadway", "distance": "0.3 mi" }
  ],
  "googleMapsUrl": "https://www.google.com/maps/dir/Times+Square/Central+Park/?hl=en&travelmode=driving",
  "scrapedAt": "2026-06-16T10:30:00+00:00"
}
```

Empty fields are omitted from the record.

### How It Works

- Loads the canonical Google Maps directions URL in a stealth Chromium browser
- Waits for route alternatives to render, then extracts them from the DOM
- Distance and duration strings are also normalised to integer meters / seconds for downstream analytics

### FAQ

**How many routes are returned per run?**
Up to 5 alternatives, in the order Google Maps shows them. `routeIndex: 0` is Google's recommended route.

**Why does Google sometimes resolve my origin/destination differently?**
Google Maps performs its own geocoding and may match the closest known place. The `originResolved` and `destinationResolved` fields show what it actually matched.

**Can I use coordinates instead of addresses?**
Yes — pass `"40.7580,-73.9855"` (or similar) as origin/destination and the actor will route between the exact points.

**Does this actor use cookies or login?**
No. Google Maps directions are public and require no authentication.

**Is a proxy needed?**
Usually not. The actor first attempts the run without a proxy, which is the most reliable approach for Google Maps. If you configure a proxy, it is used only as a fallback.

**What if Google Maps cannot find a route (e.g. between two continents for driving)?**
The actor will report no routes found and fail the run gracefully so you can see the issue in the status message.

### 🗺️ Complete Google Maps Scraper Suite

This actor is part of a comprehensive Google Maps data extraction toolkit by **crawlerbros**. All actors run on the free Apify plan, use no proxy by default, and return clean, structured data.

| Actor | What it does |
|---|---|
| 🏢 [Google Maps Business Scraper](https://apify.com/crawlerbros/google-maps-scraper) | Extract business data — name, address, phone, website, rating, reviews, hours, amenities |
| ⭐ [Google Maps Reviews Scraper](https://apify.com/crawlerbros/google-maps-reviews-scraper) | Scrape reviews with reviewer Local Guide level, photos, mentioned items, owner replies |
| 📸 [Google Maps Photos Scraper](https://apify.com/crawlerbros/google-maps-photos) | Extract all photos from any place — max-resolution URLs, contributor info, categories |
| 🕐 [Google Maps Business Hours Scraper](https://apify.com/crawlerbros/google-maps-business-hours) | Full 7-day hours, timezone, current local time, next open/close, holiday hours |
| 📊 [Google Maps Popular Times Scraper](https://apify.com/crawlerbros/google-maps-popular-times) | Busy hours histogram for all 7 days + current busyness + typical visit time |
| 📧 [Google Maps Email Extractor](https://apify.com/crawlerbros/google-maps-email-extractor) | Find business emails + social media links by crawling websites |
| 🗺️ [Google Maps Area Scanner](https://apify.com/crawlerbros/google-maps-area-scanner) | Geographic grid scanning — bypass the 120-place limit with bounding box / circle / polygon |
| 💼 [Google Maps Leads Scraper](https://apify.com/crawlerbros/google-maps-leads) | B2B lead generation with email + phone enrichment, US states + global countries |
| 🤖 [Google Maps MCP Server](https://apify.com/crawlerbros/google-maps-mcp) | Unified MCP server combining search + reviews for AI assistants |
| 📍 [Google Maps Geocoding Scraper](https://apify.com/crawlerbros/google-maps-geocoding) | Bidirectional geocoding — address ↔ coordinates, with address components |
| 🔗 [Google Maps Similar Places Scraper](https://apify.com/crawlerbros/google-maps-similar-places) | "People also search for" / related place discovery — competitor & alternative finder |
| 🍽️ [Google Maps Menu Scraper](https://apify.com/crawlerbros/google-maps-menu) | Restaurant menu items, prices, descriptions, photos |
| 📌 [Google Maps Nearby Scraper](https://apify.com/crawlerbros/google-maps-nearby) | Find places near a coordinate point — lightweight POI search by category |
| 📋 [Google Maps Place List Scraper](https://apify.com/crawlerbros/google-maps-place-list) | Extract Google's curated "Top X in Y" lists — best hotels/restaurants/things to do |
| 🌍 [Google Maps Timezone Scraper](https://apify.com/crawlerbros/google-maps-timezone) | IANA timezone + current local time from coordinates |

# Actor input Schema

## `origin` (type: `string`):

Starting location — full address, place name, or 'lat,lng' coordinate pair.

## `destination` (type: `string`):

Ending location — full address, place name, or 'lat,lng' coordinate pair.

## `travelMode` (type: `string`):

Mode of transportation.

## `language` (type: `string`):

Language of the directions page (affects step instructions text).

## `units` (type: `string`):

Preferred distance units. Google Maps may still localise based on the route's country.

## `avoidTolls` (type: `boolean`):

Driving mode only — avoid toll roads when possible.

## `avoidHighways` (type: `boolean`):

Driving mode only — avoid highways/motorways when possible.

## `avoidFerries` (type: `boolean`):

Driving mode only — avoid routes that use ferries.

## `departureTime` (type: `string`):

Optional ISO 8601 datetime (e.g. 2026-06-16T10:30:00) used for transit routing.

## `proxyConfiguration` (type: `object`):

Optional fallback proxy. The actor first tries without a proxy (more reliable for Google Maps); proxy is used only if the no-proxy attempt fails.

## Actor input object example

```json
{
  "origin": "Times Square, New York, NY",
  "destination": "Central Park, New York, NY",
  "travelMode": "driving",
  "language": "en",
  "units": "metric",
  "avoidTolls": false,
  "avoidHighways": false,
  "avoidFerries": false
}
```

# Actor output Schema

## `directions` (type: `string`):

Dataset containing all scraped Google Maps direction records — one record per route alternative.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "origin": "Times Square, New York, NY",
    "destination": "Central Park, New York, NY",
    "travelMode": "driving",
    "language": "en",
    "units": "metric"
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/google-maps-directions").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "origin": "Times Square, New York, NY",
    "destination": "Central Park, New York, NY",
    "travelMode": "driving",
    "language": "en",
    "units": "metric",
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/google-maps-directions").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "origin": "Times Square, New York, NY",
  "destination": "Central Park, New York, NY",
  "travelMode": "driving",
  "language": "en",
  "units": "metric"
}' |
apify call crawlerbros/google-maps-directions --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/google-maps-directions",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Directions Scraper",
        "description": "Extract driving, walking, bicycling, and transit directions between any two locations from Google Maps - distance, duration, traffic, route alternatives, and turn-by-turn steps.",
        "version": "1.3",
        "x-build-id": "PLEB7XbhptCZN3IGk"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~google-maps-directions/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-google-maps-directions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/crawlerbros~google-maps-directions/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-google-maps-directions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/crawlerbros~google-maps-directions/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-google-maps-directions",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "origin",
                    "destination"
                ],
                "properties": {
                    "origin": {
                        "title": "Origin",
                        "type": "string",
                        "description": "Starting location — full address, place name, or 'lat,lng' coordinate pair."
                    },
                    "destination": {
                        "title": "Destination",
                        "type": "string",
                        "description": "Ending location — full address, place name, or 'lat,lng' coordinate pair."
                    },
                    "travelMode": {
                        "title": "Travel Mode",
                        "enum": [
                            "driving",
                            "walking",
                            "bicycling",
                            "transit"
                        ],
                        "type": "string",
                        "description": "Mode of transportation.",
                        "default": "driving"
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "en",
                            "es",
                            "fr",
                            "de",
                            "it",
                            "pt",
                            "ja",
                            "ko",
                            "zh",
                            "ar",
                            "ru"
                        ],
                        "type": "string",
                        "description": "Language of the directions page (affects step instructions text).",
                        "default": "en"
                    },
                    "units": {
                        "title": "Units",
                        "enum": [
                            "metric",
                            "imperial"
                        ],
                        "type": "string",
                        "description": "Preferred distance units. Google Maps may still localise based on the route's country.",
                        "default": "metric"
                    },
                    "avoidTolls": {
                        "title": "Avoid Tolls",
                        "type": "boolean",
                        "description": "Driving mode only — avoid toll roads when possible.",
                        "default": false
                    },
                    "avoidHighways": {
                        "title": "Avoid Highways",
                        "type": "boolean",
                        "description": "Driving mode only — avoid highways/motorways when possible.",
                        "default": false
                    },
                    "avoidFerries": {
                        "title": "Avoid Ferries",
                        "type": "boolean",
                        "description": "Driving mode only — avoid routes that use ferries.",
                        "default": false
                    },
                    "departureTime": {
                        "title": "Departure Time (Transit)",
                        "type": "string",
                        "description": "Optional ISO 8601 datetime (e.g. 2026-06-16T10:30:00) used for transit routing."
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Optional fallback proxy. The actor first tries without a proxy (more reliable for Google Maps); proxy is used only if the no-proxy attempt fails."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```