The Uploads class from the mapbox.services.uploads module provides access
to the Mapbox Uploads API. You can also import it directly from the mapbox
module.
>>> from mapbox import UploaderSee https://www.mapbox.com/api-documentation/maps/#uploads for general documentation of the API.
Your Mapbox access token should be set in your environment; see the access
tokens documentation for more information. To use the
Uploads API, you must use a token created with uploads:* scopes. See
https://www.mapbox.com/account/apps/.
The methods of the Uploads class that provide access to the Uploads API
return an instance of
requests.Response.
Upload any supported file to your account using the Uploader. The file
object must be opened in binary mode (rb) and produce bytes when read, not unicode strings.
The name of the destination dataset can be any string of <= 32 chars. Choose one
suited to your application or generate one using, e.g., uuid.uuid4().hex.
In the example below, we use a string defined in a test fixture.
>>> service = Uploader()
>>> from time import sleep
>>> from random import randint
>>> mapid = getfixture('uploads_dest_id') # 'uploads-test'
>>> with open('tests/twopoints.geojson', 'rb') as src:
... upload_resp = service.upload(src, mapid)
...
>>> if upload_resp.status_code == 422:
... for i in range(5):
... sleep(5)
... with open('tests/twopoints.geojson', 'rb') as src:
... upload_resp = service.upload(src, mapid)
... if upload_resp.status_code != 422:
... breakThis 201 Created response indicates that your data file has been received and is being processed. Poll the Upload API to determine if the processing has finished using the upload identifier from the the body of the above response.
>>> upload_resp.status_code
201
>>> upload_id = upload_resp.json()['id']
>>> for i in range(5):
... status_resp = service.status(upload_id).json()
... if status_resp['complete']:
... break
... sleep(5)
...
>>> mapid in status_resp['tileset']
TrueSee import mapbox; help(mapbox.Uploader) for more detailed usage.