/mapkick-static.py

Create beautiful static maps with one line of Python

Primary LanguagePythonMIT LicenseMIT

Mapkick Static.py

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

See it in action

For JavaScript maps, check out Mapkick.py

Build Status

Installation

Run:

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.

Django

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 }}

Flask

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 }}

Maps

Point map

Point map

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

Area map

Area map

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

Data

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'
}

Options

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')

History

View the changelog

Contributing

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

To get started with development:

git clone https://github.com/ankane/mapkick-static.py.git
cd mapkick-static.py
pip install -r requirements.txt
pytest