django-location-field - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #android #machine-learning #rust #linux #windows #awesome #awesome-list #pytorch #mcp #ios #openai

django-location-field

(★ 570)

Location field and widget for Django. It supports Google Maps, OpenStreetMap and Mapbox

File Explorer

Download Latest Version (.zip)

- - ci.yaml
- - changelog.rst
  - conf.py
  - formfields.rst
  - index.rst
  - install.rst
  - providers.rst
  - releasing.rst
  - settings.rst
  - tutorials.rst
- Makefile
- - __init__.py
  - plain.py
  - spatial.py
- - __init__.py
  - base.py
  - plain.py
  - spatial.py
- __init__.py
- apps.py
- settings.py
- urls.py
- views.py
- widgets.py
- build-package.sh
- copy-js-files-from-node-modules.sh
- __init__.py
- forms.py
- models.py
- spatial_test.py
- test.py
.gitignore
.pre-commit-config.yaml
.readthedocs.yaml
AUTHORS
conftest.py
django-location-field.png
LICENSE
MANIFEST.in
package-lock.json
package.json
pytest.ini
README.md
runtests.py
screenshot.png
setup.cfg
setup.py
tox.ini

# Installation Guide

1. Get the code

git clone https://github.com/caioariede/django-location-field

Downloads the entire project code from GitHub to your computer.

cd django-location-field

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

`pip install django-location-field`

Installs the Python libraries listed in requirements.txt (or similar).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![logo](https://raw.githubusercontent.com/caioariede/django-location-field/master/django-location-field.png)

django-location-field
==

Let users pick locations using a map widget and store its latitude and longitude.

**Documentation:** [https://django-location-field.readthedocs.io/en/latest/](https://django-location-field.readthedocs.io/en/latest/)  
**License:** MIT

Status
--

[![PyPI!](https://img.shields.io/pypi/v/django-location-field)](https://pypi.org/project/django-location-field/)
[![PyPI - Downloads!](https://img.shields.io/pypi/dm/django-location-field?color=blue)](https://pypi.org/project/django-location-field/)
[![Build](https://github.com/caioariede/django-location-field/actions/workflows/ci.yaml/badge.svg)](https://github.com/caioariede/django-location-field/actions/workflows/ci.yaml)
[![Documentation Status](https://readthedocs.org/projects/django-location-field/badge/?version=latest)](https://django-location-field.readthedocs.io/en/latest/?badge=latest)
[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-blue.svg)](https://saythanks.io/to/caioariede)

Tests are performed with Python 2 and 3, Django 1.11 and 2, and SpatiaLite.

Features
--

* Support for multiple map engines, like Google Maps, OpenStreetMap and Mapbox.
* Support for multiple search engines, like Google, Nominatim, Yandex and Addok.
* Works with both Spatial and non-Spatial databases.

Compatibility
--

* Django: 1.11, 2.2, 3.2
* Python 2.7, 3.9, 3.10, 3.11

Spatial Databases
--

* PostGIS
* SpatiaLite

Installation
--

1. Install through pip (or manually place it on your `PYTHONPATH`).

`pip install django-location-field`

2. Add `location_field.apps.DefaultConfig` to `INSTALLED_APPS` your **settings.py** file

For example, PostGIS:

https://docs.djangoproject.com/en/dev/ref/contrib/gis/install/postgis/

Basic usage (using Spatial Database)
--

```python
from django.contrib.gis.db import models
from django.contrib.gis.geos import Point
from location_field.models.spatial import LocationField

class Place(models.Model):
    city = models.CharField(max_length=255)
    location = LocationField(based_fields=['city'], zoom=7, default=Point(1.0, 1.0))
```

Basic usage (without Spatial Database)
--

```python
from django.db import models
from location_field.models.plain import PlainLocationField

class Place(models.Model):
    city = models.CharField(max_length=255)
    location = PlainLocationField(based_fields=['city'], zoom=7)
```

Screenshot
--

![Screenshot](https://github.com/caioariede/django-location-field/raw/master/screenshot.png)

---

[Nick Frost](https://www.iconfinder.com/Gimpopo) has credit over the [image](django-location-field.png) used as logo for this project. [CC BY](https://creativecommons.org/licenses/by/3.0/)