Skip to main content

Create beautiful static maps with one line of Python

Project description

Mapkick Static

Create beautiful static maps with one line of Python. No more fighting with mapping libraries!

See it in action

:fire: For JavaScript maps, check out

Build Status



pip install mapkick-static

Then follow the instructions for your web framework:

Mapkick Static uses the Mapbox Static Images API. Create a Mapbox account to get an access token and set os.environ['MAPBOX_ACCESS_TOKEN'] in your environment.


Create a map in a view

from mapkick.static import StaticMap

def index(request):
    map = StaticMap([{'latitude': 37.7829, 'longitude': -122.4190}])
    return render(request, 'home/index.html', {'map': map})

And add it to the template

{{ map }}


Create a map in a route

from mapkick.static import StaticMap

def index():
    map = StaticMap([{'latitude': 37.7829, 'longitude': -122.4190}])
    return render_template('home/index.html', map=map)

And add it to the template

{{ map }}


Point map

Point map
StaticMap([{'latitude': 37.7829, 'longitude': -122.4190}])

Area map

Area map
StaticAreaMap([{'geometry': {'type': 'Polygon', 'coordinates': ...}}])


Data can be an array

StaticMap([{'latitude': 37.7829, 'longitude': -122.4190}])

Point Map

Use latitude or lat for latitude and longitude, lon, or lng for longitude

You can specify a color for each data point

    'latitude': ...,
    'longitude': ...,
    'color': '#f84d4d'

Area Map

Use geometry with a GeoJSON Polygon or MultiPolygon

You can specify a color for each data point

    'geometry': {'type': 'Polygon', 'coordinates': ...},
    'color': '#0090ff'


Width and height

StaticMap(data, width=800, height=500)

Alt text

StaticMap(data, alt='Map of ...')

Marker color

StaticMap(data, markers={'color': '#f84d4d'})

Map style

StaticMap(data, style='mapbox/outdoors-v12')


View the changelog


Everyone is encouraged to help improve this project. Here are a few ways you can help:

To get started with development:

git clone
pip install -r requirements.txt

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

mapkick_static-0.1.0-py2.py3-none-any.whl (5.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page