django-google-maps 0.14.0

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

  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

  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

  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

  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.