Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add Navigation API support: Directions, Matrix, and Isochrone

Closed
#75 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
66/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
openapi, rust
Domain
api, cli

Research direction

Start with the command-generation flow and the vendored specs in openapi/ and custom-openapi/, then compare the linked Mapbox Directions, Matrix, and Isochrone API documentation. Done means the three Navigation API command groups are represented by vendored specs and generated CLI commands can expose their route, matrix, and reachability operations.

Written by the indexing model from the issue text.

Description

enhancement

Request

Add command groups for the Mapbox Navigation APIs — Directions, Matrix, and Isochrone — so an agent can compute routes, travel-time matrices, and reachability from the terminal.

Why

These answer questions a frontier model fundamentally can't, because they depend on the live road network and traffic:

  • Directions — route, distance, and traffic-aware travel time between points. "How long to drive from A to B right now, and which way."
  • Matrix — travel times/distances across many origins and destinations at once. "Of these 10 candidates, which is fastest to reach from the office." This is the real "travel time between places" primitive.
  • Isochrone — the area reachable within N minutes. "What's within a 15-minute walk." Natural pair with search-along-route and site-selection workflows.

Each produces concrete, checkable output an agent can act on, and none of it is memorizable.

Context

The CLI generates commands from the OpenAPI specs vendored in openapi/ and custom-openapi/. None of the Navigation APIs are vendored today, so the commands don't exist. The README notes upcoming releases will extend coverage to most public APIs — this is a request to prioritize the Navigation three.

Dominant language
Rust
Stars
15
Forks
2
Avg merge
1d 15h
Merged PRs (30d)
43

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from mapbox/mapbox-cli

All issues in mapbox/mapbox-cli

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.