Publish by QGIS

QGIS (until 2013 known as Quantum GIS) is a free and open-source cross-platform desktop geographic information system (GIS) application that supports viewing, editing, and analysis of geospatial data.

This plugin is part of QGIS software that can be downloaded at official site.

1)How to share maps online

List of video topics:

    Parameter details:

    • Zoom levels: Determine the maximum scale.
      * For each increased zoom/"detail level" the publication time doubles.
      * The zoom level 9 is recommended for most cases, depends on how much details the map has [1].
    • Repository Name: Define the name of the repository to store the map files.
    • Git client: The git parameter must be the path of the git executable. If not defined the plugin will download it automatically (windows only for now). The git client can be downloaded at
    • Upload maps for further download: The Github allows to upload binary files, but these files are limited to 2GB. We generate a Zip for all map associated files and upload this zip to the release section on the GitHub repository.
    • Username:: To use this service you need to create a account at GitHub and use this account for Mappia QGIS plugin.

    2)Customize yourself a map project

    Get link of published maps

    The maps you want to publish can be shared through a link or embed at websites like we embedded on the AMAZONES project. You can customize all aspects: layout, maps information, legends and even create interesting interactions. Mappia is fully documented with working examples.
    All the platforms created in Mappia have an editor mode, and can be accessed by replacing the '/calculator/' by '/editor/' in platform url.

    Share the project using internal link or embed into a website:

    After finalizing publication, the 'Mappia Publisher' (QGIS plugin) generate and opens a browser window with a link. To share the link is simple to display your own interactive Mappia platform using the provided data.
    To embed Mappia customizaed platform at a website you just need to copy and paste the following HTML code, copy paste this HTML code, just replace the 'src' url to the customized platform (HTML code):
    <iframe src="// width="100%" height="600"></iframe>

    Edit any platform:

    Just edit or view a platform code just change the link url from '/calculator/' to '/editor/'. For example:
    The platform :
    can be Edited: .
    This project is focused on colaborative work, and was design to grant easy access and map sharing for all the comunity.
    Take a look into our complete documentation customization and combine maps from WMS/WMT/GitHub Repository, with no additional limitations.

    3)How the platform works

    Example of a platform created in QGIS

    The below example link is: and the data is stored on github:

    How the publication works?

    This service is composed of three main components: QGIS for Map rendering, GitHub for File Storage and Mappia for integration and display results.

    QGIS for Map rendering:

    This step consists mainly of generating tiles (tiles are graphical representation of a small part of the map) for online displaying through a range of zoom levels. At each given position and scale, one tile is displayed, and all tiles put together create the visualization of the map. The style of the map is the same of that of QGIS, so you can define the map style in QGIS and view it online.
    The plugin developped in QGIS will generate the tiles and upload it to GitHub.

    GitHub for File Storage:

    This step is mainly about authenticating the file storage. The GitHub is a free online repository used to store the map tiles, metadata, legends and any other information about the maps.
    To communicate with the GitHub site a 'Git client' is mandatory and is automatically downloaded if not found, the client consists of a program that implements the protocol of message exchange at their server (the official Git executable can be found at The repository is a place where all the data is stored, it is identified by a combination of a 'Repository name' and an 'Username'. The repository can be accessed replacing the uppercase words in link for their respective values.
    The data stored in GitHub are fully under the control of the account owner, the Mappia has no control of it. You can publish, delete, edit data on your own without Mappia interference.

    Mappia for integration and results display:

    Mappia offers a free service to display maps oonline (like WMS or WTS) along with customization advantages. Mappia integrates the QGIS generated tiles stored at GitHub. Mappia allows map customization by using a user-friendly interface or directly developing by javascript code. It is very useful for educational purposes, collaborative mapping, maps sharing or any other projects.
    Mappia identifies all maps at GitHub repositories and allows the user to display them in many customized ways using various predefined elements and interactions described at To display the maps Mappia platform just loads the map tiles and squares them at the right geographic position directly from the GitHub. This allows it to work even without a private server.
    The user can even share his source maps (Github has a 2GB Map limit size), this is controlled by parameter 'Upload maps', and the others users can easily download directly from the Mappia platform.

    4)Mappia Publisher usage FAQ

    Frequently asked questions.

    • How the plugin works?
      View on this tutorial How the publication works?
    • What is the map size limit?
      The maximum size is 2Gb. This is limited by the GitHub documentation.
    • I keep the control of my file maps?
      Of course, you can upload, delete and edit maps. Mappia just displays them from repository
    • How much costs?
      Mappia is free of charge!
    • There are plugins for others softwares?
      Soon, for Dinamica EGO but not yet.
    • What are the legal responsabilities?
      We offer the service, the usage and the data delivered through is of the entire responsability of each user.
    • How do you profit?
      We just want to disseminate our knowledge, ( and research results.