Install & Compatibility
Where this runs
tested against v0.5.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.6s · import 0.000s · 19MB
17MB installed
● package 17MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
GooglePointFieldWidget
✓ from mapwidgets.widgets import GooglePointFieldWidget
✗ from map_widgets.widgets import GooglePointFieldWidget
Basic setup for Google Maps point widget; replace API key via environment variable.
# settings.py
INSTALLED_APPS = [
'django.contrib.gis',
'map_widgets',
]
MAP_WIDGETS = {
"GooglePointFieldWidget": (
("zoom", 15),
("mapCenterLocation", [40.7128, -74.0060]),
("GooglePlaceAutocompleteOptions", {}),
),
"GoogleMaps": {
"apiKey": os.environ.get('GOOGLE_MAPS_API_KEY', ''),
}
}
# models.py
from django.contrib.gis.db import models
class Location(models.Model):
point = models.PointField()
address = models.CharField(max_length=255)
# admin.py
from django.contrib.gis import admin
from .models import Location
from map_widgets.widgets import GooglePointFieldWidget
class LocationAdmin(admin.GISModelAdmin):
list_display = ('address',)
formfield_overrides = {
models.PointField: {"widget": GooglePointFieldWidget}
}
admin.site.register(Location, LocationAdmin)
Upgrade
Version history
0.5.2latest on PyPI · released Mar 7, 2026
Audit
Dependencies
DjangorequiredGeoDjango dependency; requires django.contrib.gis
django-leafletoptionalFor Leaflet interactive widgets (optional if using Google Maps or MapBox)