PageRenderTime 112ms CodeModel.GetById 96ms RepoModel.GetById 0ms app.codeStats 0ms

/django/contrib/gis/maps/google/__init__.py

https://code.google.com/p/mango-py/
Python | 61 lines | 52 code | 0 blank | 9 comment | 0 complexity | ca5bcfc884a1825e800bdfd9d3b81645 MD5 | raw file
Possible License(s): BSD-3-Clause 
    

  1. """
    2. 

  2.   This module houses the GoogleMap object, used for generating
    3. 

  3.    the needed javascript to embed Google Maps in a Web page.
    4. 

  4. 

  5.   Google(R) is a registered trademark of Google, Inc. of Mountain View, California.
    6. 

  6. 

  7.   Example:
    8. 

  8. 

  9.    * In the view:
    10. 

  10.       return render_to_response('template.html', {'google' : GoogleMap(key="abcdefg")})
    11. 

  11. 

  12.    * In the template:
    13. 

  13. 

  14.      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    15. 

  15.      {{ google.xhtml }}
    16. 

  16.      <head>
    17. 

  17.        <title>Google Maps via GeoDjango</title>
    18. 

  18.        {{ google.style }}
    19. 

  19.        {{ google.scripts }}
    20. 

  20.      </head>
    21. 

  21.      {{ google.body }}
    22. 

  22.      <div id="{{ google.dom_id }}" style="width:600px;height:400px;"></div>
    23. 

  23.      </body>
    24. 

  24.      </html>
    25. 

  25. 

  26.      Note:  If you want to be more explicit in your templates, the following are
    27. 

  27.       equivalent:
    28. 

  28.       {{ google.body }} => "<body {{ google.onload }} {{ google.onunload }}>"
    29. 

  29.       {{ google.xhtml }} => "<html xmlns="http://www.w3.org/1999/xhtml" {{ google.xmlns }}>"
    30. 

  30.       {{ google.style }} => "<style>{{ google.vml_css }}</style>"
    31. 

  31. 

  32.   Explanation:
    33. 

  33.    - The `xhtml` property provides the correct XML namespace needed for 
    34. 

  34.      Google Maps to operate in IE using XHTML.  Google Maps on IE uses
    35. 

  35.      VML to draw polylines.  Returns, by default: 
    36. 

  36.      <html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">
    37. 

  37.        
    38. 

  38.    - The `style` property provides the correct style tag for the CSS
    39. 

  39.      properties required by Google Maps on IE:
    40. 

  40.      <style type="text/css">v\:* {behavior:url(#default#VML);}</style>
    41. 

  41. 

  42.    - The `scripts` property provides the necessary <script> tags for 
    43. 

  43.      including the Google Maps javascript, as well as including the
    44. 

  44.      generated javascript.
    45. 

  45. 

  46.    - The `body` property provides the correct attributes for the 
    47. 

  47.      body tag to load the generated javascript.  By default, returns:
    48. 

  48.      <body onload="gmap_load()" onunload="GUnload()">
    49. 

  49. 

  50.    - The `dom_id` property returns the DOM id for the map.  Defaults to "map".
    51. 

  51. 

  52.   The following attributes may be set or customized in your local settings:
    53. 

  53.    * GOOGLE_MAPS_API_KEY: String of your Google Maps API key.  These are tied to
    54. 

  54.       to a domain.  May be obtained from http://www.google.com/apis/maps/
    55. 

  55.    * GOOGLE_MAPS_API_VERSION (optional): Defaults to using "2.x"
    56. 

  56.    * GOOGLE_MAPS_URL (optional): Must have a substitution ('%s') for the API
    57. 

  57.       version.
    58. 

  58. """
    59. 

  59. from django.contrib.gis.maps.google.gmap import GoogleMap, GoogleMapSet
    60. 

  60. from django.contrib.gis.maps.google.overlays import GEvent, GIcon, GMarker, GPolygon, GPolyline
    61. 

  61. from django.contrib.gis.maps.google.zoom import GoogleZoom
    62. 

  62.