News Examples Documentation Download Buy Forum Contact

Google Maps Plugin googlemaps.swf Version 1.0.8.15


Note - there is the new Bing Maps Plugin as replacement for the Google Maps Plugin!


  • The Google Maps Plugin adds an interactive Google Map to the viewer.
  • The map can be freely placed and sized anywhere on the screen.
  • It's possible to place spots on the map and link them to krpano actions like loadpano to load a new panoramas when clicking a spot.
  • The plugin has an integrated customizable radar which can apear on the activatted spot.
  • The standard Google Maps controls, like the position and zoom controls can be also added.
  • The map can be rotated / viewed in a 3D Perspective View.
  • And it's possible to control the whole maps and spots dynamically, e.g. pan/zoom around on the map, add or remove spots...
  • Google Maps / Bing Maps Notes - the XML interfaces of the Bing Maps and the Google Maps plugins are almost the same. To use the Bing Maps plugin just replace the Google Maps plugin and change the Google Maps key with a Bing Maps key.

Plugin documentation topics:

Buy / Order (not available anymore)

  • Google has stopped the automatic delivering / registration of new API keys for the Google Maps Flash API. That means old existing keys are still working, but it's not possible to get new keys for new domains anymore.
  • Please see this forum thread for all details: Google Maps Flash-API Keys.
  • As replacement there is here the new krpano Bing Maps Plugin.
  • Note - the krpano license keys for the Google Maps and the Bing Maps are the same! Just rename the googlemaps.license.xml to bingmaps.license.xml.

Updates

  • All updates for the Google Maps Plugin are free. Just get the newest googlemaps.swf with the newest krpano Viewer Download Package from here.
  • For updates for the Source Code write a short mail.
  • UPDATE NOTE - for orders before version 1.0.8.14 see here - License Update.

Usage Syntax

The Google Maps Plugin embedding with all attributes / sub-nodes and their default values:
<plugin name="map"
        url="googlemaps.swf"
        align="leftbottom" width="400" height="300" x="0" y="0"
        keep="true"
        key="...your Google Maps API key for your domain..."
        maptype="satellite"
        maptypes="normal|satellite|physical|hybrid"
        lat="..."
        lng="..."
        zoom="1"
        viewmode="2D"
        pitch="0.0"
        roll="0.0"
        yaw="0.0"
        maphandcursor="false"
        activespotenabled="false"
        dragging="true"
        scrollwheel="true"
        continuouszoom="false"
        dbclicking="false"
        keyboard="false"
        crosshairs="false"
        bgcolor="0xE0E0E0"
        bgalpha="1.0"
        onmapready=""
        onmaptypechanged=""
        onmapmoved=""
        onmapzoomed=""
>
  <spotstyle name="style1" ... />
  ...
  
  <spot name="spot1" ... active="true" />
  <spot name="spot2" ... />
  <spot name="spot3" ... />
  ...
  
  <radar visible="true" ... />
  
  <positioncontrol    visible="false" ... />
  <zoomcontrol        visible="false" ... />
  <maptypecontrol     visible="false" ... />
  <navigationcontrol  visible="false" ... />
  <overviewmapcontrol visible="false" ... />
  
</plugin>

