Skip to main content

Plugs 2gis maps for Django admin

Project description

Django 2GIS maps

django_2gis_maps is a simple application that provides the basic hooks into django_2gis_maps V2 api for use in Django models from Django version 1.11+.

Starting with django_2gis_maps version (0.7.0), Django 1.11+ is required because Django changed their widget template rendering system.

I'm using this to allow someone from the admin panels to type a freeform address, have the address geocoded on change and plotted on the map. If the location is not 100% correct, the user can drag the marker to the correct spot and the geo coordinates will update.


alt tag

INSTALLATION

  • pip install git+https://github.com/NursErgesh/django_2gis_maps.git
  • pip install django_2gis_maps

USAGE:

  • include the django_2gis_maps app in your settings.py

  • create a model that has both an address field and geolocation field

    from django.db import models
    from django_2gis_maps import fields as map_fields
    from django_2gis_maps.mixins import DoubleGisMixin
    class Rental(DoubleGisMixin,models.Model):
        address = map_fields.AddressField(max_length=200)
        geolocation = map_fields.GeoLocationField()
    
  • in the admin.py include the following as a formfield_override

    from django.contrib import admin
    from django_2gis_maps.admin import DoubleGisAdmin
    
    class RentalAdmin(DoubleGisAdmin):
        multiple_markers = False        # Here is your option
    
  • in template include {% load doublegis %} and use {% render_map instanse %} wherever you need


That should be all you need to get started.

I also like to make the geolocation field readonly in the admin so a user (myself) doesn't accidentally change it to a nonsensical value. There is validation on the field so you can't enter an incorrect value, but you could enter something that is not even close to the address you intended.

When you're displaying the address back to the user, just request the map using the geocoordinates that were saved in your model. Maybe sometime when I get around to it I'll see if I can create a method that will build that into the model.

Project details


Download files

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

Source Distribution

django_2gis_maps-1.0.3.tar.gz (10.1 kB view details)

Uploaded Source

File details

Details for the file django_2gis_maps-1.0.3.tar.gz.

File metadata

  • Download URL: django_2gis_maps-1.0.3.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.3

File hashes

Hashes for django_2gis_maps-1.0.3.tar.gz
Algorithm Hash digest
SHA256 b67f28b5aa4829fe75dfdf4eee7c88a80ecf0d5bb45a0e7b2a4359d472d73e9b
MD5 300be9638bd1691185a59d495ff8f0a1
BLAKE2b-256 772c6feaa1a0eff4fd862388acf6c78f70e9d1ce9cd7c633d24e6109b151ea13

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page