Skip to main content

A kivy garden mapview demo.

Project description


Github Build Status Build Status Coverage Status PyPI version

Mapview is a Kivy widget for displaying interactive maps. It has been designed with lot of inspirations of Libchamplain and Leaflet.

The goal of this widget is to be a replacement of Google Maps widget, even if this one works very well, it just works on Android with Kivy. I wanted a map widget that can support custom map, and designed with the latests state-of-the-art Kivy's methods.


Marker clustering


  • native multitouch (one for translate, many for translate and zoom)
  • asynchronous downloading
  • avoided GPU limitation / float precisions issues on tiles coordinates
  • marker support
  • blazing fast!
  • supports Z/X/Y providers by default with MapSource
  • supports .mbtiles via MBTilesMapSource
  • supports marker clustering, via ClusteredMarkerLayer


It requires the concurrent.futures and requests. If you use it on Android / iOS, don't forget to add openssl as a requirements, otherwise you'll have an issue when importing urllib3 from requests.


pip install mapview


This widget can be either used within Python or Kv. That's said, not everything can be done in Kv, to prevent too much computing.

from kivy_garden.mapview import MapView
from import App

class MapViewApp(App):
    def build(self):
        mapview = MapView(zoom=11, lat=50.6394, lon=3.057)
        return mapview


Find out more:


Check out our contribution guide and feel free to improve the flower.


This software is released under the terms of the MIT License. Please see the LICENSE.txt file.

How to release

See the garden instructions for how to make a new release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kivy-garden.mapview, version 1.0.5
Filename, size File type Python version Upload date Hashes
Filename, size kivy_garden.mapview-1.0.5-py3-none-any.whl (26.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size kivy_garden.mapview-1.0.5.tar.gz (25.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page