Skip to main content

Add a Google Map to a template with a simple tag.

Project description

# django-gmapify

Add a Google Map to a template with a simple tag.

Django-gmapify provides an easy way to manage the Google Maps JavaScript API v3 using a simple tag:

{% gmapify "map-canvas" 36.84531718210699 -2.4523544311523438 %}

## Installation

Using `pip`:

$ pip install django-gmapify

Or cloning the project from github:

$ git clone git@javimb/django-gmapify.git
$ cd django-gmapify
$ pip install -r requirements.txt

## Usage

Add `gmapify` to `INSTALLED_APPS`:

INSTALLED_APPS = (
...
'gmapify',
...)

Create a div in the template. The map will fill this div, so it has to have width and heigth:

<div id="map-canvas" style="width:500px;height:500px;"></div>

Load and use the provided `gmapify` tag in the template:

{% load gmapify %}
{% gmapify <html_id> <lat> <lng> [zoom=<zoom>] [map_type=<map_type>] [marker_title=<marker_title>] %}

Django-gmapify provides all the JavaScript stuff for Google Maps API v3, so put the `gmapify` tag at the end of the template.

### Optional args

- **zoom:** The initial resolution at which to display the map, where zoom 0 corresponds to a map of the Earth fully zoomed out, and higher zoom levels zoom in at a higher resolution. 15 by default.
- **map_type:** The initial map type. ROADMAP by default. The following map types are supported:
- **ROADMAP:** displays the normal, default 2D tiles of Google Maps.
- **SATELLITE:** displays photographic tiles.
- **HYBRID:** displays a mix of photographic tiles and a tile layer for prominent features (roads, city names).
- **TERRAIN:** displays physical relief tiles for displaying elevation and water features (mountains, rivers, etc.).
- **marker_title:** The title of the marker. If it's not provided, no marker will be displayed.

##Example

{% load gmapify%}

{% block styles %}
{{ block.super }}
<style type="text/css">
#map {
width: 100%;
height: 500px;
}
</style>
{% endblock style%}

{% block content %}
<div id="map"></div>
{% endblock content%}

{% block js %}
{% gmapify "map" 36.84531718210699 -2.4523544311523438 zoom=18 marker_title="Almeria" %}
{% endblock js %}

Project details


Release history Release notifications | RSS feed

This version

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-gmapify-0.1.tar.gz (3.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page