/mapbox-sdk-py

Python SDK for Mapbox APIs

Primary LanguagePythonMIT LicenseMIT

mapbox-sdk-py

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

  • Directions examples, website
    • Profiles for driving, walking, and cycling
    • GeoJSON & Polyline formatting
    • Instructions as text or HTML
  • Distance examples, website
    • Travel-time tables between up to 100 points
    • Profiles for driving, walking and cycling
  • Geocoding examples, website
    • Forward (place names ⇢ longitude, latitude)
    • Reverse (longitude, latitude ⇢ place names)
  • Map Matching examples, website
    • Snap GPS traces to OpenStreetMap data
  • Static Maps examples, website
    • Generate standalone images from existing Mapbox mapids
    • Render with GeoJSON overlays
  • Surface examples, website
    • Interpolates values along lines. Useful for elevation traces.
  • Uploads examples, website
    • Upload data to be processed and hosted by Mapbox.
  • Datasets examples, website
    • Manage editable collections of GeoJSON features
    • Persistent storage for custom geographic data

Other services coming soon.

Installation

$ pip install mapbox

Testing

pip install -e .[test]
py.test

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

MAPBOX_ACCESS_TOKEN="MY_ACCESS_TOKEN" py.test --doctest-glob='*.md' docs/*.md

See Also