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!
:fire: For JavaScript maps, check out Mapkick.py
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
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for mapkick_static-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1818271ef0e202c725b492a463a421d585d27d7cbe55d17ab0d7f86e8830b58f |
|
MD5 | 34fb4664aebfa0d0965d12f0bdb100b9 |
|
BLAKE2b-256 | 8d0570b8441cc5eb01c6079fe92b8fa880df03a39e169a66e972cdae7fefd1cb |