Getting Started with TerraExplorer for Web

Transcription

1 Getting Started with TerraExplorer for Web Version Skyline Software Systems Inc.

2 Information contained in this document is subject to change without notice and does not represent a commitment on behalf of Skyline Software Systems Inc. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying without the written permission of Skyline Software Systems Inc., Park Center Road, Suite 201 Herndon, VA USA. Copyright 2016 Skyline Software Systems Inc. All rights reserved. Printed in the United States of America. Skyline, It s your world, the Skyline logo, TerraExplorer, TerraExplorer Pro, TerraExplorer Plus, TerraDeveloper, TerraBuilder, TerraGate, SFS, and the TerraExplorer logo are trademarks of Skyline Software Systems Inc. Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries. Google Earth is a trademark of Google Corporation in the United States and/or other countries. All other trademarks are the property of their respective holders. Trademark names are used editorially, to the benefit of the trademark owner, with no intent to infringe on the trademark. Protected by U. S. Patents , , , , , Other patents pending. Technical support General information Contact Skyline on the Internet at support@skylinesoft.com info@skylinesoft.com 2

3 Table of Contents INTRODUCTION... 4 Introduction to TerraExplorer for Web... 4 Product Capabilities... 4 Server and Browser Requirements... 4 Installing the TE4W Package on Your Web Server... 5 DEFINING THE PROJECT... 5 About Defining the Project... 5 Terrain... 6 Placemark... 6 MeshLayer... 7 FeatureLayer... 7 NetworkLink... 7 Tour... 8 Domain... 8 ScreenOverlay... 9 Layout

4 INTRODUCTION Introduction to TerraExplorer for Web TerraExplorer for Web (TE4W) is a lightweight 3D GIS viewer that enables you to view high-resolution, stunningly realistic SkylineGlobe 3D content in a web browser, without any plug-ins. This latest addition to Skyline s TerraExplorer product line serves as a perfect complement to Skyline s powerful 3D GIS desktop and mobile applications, offering a simple, no-download, no-installation solution for online viewing and analysis of 3D environments. Building on standard Cesium support for imagery, elevation and KML layers, TerraExplorer for Web can also display most of your spatial databases including 3D city layers and feature layers. TerraExplorer for Web integrates smoothly with the entire Skyline product line for easy access to all your data from photorealistic, geographically accurate terrain databases created in TerrainBuilder to PhotoMesh s highresolution, textured, 3D mesh models. Moreover, TerraExplorer for Web seamlessly accesses online data from Skyline s SkylineGlobe server and other OGC-compliant servers, and quickly loads online TerraExplorer projects. Based on HTML5/WebGL standards, TerraExplorer for Web provides support for multiple platforms and browsers (Windows, Mac, Linux, and selected mobile devices, Chrome, Edge, Firefox, and more). Product Capabilities Lightweight Online Viewer - Based on the HTML/WebGL standard, TerraExplorer for Web 3D GIS viewer requires no plugin or application installation. Multi-Platform, Multi-Browser - TerraExplorer for Web provides support for multiple platforms (Windows, Mac, Linux and selected mobile devices) and multiple web browsers (Chrome, Edge, Firefox and others). Explore Data - Explore data from SkylineGlobe server as well as user-loaded content: terrain, GIS feature layers, imagery and elevation raster layers, and urban model layers. Data is seamlessly fused for a photo-realistic visualization. Measure and Analyze - Easily access distance and area measurement tools and graphic terrain profile for an enhanced understanding of the 3D environment. Data Query - TerraExplorer for Web offers address and point of interest search capability plus reverse search to enable you to quickly find and display the 3D environment information you require. Optimized Performance - Fast loading times and smooth navigation. Server and Browser Requirements Server Browser Operating System All web servers are supported (Tested on IIS) Chrome, Firefox, Safari, Opera, Edge Windows, Mac, Linux 4

5 Installing the TE4W Package on Your Web Server The first step in setting up your TerraExplorer for Web is publishing the web deployment package to your web server. To install the TE4W package on your web server: 1. Extract the contents of the TE4W package zip file to a folder on your web server. 2. Browse to TE4W/TerraExplorer.html to view default demo data (terrain database, mesh layers and more) that is streamed from All web servers are supported (Tested on IIS). The TE4W package files are provided with a web.config file that enables CORS using the <add name="access-control-allow-origin" value="*" />, tag. This allows accessing of data from sites other than yours, i.e. streaming of the demo project from while hosting TerraExplorer for Web on your site. DEFINING THE PROJECT About Defining the Project The TerraExplorer for Web project is defined by a KML file that is extended with TE4W tags (sx:) for additional functionalities. The project file defines the terrain database, available layers, layout and more. To define the project: 1. Use the default.kml file included in the installation folder as a template for your KML project file. 2. If you want to use several KML project files, place all the project files in the same folder and use TerraExplorer.html?config=ProjectName.kml to access each one. In TerraExplorer Pro v7.0, manual editing of the KML file will be replaced by the new Publish to TE4W feature. All the following are defined in the KML file: Terrain database Mesh layers Feature layers Placemarks (locations) Network links Domain Screen overlay Layout Tour (presentations) 5

