Skip to content
This repository has been archived by the owner on Jan 9, 2023. It is now read-only.

Updated Portable Documentation #323

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/geedocs/answer/1066449.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@
<p class="sidebar-toc"><a href="../answer/4580164.html">Welcome to Portable 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/4594620.html">Portable Release Notes 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/3230746.html">Portable User Guide</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 5.2</a></p>
<p class="sidebar-toc"><a href="../answer/3230807.html">Portable Developer Guide</a></p>
<p class="sidebar-toc"><a href="../answer/3253752.html">Hello Earth! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/3253275.html">Hello Maps! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/4590263.html">Inspecting portable files</a></p>
<p class="sidebar-toc"><a href="../answer/1066449.html" class="current-file">Custom folders</a></p>
<p class="sidebar-toc"><a href="../answer/3003324.html">Cutter tool system information</a></p>
<p class="sidebar-toc"><a href="../answer/3003337.html">Manually halt the cutter process</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 4.4</a></p>
</div>
<div class="content">
<a name="top_of_file"></a>
Expand Down
2 changes: 1 addition & 1 deletion docs/geedocs/answer/3003324.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@
<p class="sidebar-toc"><a href="../answer/4580164.html">Welcome to Portable 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/4594620.html">Portable Release Notes 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/3230746.html">Portable User Guide</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 5.2</a></p>
<p class="sidebar-toc"><a href="../answer/3230807.html">Portable Developer Guide</a></p>
<p class="sidebar-toc"><a href="../answer/3253752.html">Hello Earth! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/3253275.html">Hello Maps! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/4590263.html">Inspecting portable files</a></p>
<p class="sidebar-toc"><a href="../answer/1066449.html">Custom folders</a></p>
<p class="sidebar-toc"><a href="../answer/3003324.html" class="current-file">Cutter tool system information</a></p>
<p class="sidebar-toc"><a href="../answer/3003337.html">Manually halt the cutter process</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 4.4</a></p>
</div>
<div class="content">
<a name="top_of_file"></a>
Expand Down
2 changes: 1 addition & 1 deletion docs/geedocs/answer/3003337.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@
<p class="sidebar-toc"><a href="../answer/4580164.html">Welcome to Portable 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/4594620.html">Portable Release Notes 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/3230746.html">Portable User Guide</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 5.2</a></p>
<p class="sidebar-toc"><a href="../answer/3230807.html">Portable Developer Guide</a></p>
<p class="sidebar-toc"><a href="../answer/3253752.html">Hello Earth! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/3253275.html">Hello Maps! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/4590263.html">Inspecting portable files</a></p>
<p class="sidebar-toc"><a href="../answer/1066449.html">Custom folders</a></p>
<p class="sidebar-toc"><a href="../answer/3003324.html">Cutter tool system information</a></p>
<p class="sidebar-toc"><a href="../answer/3003337.html" class="current-file">Manually halt the cutter process</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 4.4</a></p>
</div>
<div class="content">
<a name="top_of_file"></a>
Expand Down
90 changes: 32 additions & 58 deletions docs/geedocs/answer/3230746.html

Large diffs are not rendered by default.

