Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kivy-garden/mapview
Mapview is a Kivy widget for displaying interactive maps.
https://github.com/kivy-garden/mapview
Last synced: about 13 hours ago
JSON representation
Mapview is a Kivy widget for displaying interactive maps.
- Host: GitHub
- URL: https://github.com/kivy-garden/mapview
- Owner: kivy-garden
- License: mit
- Created: 2020-04-18T22:14:00.000Z (over 4 years ago)
- Default Branch: develop
- Last Pushed: 2023-01-08T12:19:04.000Z (almost 2 years ago)
- Last Synced: 2024-08-10T10:19:57.111Z (5 months ago)
- Language: Python
- Homepage: https://kivy-garden.github.io/mapview/
- Size: 4.14 MB
- Stars: 87
- Watchers: 14
- Forks: 28
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Mapview
[](https://github.com/kivy-garden/mapview/actions?query=workflow%3ATests)
[](https://travis-ci.com/kivy-garden/mapview)
[](https://coveralls.io/github/kivy-garden/mapview?branch=develop)
[](https://badge.fury.io/py/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.
# 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 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
```
pip 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()
```
Find out more:
- [examples/](https://github.com/kivy-garden/mapview/tree/master/examples)
-
Contributing
--------------
Check out our [contribution guide](CONTRIBUTING.md) and feel free to improve the flower.
License
---------
This software is released under the terms of the MIT License.
Please see the [LICENSE.txt](LICENSE.txt) file.
How to release
===============
See the garden [instructions](https://kivy-garden.github.io/#makingareleaseforyourflower) for how to make a new release.