Show where your business, venue, party, etc. is on Google Maps.

Features

• LocationField to hold a location plus a color marker in the database.
• A template tag to display the map to your users.
• Admin interface to create, edit, and edit the map preview with the map marker.

Installation

Install from here using pip:

pip install -e git+git://github.com/comoga/django-locpick#egg=django-locpick

Quick Setup

With django.contrib.staticfiles (from Django 1.3):

INSTALLED_APPS = (
    ...
    'django.contrib.staticfiles',
    'locpick',
)

STATIC_URL = ... # see staticfiles documentation

Without django.contrib.staticfiles:

INSTALLED_APPS = (
    ...
    'locpick',
)

LOCPICK_STATIC_URL = ... # 'LOCPICK_CHECKOUT_DIR/locpick/static/locpick/'

Usage

Add LocationField to your models.py:

from locpick.field import LocationField

class Place(models.Model)
    ...
    location = LocationField()

To display the map on the frontend, include this javascript code:

<script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=false"></script>

Then, use LocationField.render_map():

{{ place.location.render_map }}

Or use the template tag gmap to display and specify the map's size:

{% load gmap %}
{% gmap place.location WIDTH HEIGHT %}

Additional features

Display an external link (Google Maps) to the map:

<a href="{{ place.location.external_url }}">Map</a>

Configuration

Customize the default configuration in your settings.py:

* `LOCPICK_STATIC_URL` - URL that handles locpick static directory, defaults to STATIC_URL + 'locpick/'.
* `LOCPICK_DEFAULT_MAP_WIDTH` - Default frontend map width, defaults to 200 (rendered by `location.render_map()`)
* `LOCPICK_DEFAULT_MAP_HEIGHT` - Default frontend map height, defaults to 200 (rendered by `location.render_map()`)

Screenshots

The admin's changeform.

A map rendered on the frontend.

Changelog

0.3

• Added Django 1.2 backwards compatibility
• Removed frontend jQuery dependency
• Added this README file
• Added support for multiple maps on one page
• Added example project
• Added LOCPICK_DEFAULT_MAP_WIDTH and LOCPICK_DEFAULT_MAP_HEIGHT settings options
• Added template tag gmap
• Added external_url field property