6 Terrain Defines the default terrain database. To stream the terrain database: 1. Contact Skyline for a special TerraGate version that includes the TerraExplorer for Web patch. Include your existing TerraGate license file in your upgrade request. 2. Install TerraGate with the upgraded v7.0 license sent by Skyline. 3. In TerraGate: a. Publish the project s terrain database. b. In the SFS Manager, add one WMS imagery layer and one elevation layer for the terrain database. <sx:terrain> <href> <sx:terrainlayername>skylineglobe.tbp</sx:terrainlayername> </sx:terrain> Placemark Sets the locations that will appear in the Places panel and enables flying to them. <Placemark id="0_310"> <name>orlando ( Dat Air)</name> <LookAt> <longitude> </longitude> <latitude> </latitude> <altitude>0</altitude> <heading>0</heading> <tilt> </tilt> <range>600</range> <altitudemode>relativetoground</altitudemode> </LookAt> <Style> <IconStyle> <Icon> <href> </Icon> </IconStyle> </Style> </Placemark> 6

7 MeshLayer Loads a mesh layer. To publish a mesh layer: 1. In PhotoMesh, build the mesh model in TerraExplorer for Web output format. 2. Contact Skyline support (Support@SkylineGlobe.com) for the latest information on publishing the mesh layer. <sx:meshlayer> <name>frederick</name> <Link> <sx:layername>frederick</sx:layername> <href> </Link> </sx:meshlayer> FeatureLayer Loads an SFS feature layer. <sx:featurelayer> <name>highway level 0</name> <Link> <sx:layername>osm_highway_l0_090714</sx:layername> <href> </Link> <sx:suggestedblockwidth>626000</sx:suggestedblockwidth> <sx:geometrytype>polylines</sx:geometrytype> <Style> <LineStyle> <width>1</width> <color>ff116f8a</color> </LineStyle> </Style> </sx:featurelayer> NetworkLink Loads a KML layer, as supported by Cesium. <NetworkLink> <name>skyline office kml</name> <Link> <href> </Link> </NetworkLink> 7

8 Tour Flies from location to location according to a predefined customized flight route, using a Google Earth KML, as supported by Cesium. Under the <gx:tour> tag only the <gx:flyto> and <gx:wait> are supported. Thus, only fly to and wait are supported in the presentation. See for more information. In the TerraExplorer for Web Viewer, tours are available in the Places dialog box under the Presentations tab. In v7.0 of TerraExplorer for Web, tours can only be added to a project by manually creating them. In TerraExplorer Pro v7.0, manual editing of the KML file will be replaced by the new Publish to TE4W feature. Domain Enables download requests to be split across multiple subdomains for streaming performance optimization. Most web browsers permit a maximum of six concurrent connections for the same domain. When the number of resources to download exceeds this limit (as is common in TerraExplorer for Web), the download requests are queued; slowing page load times. To work around this limitation, requests can be split across multiple subdomains, which are mapped to the same domain by the DNS server. Version 7.0 of TerraExplorer for Web supports subdomains for terrain, feature and imagery layers, but not for 3DML layers. In order to alert TerraExplorer for Web to use subdomains when requesting data from the main domain name ( the following tag and format should be included in the KML project file: <sx:domain name=" <sx:subdomain>www1.skylineglobe.com</sx:subdomain> <sx:subdomain>www2.skylineglobe.com</sx:subdomain> <sx:subdomain>www3.skylineglobe.com</sx:subdomain> <sx:subdomain>www4.skylineglobe.com</sx:subdomain> <sx:subdomain>www5.skylineglobe.com</sx:subdomain> </sx:domain> 8

9 ScreenOverlay Determines visibility of an image overlay (e.g. logo) in the 3D Window. <ScreenOverlay> <visibility>true</visibility> <Icon> <href>./img/skyline_logo.png</href> </Icon> <overlayxy x="1" y="0" xunits="fraction" yunits="fraction"/> <screenxy x="10" y="10" xunits="insetpixels" yunits="insetpixels"/> </ScreenOverlay> Layout Determines what items are displayed on the menu. Contact Skyline support for more information. <sx:layout lang="english"> <sx:menubutton> <sx:iconurl>./img/menubutton.png</sx:iconurl> </sx:menubutton> <sx:statusbar> <visibility>true</visibility> <sx:displaylocation>true</sx:displaylocation> <sx:copyrighttext> 2016, Skyline Software Systems</sx:copyrightText> </sx:statusbar> <sx:searchbox> <visibility>true</visibility> <sx:searchprovider> </sx:searchbox> <sx:appmenu> <sx:analysisdistancemenu>true</sx:analysisdistancemenu> <sx:analysisareamenu>true</sx:analysisareamenu> <sx:analysisprofilemenu>true</sx:analysisprofilemenu> <sx:layersmenu>true</sx:layersmenu> <sx:placesmenu>true</sx:placesmenu> <sx:undergroundmenu>true</sx:undergroundmenu> <sx:settingsmenu>true</sx:settingsmenu> </sx:appmenu> </sx:layout> 9