Plugin Attributes

  • key
    • The Google Maps API key.
    • To be able to use the Google Maps services a Google Maps API key is needed!
    • One key is only valid for one domain.
    • Sign up here for a Google Maps API key...

    • Multi-Domain-Key-Pairs
      • To be able to use the plugin on more than one domain, it is possible to use several domain-key pairs as key.
      • Just separate all the domains and keys by pipe | characters.
      • To set a key for local testing (file://) there is the special domain name "local" available.
      • Syntax / usage example:
        key="yourdomain1.com|key1|yourdomain2.com|key2|local|key1"
  • maptype
    • Select the type of the map:
      • satellite (default)
      • normal
      • physical
      • hybrid
  • maptypes
    • Set the avialable /chouseable map types.
    • Can be any combinations of the map type values.
    • Default: normal|satellite|physical|hybrid
  • lat / lng
    • Latitude and Longitude in degrees.
    • The geographic coordinates of the current map center position.
    • How / where to get?
      • Either directly from the Google Maps page.
      • Or from here: Get Lat Lon (www.getlatlon.com)
        A nice webpage which allows getting the coordinates in the right format in an easy and simple way.
  • zoom
    • Set zoom level of the map.
    • Can be from 0 to 32.
  • viewmode
    • Select a 2D or a 3D view of the map.
    • Possible settings: 2D or 3D.
  • pitch / roll / yaw
    • The 3D camera rotation when using viewmode="3D".
  • maphandcursor
    • Show a hand cursor when the mouse is over the map.
  • activespotenabled
    • Should the active spot be enabeld?
      That means - should the active spot react to click or over events.
  • dragging
    • Should it be possible to drag the map by the mouse?
  • scrollwheel
    • Should it be possible to zoom in the map by the mouse wheel?
  • continuouszoom
    • Should the zooming in the map be stepwise or continuous?
  • dbclicking
    • Should it be possible to use double clicking to zoom in?
  • keyboard
    • Allow moving in the map by the keyboard?
  • crosshairs
    • Show a crosshairs at the map center.
  • bgcolor / bgalpha
    • The color and alpha of the map background.

Plugin Attributes - Events

  • onmapready
    • Will be called when the Google Maps Plugin is loaded and ready for usage.
  • onmaptypechanged
    • Will be called when the map type was changed.
  • onmapmoved
    • Will be called when the map was moved.
  • onmapzoomed
    • Will be called when the map was zoomed.

Plugin Subnodes - <spotstyle>

  • With the <spotstyle> subnode it is possible to define styles for the spots.
  • A spot can be assigned to a spotstyle by the style attribute.
  • There is a predefined style named "DEFAULT".

The <spotstyle> node with all settings and their default values:
<spotstyle name="DEFAULT"
           url=""
           overurl=""
           activeurl=""
           edge="center"
           x="0"
           y="0"
           shadow="true"
           />

<spotstyle> Attributes

  • name
    • The name of the spotstyle.
      Use this name in the style attribute of a spot.
  • url
    • The url / path to an image that should be used for the spot.
      When not defined the default image (a blue dot) will be used.
  • overurl
    • The url / path to an image that will be used for the spot when it mouse is over the spot.
      When not defined the default image (a blue dot) will be used.
  • activeurl
    • The url / path to an image that will be used when the spot is activated.
      When not defined the default image (a green dot) will be used.
  • edge
    • The alignment edge / anchor point of the spot image.
      Possible values: lefttop, left, leftbottom, top, center, bottom, righttop, right, rightbottom.
  • x / y
    • The offset in pixels from the edge point to the image.
  • shadow
    • Should a shadow by added to the spot image?

Plugin Subnodes - <spot>

  • With the <spot> subnode it is possible to define spots on the map.
  • A spot will be placed at lat/lng coordinates and can be linked to panos by using the loadpano / loadscene actions in the onclick event.

The <spot> node with all settings and their default values:
<spot name="..."
      style="DEFAULT"
      url="..."
      lat="..."
      lng="..."
      heading="0"
      active="false"
      onover=""
      onhover=""
      onout=""
      onclick=""
      />

<spot> Attributes

  • name
  • style
    • The name of the spotstyle that should be used for that spot.
  • url
    • The url / path to an image that should be used for the spot.
      When not defined the image from the spotstyle will be used.
  • lat / lng
    • Latitude and Longitude in degrees.
    • The geographic coordinates of the spot.
    • How / where to get?
      • Either directly from the Google Maps page.
      • Or from here: Get Lat Lon (www.getlatlon.com)
        A nice webpage which allows getting the coordinates in the right format in an easy and simple way.
  • heading
    • The heading of the pano in degrees, needed to align the pano orientation with the radar on the map.
    • See also the radar headingoffset setting for details.
  • active
    • State of the spot. When set to true the spot will be activated. That means the spot will show the active spotstyle image (when no url was set) and that the radar will be shown at the spot location.
    • To activate a spot dynamically use the activatespot() action.

<spot> Events

  • onover
    • Actions / functions that will be called when the mouse moves over the spot element.
    onhover
    • Actions / functions that will be called in intervals (10 times per second) when the mouse stays over / hovers the spot element.
    onout
    • Actions / functions that will be called when the mouse moves out of the spot element.
    onclick
    • Actions / functions that will be called when there is a mouse click on the spot element.

<spot> Actions

Plugin Subnodes - <radar>

  • Add and style a radar.
  • The radar will be shown at the active spot position.

The <radar> node with all settings and their default values:
<radar visible="true"
       dragable="true"
       size="100"
       zoomwithmap="false"
       headingoffset="90"
       alpha="0.5"
       fillcolor="0xFFFFFF"
       fillalpha="1.0"
       linewidth="0.0"
       linecolor="0xFFFFFF"
       linealpha="0.0"
       glow="true"
       glowcolor="0xFFFFFF"
       glowwidth="4"
       glowstrength="4"
       />

<radar> Attributes

  • visible
    • Show or hide the radar.
  • dragable
    • Should the radar cone be dragable by the mouse?
  • size
    • The size / range of the radar cone.
  • zoomwithmap
    • Should the radar cone also be zoomed when zooming the map?
  • headingoffset
    • An offset for the heading value of the spots.
    • The default value for headingoffset is 90, which means heading=0 is pointing to right/east by default. Use headingoffset=0 to let heading=0 pointing to top/north.
  • alpha
    • The alpha transparency of the whole radar element.
  • fillcolor / fillalpha
    • The color and alpha of the filling of the radar cone.
  • linewidth / linecolor / linealpha
    • The linewidth, color and alpha of the line around the radar cone.
  • glow / glowcolor / glowwidth / glowstrength
    • Add and style the glowwing effect of the radar cone.

Google Maps Controls

  • There are some standard Google Maps Controls available:
  • Note - beside of these included controls it's possible to use own images as controls by using normal krpano plugin elements and adding them with the parent setting to the map.

All controls with all settings and their default values:


Navigation Control:
<navigationcontrol visible="true" align="lefttop" x="2" y="2" />

Position Control:
<positioncontrol visible="true" align="lefttop" x="2" y="2" />

Zoom Control:
<zoomcontrol visible="true" align="righttop" x="2" y="2" 
             hasscrolltrack="true"
             />

Map-Type Control:
<maptypecontrol visible="true" align="rightbottom" x="2" y="2"
                buttonalign="H"
                />

Overview-Map Control:
<overviewmapcontrol visible="true"
                    align="leftbottom"
                    x="2" y="2"
                    border="1" 
                    width="..." 
                    height="..."
                    />

Control Attributes

Plugin Actions

Actions of the Google Maps Plugin object.

Usage example:
plugin[map].activatespot(spot1);
plugin[map].pantospot(spot1);

Actions documenation:

Examples

Full example xml code: (also included in the viewer download package)
<krpano onstart="loadscene(stpeterssquare,null,MERGE);">

    <area width="70%" x="30%" />

    <plugin name="map" url="googlemaps.swf" parent="BGLAYER" keep="true"
            align="lefttop" x="0" y="0" width="30%" height="100%"
            key="...your Google Maps API key for your domain..."
            maptype="satellite"
            lat="41.90050" lng="12.46705" zoom="15"
            viewmode="3D" pitch="45.0" roll="0.0" yaw="-90.0"
    >

        <spotstyle name="DEFAULT"
                   url="mapspot.png"
                   overurl="mapspot_over.png"
                   activeurl="mapspot_active.png"
                   edge="bottom" x="0" y="0" shadow="true"
                   />

        <spot name="stpeterssquare" active="true"
              lat="41.90255" lng="12.45708" heading="64.5"
              onhover="showtext('St. Peters[sq]s Square');"
              onclick="loadscene(stpeterssquare,null,MERGE,BLEND(1));
                       activatespot();"
              />

        <spot name="fourrivers"
              lat="41.89877" lng="12.47311" heading="270.0"
              onhover="showtext('Fountain of the Four Rivers');"
              onclick="loadscene(fourrivers,null,MERGE,BLEND(1));
                       activatespot();"
              />

        <radar visible="true" zoomwithmap="true" size="50" />

        <navigationcontrol  visible="true" />
        <maptypecontrol     visible="true" buttonalign="V" />

    </plugin>

    <scene name="stpeterssquare">
        <view hlookat="103" vlookat="-2" fov="100" />
        <preview type="stpeterssquare_preview.jpg" />
        <image>
            <cube url="stpeterssquare_%s.jpg" />
        </image>
    </scene>

    <scene name="fourrivers">
        <view hlookat="-1" vlookat="-4" fov="100" />
        <preview type="fourrivers_preview.jpg" />
        <image>
            <cube url="fourrivers_%s.jpg" />
        </image>
    </scene>

</krpano>