Skip to content
This repository was archived by the owner on Aug 2, 2022. It is now read-only.

Repository files navigation

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

Services

  • Analytics V1examples, website

    • API usage for services by resource.
    • available for premium and enterprise plans.
  • Directions V5examples, website

    • Profiles for driving, walking, and cycling
    • GeoJSON & Polyline formatting
  • Distance V1DEPRECATED

  • Geocoding V5examples, website

    • Forward (place names ⇢ longitude, latitude)
    • Reverse (longitude, latitude ⇢ place names)
  • Map Matching V4examples, website

    • Snap GPS traces to OpenStreetMap data
  • Static Maps V4examples, website

    • Generate standalone images from existing Mapbox mapids (tilesets)
    • Render with GeoJSON overlays
  • Static Styles V1examples, website

    • Generate standalone images from existing Mapbox styles
    • Render with GeoJSON overlays
    • Adjust pitch and bearing, decimal zoom levels
  • Surface V4examples, website

    • Interpolates values along lines. Useful for elevation traces.
  • Uploads V1examples, website

    • Upload data to be processed and hosted by Mapbox.
  • Datasets V1examples, website

    • Manage editable collections of GeoJSON features
    • Persistent storage for custom geographic data
  • Tilequery V4examples, website

    • Retrieve data about specific features from a vector tileset
  • Maps V4examples, 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.

Documentation

Please see https://mapbox-mapbox.readthedocs-hosted.com/en/latest/

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

About

Python SDK for Mapbox APIs **DEVELOPMENT IS TEMPORARILY PAUSED, SEE CONTRIBUTING.md**

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

320 stars

Watchers

39 watching

Forks

Releases

Packages

Used by

Contributors

Languages