Metadata-Version: 1.1
Name: django-google-maps
Version: 0.12.4
Summary: Plugs google maps V3 api into Django admin.
Home-page: https://github.com/madisona/django-google-maps
Author: Aaron Madison
Author-email: aaron.l.madison@gmail.com
License: UNKNOWN
Description: ``django-google-maps`` is a simple application that provides the basic
        hooks into google maps V3 api for use in Django models from Django
        version 1.11+.
        
        Starting with ``django-google-maps`` version (0.7.0), Django 1.11+ is
        required because Django changed their widget template rendering system.
        Version 0.8.0 supports Django 2.0+, and as such removes support for
        Python 2.7
        
        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.
        
        Status
        ~~~~~~
        
        |Build Status|
        
        USAGE:
        ------
        
        -  include the ``django_google_maps`` app in your ``settings.py``
        
        -  Add your Google Maps API Key in your ``settings.py`` as
           ``GOOGLE_MAPS_API_KEY``
        
        -  create a model that has both an address field and geolocation field
        
           .. code:: python
        
              from django.db import models
              from django_google_maps import fields as map_fields
        
              class Rental(models.Model):
                  address = map_fields.AddressField(max_length=200)
                  geolocation = map_fields.GeoLocationField(max_length=100)
        
        -  in the ``admin.py`` include the following as a formfield_override
        
           .. code:: python
        
              from django.contrib import admin
              from django_google_maps import widgets as map_widgets
              from django_google_maps import fields as map_fields
        
              class RentalAdmin(admin.ModelAdmin):
                  formfield_overrides = {
                      map_fields.AddressField: {'widget': map_widgets.GoogleMapsAddressWidget},
                  }
        
        -  To change the map type (``hybrid`` by default), you can add an html
           attribute on the ``AddressField`` widget. The list of allowed values
           is: ``hybrid``, ``roadmap``, ``satellite``, ``terrain``
        
           .. code:: python
        
              from django.contrib import admin
              from django_google_maps import widgets as map_widgets
              from django_google_maps import fields as map_fields
        
              class RentalAdmin(admin.ModelAdmin):
                  formfield_overrides = {
                      map_fields.AddressField: {
                        'widget': map_widgets.GoogleMapsAddressWidget(attrs={'data-map-type': 'roadmap'})},
                  }
        
        -  To change the autocomplete options, you can add an html attribute on
           the ``AddressField`` widget. See
           https://developers.google.com/maps/documentation/javascript/places-autocomplete#add_autocomplete
           for a list of available options
        
           .. code:: python
        
              import json from django.contrib import admin
              from django_google_maps import widgets as map_widgets
              from django_google_maps import fields as map_fields
        
              class RentalAdmin(admin.ModelAdmin): formfield_overrides = {
                  map_fields.AddressField: { ‘widget’:
                  map_widgets.GoogleMapsAddressWidget(attrs={
                    ‘data-autocomplete-options’: json.dumps({ ‘types’: [‘geocode’,
                    ‘establishment’], ‘componentRestrictions’: {
                                'country': 'us'
                            }
                        })
                    })
                  },
              }
        
        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.
        
        .. |Build Status| image:: https://travis-ci.org/madisona/django-google-maps.png
           :target: https://travis-ci.org/madisona/django-google-maps
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
