Widget:Google Maps

From The Sims Wiki, a collaborative database for The Sims series
Jump to navigation Jump to search

This widget allows you to add Google Maps widget to your wiki page.

Created by Sergey Chernyshev

Using this widget[edit source]

Note: Google now requires users to provide an API key. This widget does not yet? cater for this.


This widget allows you to add Google Maps widget to your wiki page.

Created by Sergey Chernyshev

Parameters[edit source]

  • height and width define map dimensions, 420x350 is default
  • lat - map center latitude
  • lng - map center longitude
  • maptype - type of the map, roadmap (default), satellite, hybrid
  • zoom - zoom level (defaults to 16)
  • xml - URL of XML (KML/GeoRSS) data source (only one can be used for now) *
  • Markers:
    • centermarker - if set, then marker is added in the center of the map
    • Custom markers are defined using marker.name.lat, marker.name.lng, additional parameters can be set to customize a marker:
      • marker.name.title - title (only works on JavaScript-powered maps)
      • marker.name.letter - letter icon (capital A-Z, only works on JavaScript-powered maps)
      • marker.name.icon - URL for the custom icon, 20x34px (only works on JavaScript-powered maps)
  • Controls *:
    • maptypecontrol - buttons that let the user toggle between map types (such as Map and Satellite)
    • largemapcontrol - displays a large pan/zoom control used on Google Maps
    • smallmapcontrol - displays a smaller pan/zoom control used on Google Maps
    • smallzoomcontrol - displays a small zoom control (no panning controls) used in the small map blowup windows used to display driving directions steps on Google Maps
    • scalecontrol - displays a map scale
    • overviewmapcontrol - displays a collapsible overview map in the corner of the screen
    • hierarchicalmaptypecontrol - displays a selection of nested buttons and menu items for placing many map type selectors

Map types[edit source]

By default, map is displayed using dynamic user interface with movable map, controls, loadable XML and so on.

If you want static map image to be displayed, add static=yes which will tell widget to use Google Static Maps API. It does not support XML (KML or GeoRSS) and controls, but supports markers. Use this one when you want map to load faster and to avoid JavaScript slowing down your page. Static map is also used for graceful degradation when dynamic map is specified, but client doesn't support dynamic features like JavaScript.

Bookmarklet[edit source]

Sometimes it's hard to get all the parameters you need for a map to display - coming up with longitude and latitude, correct zoom levels and so on might take too much time.

To help with this problem, we created a bookmarklet that you can use on Google Maps site to grab map widget code for current location with just one click.

javascript:void((function(){var%20s=null;var%20u=['http://yui.yahooapis.com/2.7.0/build/yuiloader/yuiloader-min.js','https://www.mediawikiwidgets.org/bookmarklets/maps/v3/bookmarklet-min.js'];for(var%20i=0;i<u.length;i++){if(document.getElementById('bklet_'+i)){YAHOO.b.b();return;}else{s=document.createElement('script');s.type='text/javascript';s.id='bklet_'+i;s.src=u[i];document.getElementsByTagName('head')[0].appendChild(s);}}})());

Copy to your site[edit source]

To use this widget on your site, just install MediaWiki Widgets extension and copy the full source code of this page to your wiki as page Widget:Google Maps.