---
title: "Get Apple Maps travel-time estimates between two points"
method: GET
path: "/apple-maps/eta"
tags: ["Apple Maps"]
---

# Get Apple Maps travel-time estimates between two points

`GET /apple-maps/eta`

## Request

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

Returns Apple Maps travel-time estimates between an origin and a destination: for each transport type Apple reports (driving always; walking when requested), the live best estimate, the historic and free-flow durations, and the route distance. Cheaper than the directions endpoint when only the time and distance are needed. Apple has no cycling ETA; use the directions endpoint for cycling.

## Query parameters

- `origin_latitude` number, required
- `origin_longitude` number, required
- `destination_latitude` number, required
- `destination_longitude` number, required
- `mode` 'driving' | 'walking'
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsEtaResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsETAResponse
    - `destination` ApplemapsLatLng
      - `latitude` number
      - `longitude` number
    - `etas` ApplemapsETA[]
      - `distance_meters` integer
      - `duration_historic_seconds` integer
      - `duration_seconds` integer
      - `duration_static_seconds` integer
      - `transport` string
    - `origin` 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)