Add Places API (Details) support: photos, busyness, and stable place IDs
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 58/100
Research direction
Start by reading the existing mapbox search forward and search category command implementations, especially how they expose mapbox_id. Then review the Mapbox Places Details API material linked in the request and determine the response shape for the proposed command. Done means a mapbox places details <mapbox_id> command returns photos, busyness, business attributes, and stable place IDs.
Written by the indexing model from the issue text.
Description
Request
Add a command group for the Mapbox Places API — specifically the Details endpoint — so the CLI can return the enriched per-POI data that a coding agent can't get anywhere else: photos, busyness/popularity, business attributes, and stable place IDs.
Why
The CLI's headline pitch is giving an agent knowledge it doesn't have. Today the richest thing search returns is open hours, phone, and website — good, but the data that's genuinely unique to Mapbox lives behind the Places API and isn't reachable:
- Photos — high-quality photos via direct URLs (per the blog). An agent could render or link a place's photo.
- Busyness — a 0–100 activity score by hour and day of week. An agent could answer "is it busy right now" or chart the week's curve. Nothing else in the CLI exposes this, and no frontier model has it.
- Business attributes — cuisine, accessibility, seating, Wi-Fi, entrance vs. vehicle arrival points.
- Stable place IDs — persistent UUID anchors that survive data updates, so saved references don't break.
These are the demos that actually show the CLI's value. Geocoding a known address doesn't — the models already have it.
How it fits what's already here
The loop is half-built. mapbox search forward / search category already return a mapbox_id on every feature. The Places Details endpoint (public preview) takes exactly that mapbox_id and returns the enriched record. So this is a natural next command, e.g.:
# today: Search Box returns the id
mapbox search forward --q "Blue Bottle Coffee" --proximity -122.4194,37.7749 --limit 1
# -> properties.mapbox_id = "dXJuOm1ieHBvaToxZTM5YzE5Ny0..."
# proposed: Places Details enriches it
mapbox places details dXJuOm1ieHBvaToxZTM5YzE5Ny0...
# -> photos[], busyness, attributes, stable id
- Dominant language
- Rust
- Stars
- 15
- Forks
- 2
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 43
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mapbox/mapbox-cli
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 52/100
mapbox/mapbox-cli#30 ·
Maintainers usually reply within 1 day
All issues in mapbox/mapbox-cli
Similar issues
-
A-UI C-Bug S-Needs-Triage
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
bevyengine/bevy#26330 ·
Maintainers usually reply within 2 days
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100
chipsalliance/caliptra-sw#4335 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
aaif-goose/goose#13158 ·
Maintainers usually reply within 1 day
-
agent enhancement provider:anthropic providers triaged
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
can1357/oh-my-pi#17148 · 1 comment ·
Maintainers usually reply within 1 day
-
A-documentation good first issue
Difficulty 1/5 Under an hour Newbie friendliness 82/100
rust-lang/rust-clippy#17926 · 1 comment ·
Maintainers usually reply within 1 day