Metadata-Version: 2.1
Name: PyMapKit
Version: 0.1.2
Summary: A Python based open-source mapping toolkit
Home-page: https://github.com/BenKnisley/PyMapKit
Author: Ben Knisley
Author-email: benknisley@gmail.com
License: MIT
Description: PyMapKit
        ==
        
        PyMapKit is a Python based open-source mapping toolkit.
        It can be used for creating maps, visualizing geospatial data, and developing GIS applications.
        It is built to be modular: so it can be very simple to use, but also to be integrated into complex mapping applications.
        
        ## Basic Usage
        ```python
        ## Import MapEngine Modules
        import PyMapKit
        from PyMapKit import CairoPainter as renderer
        
        ## Create MapEngine object
        m = PyMapKit.MapEngine()
        
        ## Set Map Attributes
        m.set_size(500, 500)
        m.set_location(40.0, -81.0)
        m.set_scale(500)
        
        ## Add tile layer
        tile_layer = TileLayer("https://tileserver.com/tile/{z}/{y}/{x}")
        
        ## Create data layers
        vect_layer = PyMapKit.VectorLayer("./path/to/file.shp")
        rast_layer = PyMapKit.VectorLayer("./path/to/file.tiff")
        
        ## Add layers to Map Object
        m.add_layer(tile_layer)
        m.add_layer(vect_layer)
        m.add_layer(rast_layer)
        
        ## Using PyCairo for rendering
        sf = cairo.ImageSurface(cairo.Format.RGB24, m.width, m.height)
        cr = cairo.Context(surface)
        
        ## Render onto canvas using CairoPainter as renderer
        m.render(renderer, cr)
        
        ## Save output file
        sf.save_png("./map.png")
        ```
        
        ## Installation
        
        ### External Dependencies
        PyMapKit requires two external libraries that require a non Python component installed. You will need to install these on your system before installing PyMapKit. These dependencies are:
        
        * [GDAL/OGR](https://gdal.org/): for loading geospatial data, and warping raster datasets
        * [Cario](https://www.cairographics.org/pycairo/): For drawing operations
        
        #### Linux/Ubuntu:
        ```bash
        sudo apt install python3-gdal python3-cairo
        ```
        
        #### Windows:
        ```bash
        Comming soon
        ```
        
        #### Mac OSx:
        ```bash
        Comming soon
        ```
        
        ### Installing PyMapKit
        To install PyMapKit from PyPI simply run: 
        ```bash
        pip install PyMapKit
        ```
        
        Or to install from the GitHub repo:
        ```bash
        git clone https://github.com/BenKnisley/PyMapKit.git
        pip install -r ./PyMapKit/requirements.txt
        pip install ./PyMapKit
        ```
        
        #### Developer Extras
        If you are contributing to PyMapKit make sure you also install the dev requirements as well.
        ```bash
        pip install -r requirements_dev.txt
        ```
        
Keywords: GIS Geography GeoSpatial MapTiles PyMapKit MapEngine
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
