mapkick-static 0.1.0

Create beautiful static maps with one line of Python

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 Mapkick.py

Installation

Run:

pip install mapkick-static

Then follow the instructions for your web framework:

• Django
• Flask

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

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

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:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features

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