Generate Beautiful Maps ๐บ
- Make sure you have Python installed (Python 3.2+)
- You can install using the command
pip3 install ezmaps
-
This is a CLI app so you can run it using
ezmaps
in your command line -
ezmaps takes a few arguments
* -c , --config Path to your config file * -s , --save If you save the state of this run * -l , --load Load an old state (pickle file) to avoid makes calls to the API
-
The config file is in the
json
format and has the following information
{
"details":{
"place": "Sydney"
"level":7,
"background": [0,0,0],
"color":[255,255,255],
"size":[2500,1800],
"detail":6
},
"markers": [{
"locations": ["police"],
"icon": "police.png",
"size": 30
}]
}
key | type | description |
---|---|---|
[details],[place] |
string |
The name of the place you want to generate the map for |
[details][level] |
integer |
Administrative level for the place you can find the level for your place here |
[details][background] |
list or integer |
RGB value of the color you want or -1 -Transparent |
[details][color] |
list |
RGB values for the color you want the map to be drawn in |
[details][size] |
list or integer |
width and height of the output image (The actual image will be resized to this value). If just an integer is provided it returns the natural scale of the map with the integer as the max height or width value allowed |
[details][detail] |
list |
How many level of roads do you want in your image higher the number the lower the level of roads fetched |
[markers] |
list |
A list of markers you want marked on your image |
[markers][locations] |
list or string |
A list of longitude or latitude for custom markers or a string specifying a type of important location |
[markers][icon] |
string |
Path to the icon you want the mark the marker with will search in folder icon in the location where the config file is located |
[markers][size] |
integer |
Size of the icon in the final image in pixles |
All json
files for the examples can be found in tests
folder
Custom Marking Los Angeles
and San Francisco
in California
Marking all hospitals
in Shibuya
- All this data is obtained from Overpass which is rate-limited so to avoid getting stuck in the rate-limit try saving and loading states as much as possible
- If you find any bug or error please create an Issue on this repository
All Contributions welcome Please submit all pull requests the against master branch.