Google Earth API Samples - Creating Screen Overlays

Relevant Resources:

• KmlScreenOverlay Reference
• KmlIcon Reference

Relevant Code Excerpt:

var screenOverlay = ge.createScreenOverlay('');
screenOverlay.setIcon(ge.createIcon(''));
screenOverlay.getIcon().
  setHref("http://www.google.com/intl/en_ALL/images/logo.gif");

// Set the point inside the overlay that is used as the positioning
// anchor point.
screenOverlay.getOverlayXY().setXUnits(ge.UNITS_FRACTION);
screenOverlay.getOverlayXY().setYUnits(ge.UNITS_FRACTION);
screenOverlay.getOverlayXY().setX(.5);
screenOverlay.getOverlayXY().setY(.5);

// ---------------------------------------------------------------------------
// WARNING: screenXY and overlayXY in the Earth API are swapped, relative
// to the KML specification. In the Earth API, screenXY is a point on the
// overlay image, and overlayXY is a point inside the plugin window.
// ---------------------------------------------------------------------------

// Set screen position in fractions.
screenOverlay.getScreenXY().setXUnits(ge.UNITS_FRACTION);
screenOverlay.getScreenXY().setYUnits(ge.UNITS_FRACTION);
screenOverlay.getScreenXY().setX(Math.random());  // Random x.
screenOverlay.getScreenXY().setY(Math.random());  // Random y.

// Rotate around object's center point.
screenOverlay.getRotationXY().setXUnits(ge.UNITS_FRACTION);
screenOverlay.getRotationXY().setYUnits(ge.UNITS_FRACTION);
screenOverlay.getRotationXY().setX(0.5);
screenOverlay.getRotationXY().setY(0.5);

// Set object's size in pixels.
screenOverlay.getSize().setXUnits(ge.UNITS_PIXELS);
screenOverlay.getSize().setYUnits(ge.UNITS_PIXELS);
screenOverlay.getSize().setX(300);
screenOverlay.getSize().setY(90);

// Rotate by a random number of degrees.
screenOverlay.setRotation(Math.random() * 360);

ge.getFeatures().appendChild(screenOverlay);