A django app for store places using Google Maps API
Project description
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
Changelog
Unreleased
Implemented enhancements:
Closed issues:
- Deprecated Field._get_val_from_obj() #25
v3.1.0 (2018-10-30)
Implemented enhancements:
Fixed bugs:
- Empty Map in admin #16
v3.0.0 (2018-10-29)
Implemented enhancements:
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)
Implemented enhancements:
Fixed bugs:
- Django 1.11 not render widget #9
v1.1.4 (2017-05-08)
Fixed bugs:
- undefined name Location #10
v1.1.3 (2017-05-07)
Fixed bugs:
v1.1.2 (2017-05-07)
v1.1.1 (2017-01-22)
v1.1.0 (2017-01-09)
v1.0.5 (2016-07-26)
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)
v1.0.3 (2016-06-01)
v1.0.2 (2016-05-12)
v1.0.1 (2016-05-12)
Fixed bugs:
- Geocomplete is not a function #1
Merged pull requests:
v1.0.0 (2016-04-28)
* This Changelog was automatically generated by github_changelog_generator
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.