Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/silentsokolov/django-treasuremap
django-treasuremap app, makes it easy to store and display the location on the map using different providers (Google, Yandex).
https://github.com/silentsokolov/django-treasuremap
django google-maps location python yandex-maps
Last synced: 6 days ago
JSON representation
django-treasuremap app, makes it easy to store and display the location on the map using different providers (Google, Yandex).
- Host: GitHub
- URL: https://github.com/silentsokolov/django-treasuremap
- Owner: silentsokolov
- License: mit
- Created: 2015-01-05T15:42:27.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-06-19T17:07:12.000Z (over 1 year ago)
- Last Synced: 2024-10-28T05:56:49.961Z (18 days ago)
- Topics: django, google-maps, location, python, yandex-maps
- Language: Python
- Homepage:
- Size: 492 KB
- Stars: 24
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
.. image:: https://github.com/silentsokolov/django-treasuremap/workflows/build/badge.svg?branch=master
:target: https://github.com/silentsokolov/django-treasuremap/actions?query=workflow%3Abuild+branch%3Amaster
.. image:: https://codecov.io/gh/silentsokolov/django-treasuremap/branch/master/graph/badge.svg
:target: https://codecov.io/gh/silentsokolov/django-treasuremap
django-treasuremap
==================
django-treasuremap app, makes it easy to store and display the location on the map using different providers (Google, Yandex, etc).
Requirements
------------
* Python 2.7+ or Python 3.4+
* Django 1.11+
Installation
------------
Use your favorite Python package manager to install the app from PyPI, e.g.
Example:
``pip install django-treasuremap``
Add ``treasuremap`` to ``INSTALLED_APPS``:
Example:
.. code:: python
INSTALLED_APPS = (
...
'treasuremap',
...
)
Configuration
-------------
Within your ``settings.py``, you’ll need to add a setting (which backend to use, etc).
Example:
.. code:: python
TREASURE_MAP = {
'BACKEND': 'treasuremap.backends.google.GoogleMapBackend',
'API_KEY': 'Your API key',
'SIZE': (400, 600),
'MAP_OPTIONS': {
'zoom': 5
}
}
Example usage
-------------
In models
~~~~~~~~~
.. code:: python
from django.db import models
from treasuremap.fields import LatLongField
class Post(models.Model):
name = models.CharField(max_length=100)
point = LatLongField(blank=True)
In admin
~~~~~~~~~
.. code:: python
from django.contrib import admin
from treasuremap.widgets import AdminMapWidget
from .models import Post
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
def formfield_for_dbfield(self, db_field, **kwargs):
if db_field.name == 'point':
kwargs['widget'] = AdminMapWidget()
return super(PostAdmin,self).formfield_for_dbfield(db_field,**kwargs)
In forms
~~~~~~~~
.. code:: python
from django import forms
from treasuremap.forms import LatLongField
class PostForm(models.Model):
point = LatLongField()
.. code:: html
...
...
{{ form.media }}
{% csrf_token %}
{{ form.as_p }}
Depending on what backend you are using, the correct widget will be displayed
with a marker at the currently position (jQuery is required).
.. image:: https://raw.githubusercontent.com/silentsokolov/django-treasuremap/master/docs/images/screenshot.png
Settings
--------
Support map:
~~~~~~~~~~~~
- Google map ``treasuremap.backends.google.GoogleMapBackend``
- Yandex map ``treasuremap.backends.yandex.YandexMapBackend``
Other settings:
~~~~~~~~~~~~~~~
- ``API_KEY`` - if need, default ``None``
- ``SIZE`` - tuple with the size of the map, default ``(400, 400)``
- ``ADMIN_SIZE`` - tuple with the size of the map on the admin panel, default ``(400, 400)``
- ``ONLY_MAP`` - hide field lat/long, default ``True``
- ``MAP_OPTIONS`` - dict, used to initialize the map, default ``{'latitude': 51.562519, 'longitude': -1.603156, 'zoom': 5}``. ``latitude`` and ``longitude`` is required, do not use other "LatLong Object".