EZ Maps

Generate Beautiful Maps 🗺

Contents

• Installation
• Usage
• Examples
• Troubleshooting
• Contributing
• Author
• License

Installation

• Make sure you have Python installed (Python 3.2+)
• You can install using the command pip3 install ezmaps

Usage

• 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

Examples

All json files for the examples can be found in tests folder

Sydney

Marking all cafes in Sydney

California

Custom Marking Los Angeles and San Francisco in California

Argentina

Shibuya

Marking all hospitals in Shibuya

Troubleshooting

• 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

Contributing

All Contributions welcome Please submit all pull requests the against master branch.

Author

c00kie17

License

MIT