https://github.com/kivy-garden/garden.mapview

Migrated to https://github.com/kivy-garden/mapview
https://github.com/kivy-garden/garden.mapview

Last synced: 3 months ago
JSON representation

Migrated to https://github.com/kivy-garden/mapview

• Host: GitHub
• URL: https://github.com/kivy-garden/garden.mapview
• Owner: kivy-garden
• License: mit
• Archived: true
• Created: 2014-08-17T17:18:19.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2020-04-18T22:47:28.000Z (over 4 years ago)
• Last Synced: 2024-05-15T04:37:03.605Z (6 months ago)
• Language: Python
• Homepage: https://github.com/kivy-garden/mapview
• Size: 1.31 MB
• Stars: 109
• Watchers: 31
• Forks: 55
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Mapview

[![Build Status](https://travis-ci.com/kivy-garden/garden.mapview.svg?branch=master)](https://travis-ci.com/kivy-garden/garden.mapview)

Mapview is a Kivy widget for displaying interactive maps. It has been

designed with lot of inspirations of

[Libchamplain](https://wiki.gnome.org/Projects/libchamplain) and

[Leaflet](http://leafletjs.com/).

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.

![ScreenShot](https://cloud.githubusercontent.com/assets/37904/22764226/925c93ce-ee69-11e6-90ed-88123bfa731f.png)

![Marker clustering](https://cloud.githubusercontent.com/assets/37904/22764225/92516f12-ee69-11e6-99d5-6346e302766d.png)

# Features

* 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](http://mbtiles.org) via `MBTilesMapSource`

* supports marker clustering, via `ClusteredMarkerLayer`

# Requirements

It requires the `concurrent.futures` and `requests`. If you are on python 2.7,

you can use `futures`:

```

pip install futures 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`.

# Install

Install the mapview garden module using the `garden` tool:

```

garden install mapview

```

# Usage

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.

```python

from kivy.garden.mapview import MapView

from kivy.app import App

class MapViewApp(App):

    def build(self):

        mapview = MapView(zoom=11, lat=50.6394, lon=3.057)

        return mapview

MapViewApp().run()

```

More extensive documentation will come soon.