Python SDK for Mapbox APIs **DEVELOPMENT IS TEMPORARILY PAUSED, SEE CONTRIBUTING.md**
.. image:: https://travis-ci.org/mapbox/mapbox-sdk-py.png?branch=master :target: https://travis-ci.org/mapbox/mapbox-sdk-py
.. image:: https://coveralls.io/repos/mapbox/mapbox-sdk-py/badge.png :target: https://coveralls.io/r/mapbox/mapbox-sdk-py
A Python client for Mapbox web services
The Mapbox Python SDK is a low-level client API, not a Resource API such as the ones in boto3 <http://aws.amazon.com/sdk-for-python/>
__ or github3.py <https://github3py.readthedocs.org/en/master/>
. Its methods return objects containing HTTP responses <http://docs.python-requests.org/en/latest/api/#requests.Response>
from the Mapbox API.
Analytics V1 examples <./docs/analytics.md>
, website <https://www.mapbox.com/api-documentation/accounts/#analytics>
Directions V5 examples <./docs/directions.md#directions>
, website <https://www.mapbox.com/api-documentation/navigation/#directions>
Distance V1 DEPRECATED
Geocoding V5 examples <./docs/geocoding.md#geocoding>
, website <https://www.mapbox.com/api-documentation/search/#geocoding>
Map Matching V4 examples <./docs/mapmatching.md#map-matching>
, website <https://www.mapbox.com/api-documentation/navigation/#map-matching>
Static Maps V4 examples <./docs/static.md#static-maps>
, website <https://www.mapbox.com/api-documentation/legacy/static-classic>
Static Styles V1 examples <./docs/static.md#static-maps>
, website <https://www.mapbox.com/api-documentation/maps/#static>
Surface V4 examples <./docs/surface.md#surface>
, website <https://www.mapbox.com/developers/api/surface/>
Uploads V1 examples <./docs/uploads.md#uploads>
, website <https://www.mapbox.com/api-documentation/maps/#uploads>
Datasets V1 examples <./docs/datasets.md#datasets>
, website <https://www.mapbox.com/api-documentation/maps/#datasets>
Tilequery V4 examples <./docs/tilequery.md#tilequery>
, website <https://www.mapbox.com/api-documentation/maps/#tilequery>
Maps V4 examples <./docs/maps.md#maps>
, website <https://www.mapbox.com/api-documentation/maps/#maps>
Please note that there may be some lag between the release of new Mapbox web services and releases of this package.
Please see https://mapbox-mapbox.readthedocs-hosted.com/en/latest/
.. code:: bash
$ pip install mapbox
.. code:: bash
pip install -e .[test]
python -m pytest
To run the examples as integration tests on your own Mapbox account
.. code:: bash
MAPBOX_ACCESS_TOKEN="MY_ACCESS_TOKEN" python -m pytest --doctest-glob='*.md' docs/*.md