mapbox
A Python client for Mapbox services
What it is and what it does
The Mapbox Python SDK is a low-level HTTP client for Mapbox's geospatial web services. It wraps endpoints for directions (driving, walking, cycling profiles), geocoding (forward and reverse), map matching (snapping GPS traces to roads), static map rendering, data uploads, and tile queries. Each method returns raw HTTP response objects, giving you direct access to Mapbox's JSON payloads rather than abstracted resource objects.
The package depends on requests, boto3, polyline, uritemplate, and utility libraries for date handling and caching. It's designed for developers who need programmatic access to Mapbox services from Python and are comfortable working with HTTP responses directly. However, the repository is archived and unmaintained since 2022-08-01, meaning no new features, security patches, or compatibility updates will be released.
Use it for:
- Build a route optimization tool that calls Mapbox Directions to compute driving or walking paths between multiple points.
- Implement reverse geocoding to convert GPS coordinates into human-readable addresses in a location-based application.
- Snap noisy GPS traces from mobile devices to actual road networks using Map Matching to clean up tracking data.
- Generate static map images with GeoJSON overlays for reports, emails, or embedded visualizations.
- Query vector tilesets to retrieve feature data at specific geographic coordinates for spatial analysis.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
A Python client library for Mapbox web services, providing low-level access to APIs for directions, geocoding, map matching, static maps, uploads, and other geospatial operations.
No, not for new projects. The package is abandoned (last release 2022-08-01, repository archived) and will receive no maintenance, security updates, or compatibility fixes. If you need Mapbox services in Python, evaluate current official Mapbox offerings or maintained alternatives. Only consider this package if maintaining legacy code that already depends on it.
Install
mapbox on PyPI
pip
pip install mapboxuv
uv add mapboxpoetry
poetry add mapboxInstalling mapbox
Before you install
Low install friction with a pure-Python wheel distribution. However, the repository is archived and the last release was in August 2022. The package is marked as abandoned, so expect no maintenance, security updates, or bug fixes going forward.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
Quickstart
pip install mapbox
from mapbox import Geocoder
geo = Geocoder(name='mapbox.places', access_token='YOUR_MAPBOX_ACCESS_TOKEN')
response = geo.forward('San Francisco')
Requires a valid Mapbox access token (available from your Mapbox account) to authenticate API requests.
Verify before relying
- Whether the Mapbox API endpoints this SDK targets remain stable and functional given the package's abandoned status.
- Compatibility with modern Python versions beyond 3.6, since the latest release predates recent Python releases.
- Whether dependency versions (boto3, requests, etc.) have drifted enough to cause runtime issues with current installations.
Package facts
| License | MIT (permissive) |
| Python support | not specified |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 7 — boto3, cachecontrol, iso3166, python-dateutil, requests, polyline, uritemplate |
| Maintenance | abandoned — 1,474 days since the last release |
| Last repo commit | (repository archived) |
| First released | |
| Downloads | 186,636/month — #9,981 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: mapbox-0.18.1-py2.py3-none-any.whl
Tags
More WWW/HTTP packages
urllib3 is an HTTP client library that provides…
permissive · top 100 on PyPI
requestsRequests is a Python HTTP library that…
permissive · top 100 on PyPI
h11h11 is a pure-Python HTTP/1.1 protocol…
permissive · top 100 on PyPI
httpxHTTPX is a fully featured HTTP client library…
permissive · top 100 on PyPI
httpcoreA minimal low-level HTTP client library that…
permissive · top 100 on PyPI
aiohttpaiohttp is an async HTTP client and server…
permissive · top 100 on PyPI
arcgisAccess Esri's ArcGIS services and geospatial…
unclear · top 15,000 on PyPI
googlemapsPython client library that wraps Google Maps…
permissive · top 5,000 on PyPI
contextilyContextily retrieves tile-based map imagery…
permissive · top 15,000 on PyPI
lobPython wrapper for the Lob.com API, providing…
permissive · top 15,000 on PyPI
azure-maps-searchProvides a Python client for Azure Maps Search…
permissive · top 15,000 on PyPI
polylineEncodes and decodes geographic coordinate…
unclear · top 5,000 on PyPI
staticmapGenerates static map images with geographic…
unclear · top 15,000 on PyPI
geosGEOS is a web server for creating and viewing…
copyleft · top 15,000 on PyPI
mapbox-vector-tileEncodes and decodes Mapbox Vector Tiles (MVT)…
permissive · top 15,000 on PyPI
boxsdkProvides a Python client library for…
permissive · top 5,000 on PyPI