---
title: "Get Apple Maps driving, walking, or cycling directions"
method: GET
path: "/apple-maps/directions"
tags: ["Apple Maps"]
---

# Get Apple Maps driving, walking, or cycling directions

`GET /apple-maps/directions`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/apple-maps/directions`
- Auth: API key in header `x-api-key`

Returns Apple Maps routes between an origin and a destination, with optional intermediate stops, for driving, walking, or cycling. Each route carries its name, whether it is Apple's main or an alternate route, distance, live/historic/free-flow durations, toll and highway flags, Apple's route description and traffic note, and per-leg turn-by-turn steps (maneuver, road, shield, instruction text, distance, duration); detail=full adds each leg's path as coordinates. Departure time and avoid-tolls/highways/stairs preferences are supported. Transit routing is not available.

## Query parameters

- `origin_latitude` number, required
- `origin_longitude` number, required
- `destination_latitude` number, required
- `destination_longitude` number, required
- `via` string
- `mode` 'driving' | 'walking' | 'cycling'
- `avoid_tolls` boolean
- `avoid_highways` boolean
- `avoid_stairs` boolean
- `depart_at` string
- `detail` 'summary' | 'steps' | 'full'
- `lang` string
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsDirectionsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsDirectionsResponse
    - `depart_at` string
    - `destination` ApplemapsLatLng
      - `latitude` number
      - `longitude` number
    - `mode` string
    - `origin` ApplemapsLatLng
      - `latitude` number
      - `longitude` number
    - `routes` ApplemapsRoute[]
      - `avoids_highways` boolean
      - `avoids_tolls` boolean
      - `description` string
      - `distance_meters` integer
      - `duration_freeflow_seconds` integer
      - `duration_historic_seconds` integer
      - `duration_seconds` integer
      - `legs` ApplemapsRouteLeg[]
        - `distance_meters` integer
        - `duration_seconds` integer
        - `name` string
        - `path` array[]
          - number[]
        - `steps` ApplemapsRouteStep[]
          - `distance_meters` integer
          - `duration_seconds` integer
          - `index` integer
          - `instruction` string
          - `maneuver` string
          - `road` string
          - `shield` string
      - `name` string
      - `traffic` string
      - `transport` string
      - `type` string
    - `via` ApplemapsLatLng[]
      - `latitude` number
      - `longitude` number
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)