diff options
Diffstat (limited to 'webapp/django/contrib/gis/maps/google/__init__.py')
-rw-r--r-- | webapp/django/contrib/gis/maps/google/__init__.py | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/webapp/django/contrib/gis/maps/google/__init__.py b/webapp/django/contrib/gis/maps/google/__init__.py new file mode 100644 index 0000000000..dfbbedc3d6 --- /dev/null +++ b/webapp/django/contrib/gis/maps/google/__init__.py @@ -0,0 +1,61 @@ +""" + This module houses the GoogleMap object, used for generating + the needed javascript to embed Google Maps in a webpage. + + Google(R) is a registered trademark of Google, Inc. of Mountain View, California. + + Example: + + * In the view: + return render_to_response('template.html', {'google' : GoogleMap(key="abcdefg")}) + + * In the template: + + <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + {{ google.xhtml }} + <head> + <title>Google Maps via GeoDjango</title> + {{ google.style }} + {{ google.scripts }} + </head> + {{ google.body }} + <div id="{{ google.dom_id }}" style="width:600px;height:400px;"></div> + </body> + </html> + + Note: If you want to be more explicit in your templates, the following are + equivalent: + {{ google.body }} => "<body {{ google.onload }} {{ google.onunload }}>" + {{ google.xhtml }} => "<html xmlns="http://www.w3.org/1999/xhtml" {{ google.xmlns }}>" + {{ google.style }} => "<style>{{ google.vml_css }}</style>" + + Explanation: + - The `xhtml` property provides the correct XML namespace needed for + Google Maps to operate in IE using XHTML. Google Maps on IE uses + VML to draw polylines. Returns, by default: + <html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml"> + + - The `style` property provides the correct style tag for the CSS + properties required by Google Maps on IE: + <style type="text/css">v\:* {behavior:url(#default#VML);}</style> + + - The `scripts` property provides the necessary <script> tags for + including the Google Maps javascript, as well as including the + generated javascript. + + - The `body` property provides the correct attributes for the + body tag to load the generated javascript. By default, returns: + <body onload="gmap_load()" onunload="GUnload()"> + + - The `dom_id` property returns the DOM id for the map. Defaults to "map". + + The following attributes may be set or customized in your local settings: + * GOOGLE_MAPS_API_KEY: String of your Google Maps API key. These are tied to + to a domain. May be obtained from http://www.google.com/apis/maps/ + * GOOGLE_MAPS_API_VERSION (optional): Defaults to using "2.x" + * GOOGLE_MAPS_URL (optional): Must have a substitution ('%s') for the API + version. +""" +from django.contrib.gis.maps.google.gmap import GoogleMap +from django.contrib.gis.maps.google.overlays import GEvent, GMarker, GPolygon, GPolyline +from django.contrib.gis.maps.google.zoom import GoogleZoom |