17 changes: 9 additions & 8 deletions docs/geedocs/answer/3230777.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"/>
<title>Create portable globes and maps</title>
<title>Create Portable Globes and Maps</title>
<link rel="stylesheet" href="../css/styles.css" type="text/css" media="all" /> <link rel="stylesheet" href="../css/containers.css" type="text/css" media="all" /> </head> <body>
<!-- 3230777.html -->
<div class="container">
Expand Down Expand Up @@ -34,7 +34,7 @@
<a name="top_of_file"></a>
<p><img src="../art/common/googlelogo_color_260x88dp.png" width="130" height="44" alt="Google logo" /></p>
<h1><a href="../index.html">Google Earth Enterprise Documentation Home</a> | GEE Server administration</h1>
<h2>Create portable globes and maps</h2>
<h2>Create Portable Globes and Maps</h2>
<p>When you’re out in the field and you need a globe or map that can easily be stored and accessed from a desktop or laptop, you can create a portable globe or map by creating a <em>cut</em> of one of your databases. A portable globe or map is a single file (<code>.glb</code> or <code>.glc</code>) that stores all the geospatial data available within your specified area of interest—including all high-resolution imagery, terrain, vector data, KML files, and searchable point of interest (POI) locations. Outside the specified area of interest, the globe or map stores only low-resolution imagery and terrain. You specify the levels of resolution when you cut the globe or map.</p>
<p>You can <a href="#creating_a_portable_globe">create portable globes and maps</a> with the <a href="../answer/3479921.html">cutter tool</a> feature of the <a href="../answer/3470759.html">Google Earth Enterprise (GEE) Server</a>, from existing GEE portable files, or you can obtain them from third-party vendors. Depending on your area of coverage, it can take only a few minutes to specify and generate a globe or map and then save it to the GEE Portable maps directory.</p>
<h3>Cut globes and maps from existing portable files</h3>
Expand Down Expand Up @@ -67,7 +67,7 @@ <h3>Inspect portable files for timestamp information</h3>
<h3>Composite globes and maps</h3>
<p>Portable globes and maps can also be assembled into layers to create a composite globe or map, a single file (<code>.glc</code>) that contains all the geospatial data for assembled layers. To assemble a composite file, you supply a KML polygon to cut your area of interest, then specify the layers and order in which they display. See <a href="../answer/4643041.html">Create composite globes and maps</a>.</p>
<h2><a name="creating_a_portable_globe"></a>Create a portable globe or map</h2>
<p>Cutting a globe or map is accomplished with a simple web interface. You use your mouse, or import KML, to define a polygon, which defines your 'area of interest.' This polygon not only defines the area that displays high-resolution imagery, but is also used by Fusion to create a localized search database.</p>
<p>Cutting a globe or map is accomplished with a simple web interface. You import KML, or use your mouse, to define a polygon, which defines your "area of interest." This polygon not only defines the area that displays high-resolution imagery, but is also used by Fusion to create a localized search database.</p>
<div class="note">
<p><strong>Note</strong>: The cutting processes are CPU and disk intensive, as they are retrieving all data within the specified polygon from the Earth Enterprise Server. This can affect the overall performance of the Server, including slowing end-user access.</p>
<p>To mitigate performance impact to end users, you may consider:</p>
Expand All @@ -87,8 +87,8 @@ <h3 id="enable_the_cutter">Enable the cutter</h3>
</ul>
<p>For more information about <code>geserveradmin</code>, see the <a href="../answer/3481558.html">Command Reference</a>.</p>
<p class="warning"><strong>Note about authentication and SSL</strong>: Cutting is not currently supported on globes or maps that require end-user authentication such as LDAP. One workaround is to allow unauthenticated access from localhost on your Earth Enterprise Server. Refer to Apache documentation to enable such a configuration. Cutting of a globe over HTTPS is supported; however the SSL certificate of the target server will not be verified during cutting.</p>
<h3 id="install_the_google_earth_plugin">Install the Google Earth Plug-in</h3>
<p>The Google Earth Plugin is used to display the globe from which maps are cut. To install the plug-in, visit <a href="http://www.google.com/earth/explore/products/plugin.html" target="_blank">http://www.google.com/earth/explore/products/plugin.html</a> and follow the prompts inside the Google Earth Plug-in frame. If you require installers for offline installation, see <a href="../answer/6051584.html">Provide Google Earth Plug-in for your users to install</a>.</p>
<h3 id="install_the_google_earth_plugin">Installing the Discontinued Google Earth Plug-in</h3>
<p>The Google Earth Plugin is used to display the globe from which maps are cut. The plug-in has been discontinued and doesn't work in recent browsers that have dropped support for NPAPI. The plug-in is no longer officially distributed. If you require installers for offline installation, see <a href="../answer/6051584.html">Provide Google Earth Plug-in for your users to install</a>.</p>
<h2 id="the_globe_cutter_interface">The globe cutter interface</h2>
<h3>To create a portable globe:</h3>
<ol class="spaced-list">
Expand All @@ -102,7 +102,7 @@ <h3>To create a portable globe:</h3>
</li>
<li>Click <strong>Databases</strong> to display the list of databases and portables pushed to the Server. </li>
<li>Click the <strong>Settings</strong> button in the top right of the window: <img alt="Settings button" src="../art/fusion/portable/cutterSettingsButton.png"/> and choose <strong>Launch Cutter</strong> from the Tools menu.
<p>A new browser tab opens with the GEE Server - Cutting Tool and the <strong>Create new offline map</strong> window appears.</p>
<p>A new browser tab opens with the GEE Server &mdash; Cutting Tool and the <strong>Create new offline map</strong> window appears.</p>
<p><img alt="GEE Cutter create offline map window" src="../art/fusion/portable/cutterTools.png"/></p>
</li>
</ol>
Expand All @@ -123,6 +123,7 @@ <h3 id="globe_name">Map or globe name</h3>
<h3 id="drawing_the_polygon">Drawing the polygon</h3>
<p>Once the globe or map name has been specified, you can define the geographic region to be cut by drawing a polygon on the globe. There are two ways to draw the polygon.</p>
<h4>Hand drawing the polygon</h4>
<div class="alert">When cutting a 3D globe this method is only available if you are running the discontinued Google Earth Plug-in in your browser. This method works for cutting 2D maps from your browser.</div>
<ol>
<li>By default, you draw a polygon by hand so the <strong>Select Region</strong> drop-down list is set to <strong>Manual</strong>. </li>
<li>Use the Hand tool <img alt="Pan tool" src="../art/fusion/portable/cutterHandTool2.png"/> to pan, then using the navigation controls in the plug-in, zoom in to the region of interest. </li>
Expand All @@ -139,7 +140,7 @@ <h4>Defining the polygon with KML</h4>
<ol>
<li>From the <strong>Select Region</strong> drop-down list, select <strong>Paste KML</strong>. The Paste KML window appears.</li>
<li>Paste your KML into the text field, then click <strong>Use KML</strong>.
<p>GEE Server validates the KML and then draws the polygon using the KML data you provided. Your polygon appears on the map or globe.</p>
<p>GEE Server validates the KML and then draws the polygon using the KML data you provided. Your polygon appears on the map or globe (the latter, only if you have the discontinued Google Earth plug-in running in your browser).</p>
</li>
<p>If you need to draw the polygon again, click <strong>Clear</strong> to delete the polygon you just created with pasted KML.</p>
</ol>
Expand Down Expand Up @@ -196,7 +197,7 @@ <h4>KML files</h4>
</ul>
<!-- <p>These behaviors can be modified if the globe is built from the command line rather than from the GUI as described in the <a href="#command_line_reference">Command line reference</a> section of this document.</p> -->
<h4>Historical Imagery</h4>
<p>Historical Imagery is not supported in the portable globe as of Fusion 4.2. It is being investigated as a possible feature.</p>
<p>Historical Imagery is not supported in the portable globe as of Fusion 4.2.</p>
<p>There are, however, two situations in which historic imagery will be displayed:</p>
<ul class="spaced-list">
<li>When the computer running the portable globe has a connection to the Earth server from which the globe was cut. In this case, historic imagery can be streamed from the Earth server. Once in the field, however, and disconnected from the Earth server, no historic imagery will be displayed.</li>
Expand Down
13 changes: 6 additions & 7 deletions docs/geedocs/answer/3230807.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,14 @@
<p class="sidebar-toc"><a href="../answer/4580164.html">Welcome to Portable 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/4594620.html">Portable Release Notes 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/3230746.html">Portable User Guide</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 5.2</a></p>
<p class="sidebar-toc"><a href="../answer/3230807.html" class="current-file">Portable Developer Guide</a></p>
<p class="sidebar-toc"><a href="../answer/3253752.html">Hello Earth! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/3253275.html">Hello Maps! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/4590263.html">Inspecting portable files</a></p>
<p class="sidebar-toc"><a href="../answer/1066449.html">Custom folders</a></p>
<p class="sidebar-toc"><a href="../answer/3003324.html">Cutter tool system information</a></p>
<p class="sidebar-toc"><a href="../answer/3003337.html">Manually halt the cutter process</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 4.4</a></p>
</div>
<div class="content">
<a name="top_of_file"></a>
Expand All @@ -42,19 +42,18 @@ <h2><a name="Introduction">Introduction</a></h2>
<p>You can customize or extend GEE Portable, or create applications that work with it.</p>
<p>To help you get started, Google provides two <code>Hello World!</code> files that you can copy and use as templates. These files (<code>Hello_Maps.html</code> for 2D maps and <code>Hello_Earth.html</code> for 3D globes) call the required scripts, load the globe or map, define the <code>.css</code> file, and so on. The files include JSON and, if needed, KML polygons.</p>
<p>See the resources linked to below to learn how to edit and extend the <code>Hello_Maps.html</code> and <code>Hello_Earth.html</code> files.</p>
<p><strong>Note</strong>: Although it is possible to configure GEE Portable to display multiple globes or maps at the same time, this isn't recommended or supported. The additional configuration requires you to build the globe or map to reference a specific port number, so you can no longer re-use it for any other ports.</p>
<h2><a id="Usefulresources" name="Usefulresources">Useful resources</a></h2>
<p><strong>Note</strong>: Clicking any of these links connects you to a site outside your network. If you’re not sure if your organization allows outside connections, check with your administrator first.</p>
<p><code>Hello_Maps.html</code> and <code>Hello_Earth.html</code> are based on the Google Maps API and Google Earth API. More information about these APIs is linked to below. Also included are links to some resources for learning how to parse your JSON data and KML coordinates.</p>
<ul>
<li><a href="https://developers.google.com/maps/" target="_blank">Google Maps API help</a> at <a href="https://developers.google.com/maps/" target="_blank">https://developers.google.com/maps/</a>. Examples that use the Maps API.</li>
<li><a href="https://developers.google.com/earth/" target="_blank">Google Earth API help</a> at <a href="https://developers.google.com/earth/" target="_blank">https://developers.google.com/earth/</a>. Ways to extend the Earth Plug-in.</li>
<li><a href="https://developers.google.com/earth/" target="_blank">Google Earth API help</a> at <a href="https://developers.google.com/earth/" target="_blank">https://developers.google.com/earth/</a>. <em>The Earth Plug-in and its API have been discontinued.</em></li>
<li><a href="http://api.jquery.com/jQuery.parseJSON/" target="_blank">jQuery help</a> at <a href="http://api.jquery.com/jQuery.parseJSON/" target="_blank">http://api.jquery.com/jQuery.parseJSON/</a>. A method for parsing JSON.</li>
<li><a href="https://code.google.com/p/geoxml3/" target="_blank">geoxml3</a> at <a href="https://code.google.com/p/geoxml3/" target="_blank">https://code.google.com/p/geoxml3/</a>. A KML processor for use with the Google Maps API.</li>
</ul>
<h2><a id="HelloMaps" name="HelloMaps">Hello Maps!</a></h2>
<p>To write a script to display portable 2D maps, start with <code>Hello_Maps.html</code> and edit as needed. <code>Hello_Maps.html</code> is based on the Google Maps API.</p>
<h3>To access the <code>Hello_Maps</code> file:</h3>
<p>To write a script to display portable 2D maps, start with <code>hello_maps.html</code> and edit as needed. <code>hello_maps.html</code> is based on the Google Maps API.</p>
<h3>To access the <code>hello_maps.html</code> file:</h3>
<ol>
<li>Launch GEE Portable on <code>localhost:9335</code>.</li>
<li>Enter <code>http://localhost:9335/local/preview/developers/hello_maps.html</code> in your browser.</li>
Expand All @@ -63,7 +62,7 @@ <h3>To access the <code>Hello_Maps</code> file:</h3>
<p>Alternatively, click the link below:</p>
<p><a href="../answer/3253275.html">Hello Maps! code sample</a></p>
<h2><a id="HelloEarth" name="HelloEarth">Hello Earth!</a></h2>
<p>To write a script to display portable 3D maps (globes), start with <code>Hello_Earth.html</code> and edit as needed. <code>Hello_Earth.html</code> is based on the Google Earth API.</p>
<p>To write a script to display portable 3D maps (globes), start with <code>hello_earth.html</code> and edit as needed. <em>The <code>hello_earth.html</code> example is based on the discontinued Google Earth API.</em> Take that into consideration when developing new applications.</p>
<h3>To access the <code>Hello_Earth</code> file:</h3>
<ol>
<li>Launch GME Portable on <code>localhost:9335</code>.</li>
Expand Down Expand Up @@ -94,7 +93,7 @@ <h3>Globes JSON example</h3>
 "is_being_served":false<br/>
},<br/>
{<br/>
some other globe<br/>
 some other globe<br/>
},...<br/>
]</code></div>
<h5>
Expand Down
2 changes: 1 addition & 1 deletion docs/geedocs/answer/3253275.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@
<p class="sidebar-toc"><a href="../answer/4580164.html">Welcome to Portable 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/4594620.html">Portable Release Notes 5.0</a></p>
<p class="sidebar-toc"><a href="../answer/3230746.html">Portable User Guide</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 5.2</a></p>
<p class="sidebar-toc"><a href="../answer/3230807.html">Portable Developer Guide</a></p>
<p class="sidebar-toc"><a href="../answer/3253752.html">Hello Earth! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/3253275.html" class="current-file">Hello Maps! code sample</a></p>
<p class="sidebar-toc"><a href="../answer/4590263.html">Inspecting portable files</a></p>
<p class="sidebar-toc"><a href="../answer/1066449.html">Custom folders</a></p>
<p class="sidebar-toc"><a href="../answer/3003324.html">Cutter tool system information</a></p>
<p class="sidebar-toc"><a href="../answer/3003337.html">Manually halt the cutter process</a></p>
<p class="sidebar-toc"><a href="../answer/4485225.html">Portable Globe and Server 4.4</a></p>
</div>
<div class="content">
<a name="top_of_file"></a>
Expand Down
Loading