dj-places 5.0.0

A django app for store places using Google Maps API

django-places

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

Badges

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}'

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

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements_test.txt
(myenv) $ python runtests.py

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

Changelog

Unreleased

Full Changelog

Implemented enhancements:

• Update fields.py for Django 3.0 #24 (dryan)

Closed issues:

• Deprecated Field._get_val_from_obj() #25

v3.1.0 (2018-10-30)

Full Changelog

Implemented enhancements:

• Support marker options and set marker as draggable #22 (oscarmcm)

Fixed bugs:

• Empty Map in admin #16

v3.0.0 (2018-10-29)

Full Changelog

Implemented enhancements:

• Load map-options settings #21 (oscarmcm)
• Add support for inline admin #20 (oscarmcm)

Fixed bugs:

• Multiple PlacesField() Objects declaration in one Model clones data from one Object to the other. #14
• Remove jquery geocomplete #19 (oscarmcm)

v2.0.0 (2017-09-10)

Full Changelog

Implemented enhancements:

• Update for django 1.11 #12 (pavillet)

Fixed bugs:

• Django 1.11 not render widget #9

v1.1.4 (2017-05-08)

Full Changelog

Fixed bugs:

• undefined name Location #10

v1.1.3 (2017-05-07)

Full Changelog

Fixed bugs:

• Kwargs problem #8
• Problems with djplaces #6
• i18n support #3

v1.1.2 (2017-05-07)

Full Changelog

v1.1.1 (2017-01-22)

Full Changelog

v1.1.0 (2017-01-09)

Full Changelog

v1.0.5 (2016-07-26)

Full Changelog

Implemented enhancements:

• Add own jquery to avoid conflicts and be able to used in admin and templates #5 (darwing1210)

v1.0.4 (2016-07-20)

Full Changelog

v1.0.3 (2016-06-01)

Full Changelog

v1.0.2 (2016-05-12)

Full Changelog

v1.0.1 (2016-05-12)

Full Changelog

Fixed bugs:

• Geocomplete is not a function #1

Merged pull requests:

• Fixes #1 Geocomplete is not a function #2 (oscarmcm)

v1.0.0 (2016-04-28)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator