Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

A Python client for Mapbox services

Project description

https://travis-ci.org/mapbox/mapbox-sdk-py.png?branch=master https://coveralls.io/repos/mapbox/mapbox-sdk-py/badge.png

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 or github3.py. Its methods return objects containing HTTP responses from the Mapbox API.

Services

  • Analytics V1 examples, website
    • API usage for services by resource.
    • available for premium and enterprise plans.
  • Directions V5 examples, website
    • Profiles for driving, walking, and cycling
    • GeoJSON & Polyline formatting
  • Distance V1 DEPRECATED
  • Geocoding V5 examples, website
    • Forward (place names ⇢ longitude, latitude)
    • Reverse (longitude, latitude ⇢ place names)
  • Map Matching V4 examples, website
    • Snap GPS traces to OpenStreetMap data
  • Static Maps V4 examples, website
    • Generate standalone images from existing Mapbox mapids (tilesets)
    • Render with GeoJSON overlays
  • Static Styles V1 examples, website
    • Generate standalone images from existing Mapbox styles
    • Render with GeoJSON overlays
    • Adjust pitch and bearing, decimal zoom levels
  • Surface V4 examples, website
    • Interpolates values along lines. Useful for elevation traces.
  • Uploads V1 examples, website
    • Upload data to be processed and hosted by Mapbox.
  • Datasets V1 examples, website
    • Manage editable collections of GeoJSON features
    • Persistent storage for custom geographic data
  • Tilequery V4 examples, website
    • Retrieve data about specific features from a vector tileset
  • Maps V4 examples, website
    • Retrieve an image tile, vector tile, or UTFGrid in the specified format
    • Retrieve vector features from Mapbox Editor projects as GeoJSON or KML
    • Retrieve TileJSON metadata for a tileset
    • Retrieve a single marker image without any background map

Please note that there may be some lag between the release of new Mapbox web services and releases of this package.

Installation

$ pip install mapbox

Testing

pip install -e .[test]
python -m pytest

To run the examples as integration tests on your own Mapbox account

MAPBOX_ACCESS_TOKEN="MY_ACCESS_TOKEN" python -m pytest --doctest-glob='*.md' docs/*.md

See Also

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mapbox-0.17.1-py2.py3-none-any.whl (28.9 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Sep 27, 2018
mapbox-0.17.1.tar.gz (20.9 kB) Copy SHA256 hash SHA256 Source None Sep 27, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page