django-geoposition 0.3.0

Prerequisites

Starting with version 0.3, django-geoposition requires Django 1.8 or greater. If you need to support Django versions prior to 1.8 please use django-geoposition 0.2.3. For Django versions prior to 1.4.10 please use django-geoposition 0.1.5.

Installation

• Use your favorite Python packaging tool to install geoposition from PyPI, e.g.:

  pip install django-geoposition

• Add "geoposition" to your INSTALLED_APPS setting:

  INSTALLED_APPS = (
      # …
      "geoposition",
  )

• Set your Google API key in you settings file:

  GEOPOSITION_GOOGLE_MAPS_API_KEY = 'YOUR_API_KEY'

  API keys may be obtained here: https://developers.google.com/maps/documentation/javascript/get-api-key

• If you are still using Django <1.3, you are advised to install django-staticfiles for static file serving.

Usage

django-geoposition comes with a model field that makes it pretty easy to add a geoposition field to one of your models. To make use of it:

• In your myapp/models.py:

  from django.db import models
  from geoposition.fields import GeopositionField
  
  class PointOfInterest(models.Model):
      name = models.CharField(max_length=100)
      position = GeopositionField()

• This enables the following simple API:

  >>> from myapp.models import PointOfInterest
  >>> poi = PointOfInterest.objects.get(id=1)
  >>> poi.position
  Geoposition(52.522906,13.41156)
  >>> poi.position.latitude
  52.522906
  >>> poi.position.longitude
  13.41156

Form field and widget

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.8/jquery.min.js"></script>
<form method="POST" action="">{% csrf_token %}
    {{ form.media }}
    {{ form.as_p }}
</form>

Settings

You can customize the MapOptions and MarkerOptions used to initialize the map and marker in JavaScript by defining GEOPOSITION_MAP_OPTIONS or GEOPOSITION_MARKER_OPTIONS in your settings.py.

Example:

GEOPOSITION_MAP_OPTIONS = {
    'minZoom': 3,
    'maxZoom': 15,
}

GEOPOSITION_MARKER_OPTIONS = {
    'cursor': 'move'
}

Please note that you cannot use a value like new google.maps.LatLng(52.5,13.4) for a setting like center or position because that would end up as a string in the JavaScript code and not be evaluated. Please use Lat/Lng Object Literals for that purpose, e.g. {'lat': 52.5, 'lng': 13.4}.

You can also customize the height of the displayed map widget by setting GEOPOSITION_MAP_WIDGET_HEIGHT to an integer value (default is 480).

License

MIT