daweedm / django-places

A django app for store places with autocomplete

django-places

A Django app for store places with autocomplete function and a related map to the selected place.

Quickstart

---

Install dj-places and add it to your installed apps:

$ pip install dj-places

    INSTALLED_APPS = (
    	...
    	'places',
    	...
    )

Add the following settings and maps api key (read more here):

PLACES_MAPS_API_KEY='YourAwesomeUltraSecretKey'
PLACES_MAP_WIDGET_HEIGHT=480
PLACES_MAP_OPTIONS='{"center": { "lat": 38.971584, "lng": -95.235072 }, "zoom": 10}'
PLACES_MARKER_OPTIONS='{"draggable": true}'

Usage

---

Then use it in a project:

from django.db import models
from places.fields import PlacesField


class MyLocationModel(models.Model):
    location = PlacesField()

This enables the following API:

    >>> from myapp.models import ModelName
    >>> poi = ModelName.objects.get(id=1)
    >>> poi.position
    Place('Metrocentro, Managua, Nicaragua', 52.522906, 13.41156)
    >>> poi.position.place
    'Metrocentro, Managua, Nicaragua'
    >>> poi.position.latitude
    52.522906
    >>> poi.position.longitude
    13.41156

For using outside the Django Admin:

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <input type="submit" value="Save">
    {{ form.media }}
</form>

Remember to add the {{ form.media }} in your template.

Demo

---

Credits

---

Tools used in rendering this package:

• Cookiecutter
• cookiecutter-djangopackage
• jquery-geocomplete (no longer used in the project.)

Similar Projects

---

• Django Location Field
• Django GeoPosition