# Integrate Mergin Maps
# Python client module
The Python client module is the easiest way to programmatically use Mergin Maps. You can use Python API or a command-line tool to easily work with Mergin Maps projects, such as to get project status, push and pull changes, or to download, create and delete projects.
The MerginMaps/mergin-py-client (opens new window) repository contains the source code of the Python client module and more information on how to use it.
Python client is available in the PyPI repository and can be installed with
pip3 install mergin-client
# Python module
To use Mergin Maps from Python, just create
MerginClient object and then use it. Here, for instance, to download a project:
import mergin client = mergin.MerginClient(login='john', password='topsecret') client.download_project('lutraconsulting/Basic survey', '/tmp/basic-survey')
If you have Mergin Maps plugin for QGIS installed and you want to use it from the QGIS' Python console
import Mergin.mergin as mergin client = mergin.MerginClient(login='john', password='topsecret')
# Python command line interface
For those who prefer using terminal, there is
mergin command line tool shipped with the Python client. With several built-in commands, it is possible to download Mergin Maps projects, push/pull changes, create or delete projects and more.
For example, to download a Mergin Maps project to a local folder:
mergin download john/project1 ~/mergin/project1
For more details, visit MerginMaps/mergin-py-client (opens new window).
# C++ standalone client
C++ Client has advantage over Python that it is completely without any dependencies.
To install the C++ client, just download the binary for your platform from MerginMaps/mergin-cpp-client/releases (opens new window) and use it from the command line.
Go to MerginMaps/mergin-cpp-client (opens new window) repository for more information on how to use it.
# C++ Command line tool
When the client is installed, it comes with
mergin command line tool.
$ mergin --help Usage: mergin [OPTIONS] COMMAND [ARGS]... Options: --help Show this message and exit. --version Show the version information. --username Mergin username (or MERGIN_USERNAME env. variable) --password Mergin password (or MERGIN_PASSWORD env. variable) --url Mergin url (defaults to app.merginmaps.com) Commands: create Create a new project on Mergin server download Download last version of mergin project sync Pull&Push the changes remove Remove project from server.
# C++ Mergin Maps API core library
Client is based on the Qt-based mergin maps api core library (opens new window) used by the Mergin Maps Input to sync the projects in the mobile application.