Google Earth Location Parameter (XYZ Plot and Contour)

<< Click to Display Table of Contents >>

Google Earth Location Parameter (XYZ Plot and Contour)

Report Name: Google Earth Location Parameter (Contour)


Report Type: Standard


Description: In order to use EQuIS Google Earth Reports for commercial purposes, you must obtain the appropriate license of Google Earth.

This report prompts you to select a date range and one (or more) location parameters. The output of this report shows values of each parameter represented as a three dimensional contour. The Places tree lists each parameter. Underneath each parameter there are folders for each of the days where values exist for that parameter. Values from each day are interpolated using a Nearest Neighbor algorithm. The interpolated values are then displayed using a color palette ranging from blue (low) to red (high). Each color in the palette is shown as a folder, so the user can check/uncheck that folder to show/hide values in that range.


This report is computationally intensive, and interpolates a unique grid for each parameter and date. For example, a site may have only 100 different records, but 25 different dates. In this case, the report would interpolate 25 different grids, and potentially consume vast system resources. Please also note that there are limitations to the size and complexity of kml/kmz files supported in Google Earth. Selecting too many parameters and/or too large a date range may result in the following error message.


"Report did not generate output. Please try again.Please reduce the number of parameters and/or dates to be contoured (params=P,dates=D)"


where P = the number of input parameters, and D = the number of input dates.


In addition to the color palette, the elevation of each point (distance from the ground) represents the relative value to other points. For example, the lower valued points are close to the ground; whereas the higher valued points are farther above the ground. This relative distance from the ground makes it possible to view a 2D contour (by reducing the tilt in Google Earth to look straight down from above) or to view a 3D surface (by increasing the tilt in Google Earth to look from the side).


This report includes data over the selected date range. You can drag the time slider or press the Play button to watch the values change over time.

The Google Earth output, which shows a table when clicking on a location, has been improved for readability by adding color to alternative rows.



EQuIS Google Earth Reports do not actually require or directly use Google Earth or any other Google service, the reports merely create KML (*.kml, *.kmz) files. Some of the charts are created using Google Charts (by sending individual data points for the chart).

Other applications besides Google Earth (such as ArcGIS Explorer) can read *.kml files - although EQuIS reports have not been tested extensively with anything other than Google Earth.

An EQuIS license does not provide legal license or permission to use Google Earth. Users are responsible to use Google Earth legally.


Submission of Content Warning


File Name: EarthSoft.Interfaces.Google


Language: English


Input Parameters: A selection made to customize the output of a report.


Input Parameters

Input Parameter Screenshot

Output Columns

Date Range

Start Date

End Date




Grid Size / Resolution

Number of Palette Steps




for more information.




Database Type: SQL


Database Schema: Standard (no custom or add-on schemas required)


Database Version: EQuIS 5.5+


Data Requirements: In order for locations to appear in this report:




DT_LOCATION.LOC_TYPE must be populated.

DT_LOCATION.SYS_LOC_CODE must be populated.

DT_LOCATION.LOC_DESC must be populated before locations are clickable.

The Water Levels Report must have STATUS_FLAG=A in ST_REPORT.


Report Requirements: Google Earth


Output Type: Google Earth or .kmz file


Example Output: Contact for more information.