Autodesk 15606-011408-9330 - MAPGUIDE R6.3 SITE LIC-UPG... Mode d’emploi

April 2004

Autodesk MapGuide® LiteView

Developer’s Guide

12345678910

This publication, or parts thereof, may not be reproduced in any form, by any method, for any purpose.

AUTODESK, INC., MAKES NO WARRANTY, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED

WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE REGARDING THESE MATERIALS, AND MAKES

SUCH MATERIALS AVAILABLE SOLELY ON AN “AS-IS” BASIS.

IN NO EVENT SHALL AUTODESK, INC., BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL

DAMAGES IN CONNECTION WITH OR ARISING OUT OF PURCHASE OR USE OF THESE MATERIALS. THE SOLE AND EXCLUSIVE

LIABILITY TO AUTODESK, INC., REGARDLESS OF THE FORM OF ACTION, SHALL NOT EXCEED THE PURCHASE PRICE OF THE

MATERIALS DESCRIBED HEREIN.

Autodesk, Inc., reserves the right to revise and improve its products as it sees fit. This publication describes the state of this product

at the time of its publication, and may not reflect the product at all times in the future.

AUTODESK TRADEMARKS

The following are registered trademarks of Autodesk, Inc., in the USA and/or other countries: 3D Props, 3D Studio, 3D Studio

MAX, 3D Studio VIZ, 3DSurfer, ActiveShapes, ActiveShapes (logo), Actrix, ADI, AEC Authority (logo), AEC-X, Animator Pro,

Animator Studio, ATC, AUGI, AutoCAD, AutoCAD LT, AutoCAD Map, Autodesk, Autodesk Inventor, Autodesk (logo), Autodesk

MapGuide, Autodesk Streamline, Autodesk University (logo), Autodesk View, Autodesk WalkThrough, Autodesk World, AutoLISP,

AutoSketch, Biped, bringing information down to earth, CAD Overlay, Character Studio, Cinepak, Cinepak (logo), Codec Central,

Combustion, Design Your World, Design Your World (logo), Discreet, EditDV, Education by Design, gmax, Heidi, HOOPS,

Hyperwire, i-drop, Inside Track, Kinetix, MaterialSpec, Mechanical Desktop, NAAUG, ObjectARX, PeopleTracker, Physique, Planix,

Powered with Autodesk Technology (logo), ProjectPoint, RadioRay, Reactor, Revit, Softdesk, Texture Universe, The AEC Authority,

The Auto Architect, VISION*, Visual, Visual Construction, Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual

Survey, Visual Toolbox, Visual TugBoat, Visual LISP, Volo, WHIP!, and WHIP! (logo).

The following are trademarks of Autodesk, Inc., in the USA and/or other countries: 3ds max, AutoCAD Architectural Desktop,

AutoCAD Learning Assistance, AutoCAD LT Learning Assistance, AutoCAD Simulator, AutoCAD SQL Extension, AutoCAD SQL

Interface, Autodesk Envision, Autodesk Map, AutoSnap, AutoTrack, Built with ObjectARX (logo), Burn, Buzzsaw, Buzzsaw.com,

Cinestream, Cleaner, Cleaner Central, ClearScale, Colour Warper, Content Explorer, Dancing Baby (image), DesignCenter,

Design Doctor, Designer's Toolkit, DesignProf, DesignServer, Design Web Format, DWF, DWG Linking, DXF, Extending the

Design Team, GDX Driver, gmax (logo), gmax ready (logo),Heads-up Design, IntroDV, jobnet, ObjectDBX, onscreen onair

online, Plans & Specs, Plasma, PolarSnap, Real-time Roto, Render Queue, Visual Bridge, Visual Syllabus, and Where Design

Connects.

Autodesk Canada Inc. Trademarks

The following are registered trademarks of Autodesk Canada Inc. in the USA and/or Canada, and/or other countries: discreet, fire,

flame, flint, flint RT, frost, glass, inferno, MountStone, riot, river, smoke, sparks, stone, stream, vapour, wire.

The following are trademarks of Autodesk Canada Inc., in the USA, Canada, and/or other countries: backburner, backdraft, Multi-

Master Editing.

THIRD-PARTY TRADEMARKS

All other brand names, product names, or trademarks belong to their respective holders.

THIRD-PARTY COPYRIGHT NOTICES

Portions of this product are distributed under license from D.C. Micro Development, © Copyright D.C. Micro Development. All

rights reserved.

GOVERNMENT USE

Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer

Software-Restricted Rights) and DFAR 227.7202 (Rights in Technical Data and Computer Software), as applicable.

iii

Contents

Chapter 1 Introduction . . . . . . . . . . . . . . . . . 1

About This Document . . . . . . . . . . . . . . . . . 2

What You Need to Know . . . . . . . . . . . . . . 2

Conventions . . . . . . . . . . . . . . . . . . 3

Copying Text from This Document . . . . . . . . . . . 3

Overview of Autodesk MapGuide LiteView . . . . . . . . . . 4

Features . . . . . . . . . . . . . . . . . . . . 4

Creating an Autodesk MapGuide LiteView Application. . . . . . . 6

Understanding Application Architecture . . . . . . . . . . . 7

Chapter 2 Understanding Requests . . . . . . . . . . . . . 9

Overview of Requests and Responses . . . . . . . . . . . 10

OpenGIS WMS 1.1.1 Compliance . . . . . . . . . . 10

Non-WMS 1.1.1-Compliant Parameters . . . . . . . . . 10

Creating a map Request . . . . . . . . . . . . . . . 10

Formatting a map Request . . . . . . . . . . . . . 11

Example of a Minimal Map Request . . . . . . . . . . 12

Overview of map Request Parameters . . . . . . . . . 13

Understanding map Request Parameters . . . . . . . . 15

Tips for Creating Map Requests . . . . . . . . . . . 22

Creating a feature_info Request . . . . . . . . . . . . . 22

Example of a feature_info Request . . . . . . . . . . 23

Positioning Feature Information . . . . . . . . . . . 23

Understanding feature_info Request Parameters . . . . . . 24

Interpreting Responses to a feature_info Request. . . . . . . . 26

Sample Response . . . . . . . . . . . . . . . . 27

feature_info Response DTDs . . . . . . . . . . . . 28

Chapter 3 Making GetCapabilities, GetMap, and GetFeatureInfo Requests . 35

Overview . . . . . . . . . . . . . . . . . . . . 36

GetCapabilities Requests . . . . . . . . . . . . . . . 36

GetCapabilities Request Parameters . . . . . . . . . . 37

GetCapabilities Metadata Response . . . . . . . . . . 37

GetMap Requests. . . . . . . . . . . . . . . . . . 44

GetMap Request Parameters . . . . . . . . . . . . 45

GetFeatureInfo Requests . . . . . . . . . . . . . . . 47

iv |Contents

GetFeatureInfo Request Parameters . . . . . . . . . . 47

Chapter 4 Configuring and Using the Sample Applications . . . . . . 49

The Sample Applications . . . . . . . . . . . . . . . 50

The WMS Viewer Sample Application . . . . . . . . . . . 50

Starting WMS Viewer . . . . . . . . . . . . . . 50

Extending WMS Viewer . . . . . . . . . . . . . . 51

Configuring WMS Viewer . . . . . . . . . . . . . 55

The ColdFusion Sample Application. . . . . . . . . . . . 55

ColdFusion Sample Application Files . . . . . . . . . 56

ColdFusion Sample Application Requirements . . . . . . 57

ColdFusion Sample Application Client Platforms. . . . . . 57

Configuring the ColdFusion Sample Application . . . . . . 58

Starting the ColdFusion Sample Application . . . . . . . 63

Removing the ColdFusion Sample Application Files . . . . . 64

Using the ColdFusion Sample Application . . . . . . . . 64

Troubleshooting and Other Resources . . . . . . . . . . . 77

Displaying Data by Layer . . . . . . . . . . . . . 77

Designing the Recenter Feature . . . . . . . . . . . 78

Accessing the GML DTD While Offline . . . . . . . . . 80

SRS-to-WKT Mapping . . . . . . . . . . . . . . 81

Where to Get More Information . . . . . . . . . . . 82

Index . . . . . . . . . . . . . . . . . . . . . . . . 87

In this chapter

■About this document

■Overview of Autodesk

MapGuide LiteView

■Creating an Autodesk

MapGuide LiteView

application

■Understanding application

architecture

Introduction

Autodesk MapGuide®LiteView is a platform-indepen-

dent viewing solution for Autodesk MapGuide®maps.

Deployed as a Java servlet, Autodesk MapGuide LiteView

serves interactive maps to most browsers—map users

don’t have to download or install a viewer. This chapter

includes general information about this guide and its

audience, an overview of Autodesk MapGuide LiteView

and its architecture, and the general steps you that take to

create an Autodesk MapGuide LiteView application.

2|Chapter 1 Introduction

About This Document

This guide is written for developers of Web sites that provide access to

Autodesk MapGuide maps. It describes Autodesk MapGuide LiteView, the

HTTP requests that are the basis of an Autodesk MapGuide LiteView applica-

tion, and the sample applications that you can use as models for creating

your own applications.

For information about installing and configuring Autodesk MapGuide Lite-

View, see the Autodesk MapGuide LiteView Servlet Administrator’s Guide. To

open that guide from the Windows desktop, choose Start ➤Programs ➤

Autodesk MapGuide Release 6.5 ➤LiteView 6.5 ➤Servlet Administrator’s

Guide.

In this document, Autodesk MapGuide LiteView is assumed to be installed in

the default folder, C:\Program Files\Autodesk\MapGuideLiteView6.5\, some-

times abbreviated to <InstallFolder>.

What You Need to Know

To get the most benefit from this guide, and to develop a robust application,

you must be proficient in one or more of the following technologies or

languages:

■Active Server Pages (ASP)

■Java Server Pages (JSP)

■JavaScript scripting

■Perl scripting

■Servlet technology

■Web-application architecture

■XML

You don’t need to know the Autodesk MapGuide Viewer API because you do

not call its methods to create an Autodesk MapGuide LiteView application.

If you want to use the ColdFusion sample application that’s included with

Autodesk MapGuide LiteView, you must be familiar with:

■Macromedia ColdFusion

■Apache XML projects such as Xerces XML parser and Xalan XSLT

stylesheet processor. For more information about these see

http://www.apache.org.

About This Document |3

This document assumes that you know how to create maps with Autodesk

MapGuide Author and have read the Autodesk MapGuide User’s Guide and

Autodesk MapGuide Help.

Conventions

The following syntax-diagram conventions are used in the of Web Map

Service (WMS) requests:

Copying Text from This Document

You can copy text from this PDF file and paste it into another application.

You may want to copy code samples for use in your own work, for example.

To copy text from a PDF file

1Click the Text Select tool on the Acrobat Reader toolbar.

2Drag to select the text you want to copy.

3Right-click and choose Copy from the shortcut menu.

The text is copied to the Clipboard.

Notations Used in Request Syntax

Notation Description

[ ] The argument or value is optional.

{a|b|c} A list of possibilities.

( ) A grouping. Typically used before an asterisk (*) or a

plus sign (+) to indicate a full subexpression.

* Zero or more occurrences of the previous

subexpression.

+ One or more occurrences of the previous

subexpression.

< > A variable argument or value.

Other notation A literal.

4|Chapter 1 Introduction

Overview of Autodesk MapGuide LiteView

Autodesk MapGuide LiteView extends the capabilities of Autodesk

MapGuide to display maps quickly in a browser without the need for a

special plug-in viewer. Autodesk MapGuide LiteView is a servlet—that is, a

Java program that runs on a server—that provides lightweight (fast, efficient,

and installation-free) viewing.

Autodesk MapGuide LiteView converts MWF files to PNG or JPEG files for

display in Microsoft Internet Explorer, Netscape Navigator, or any browser

that supports the PNG or JPEG format. A Web application that sends a

request to the Autodesk MapGuide LiteView servlet to convert an MWF file

to a PNG or JPEG file receives the converted image in the response.

Autodesk MapGuide LiteView understands all the enhancements to the

Autodesk MapGuide Release 6.5 MWF file format, and supports all coordi-

nate systems in which an MWF file can be authored. Autodesk MapGuide

LiteView supports GetCapabilities, GetMap, and GetFeatureInfo requests to

comply with the OpenGIS Web Map Service (WMS) 1.1.1 implementation

specification. You must register maps by using Autodesk MapGuide Lite-

View’s WMS Administrator before making WMS 1.1.1 requests.

Features

As a developer, the Autodesk MapGuide LiteView features of special interest

to you are:

■User-map interactivity—You can use the following URL parameters in

map requests to give users more opportunities to interact with a map:

❏SRS (Spatial Reference System) parameter—Overrides the Map Coor-

dinate System (MCS).

❏SELECT parameter—Supports selection of layer groups as well as the

selection of map features on layers.

❏HLS (Highlighting Line Styles) parameter—Supports up to four user-

defined highlighting styles that are used to select map features.

❏SYMBOLS parameter—Identifies one or more map locations by using

a user-defined symbol.

■Simplified installation and configuration—The Autodesk MapGuide

LiteView installation program prompts you for the most important

Autodesk MapGuide LiteView configuration parameters, configures

Apache Tomcat, and sets up Autodesk MapGuide LiteView so it is ready to

use. The ColdFusion and WMS Viewer sample application files are copied

Overview of Autodesk MapGuide LiteView |5

to the SampleApp and WmsViewer subfolders in the Autodesk MapGuide

LiteView installation folder on your hard drive.

■Fast map viewing—For first-time users or occasional users, it’s faster to

use a Autodesk MapGuide LiteView application to download and display

a raster image than it is to download and install a specialized viewer for

image display.

■Cross-platform deployment—Autodesk MapGuide LiteView responds to

HTTP requests for MWF files by returning images in PNG or JPEG format.

Most Web browsers on most platforms support these formats natively.

■Locked-down deployment—Many organizations prevent users from

downloading and installing viewers, such as ActiveX controls and Java

plug-ins, on their desktops. Applications written for Autodesk MapGuide

LiteView require no viewers.

6|Chapter 1 Introduction

Creating an Autodesk MapGuide LiteView

Application

You can use the sample applications provided with Autodesk MapGuide Lite-

View as starting points for creating your own Autodesk MapGuide LiteView

applications. This section describes the general steps to create an Autodesk

MapGuide LiteView application.

To create a Autodesk MapGuide LiteView application

1Refer to the Autodesk MapGuide LiteView Servlet Administrator’s Guide to

install and configure Autodesk MapGuide LiteView and the sample appli-

cations, and then run a sample application to see how it works.

2Learn the HTTP requests that the Autodesk MapGuide LiteView servlet

accepts. For information about requests, see Chapter 2, “Understanding

Requests,” on page 9, and Chapter 3, “Making GetCapabilities, GetMap,

and GetFeatureInfo Requests,” on page 35.

3Open a sample-application source file and inspect its code. See Chapter 4,

“Configuring and Using the Sample Applications,” on page 49.

4Read the sample-application source-code comments that explain how to

send get and post HTTP requests.

5Think of how you might adapt the application to suit your needs.

Autres manuels pour 15606-011408-9330 - MAPGUIDE R6.3 SITE LIC-UPG...

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Autodesk Logiciel

Autodesk

Autodesk ALIAS 2010 Manuel utilisateur

Autodesk

Autodesk TOPOBASE Manuel utilisateur

Autodesk

Autodesk 24108-051462-9000 - AUTOCAD REVIT ARCH STE 08 COMM NEW SLM... Mode d’emploi

Autodesk

Autodesk 057A1-09A111-1001 - AutoCAD LT 2009 Manuel utilisateur

Autodesk

Autodesk 256B1-05A761-1301 - AutoCAD Revit Structure Suite... Manuel utilisateur

Autodesk

Autodesk AUTOCAD 2010 - Manuel utilisateur

Autodesk

Autodesk 057A1-05A111-10MB - AutoCAD LT 2009 Manuel utilisateur

Autodesk

Autodesk ROBOT STRUCTURAL ANALYSIS PROFESSIONAL 2010 Manuel utilisateur

Autodesk

Autodesk AUTOCAD P AND ID 2010 Manuel utilisateur

Autodesk

Autodesk 657B1-000110-S001 - Maya - Mac Manuel utilisateur

Autodesk

Autodesk QUANTITY TAKEOFF 2010 Manuel utilisateur

Autodesk

Autodesk AUTODESK MUDBOX 2011 Manuel utilisateur

Autodesk

Autodesk 12812-051462-9011 - 3DS MAX 9 COM LEGACY SLM Instructions de fonctionnement

Autodesk

Autodesk ECOTECT ANALYSIS 2010 Manuel utilisateur

Autodesk

Autodesk 466B1-05A761-1304 - AutoCAD Inventor Simulation Suite... Manuel utilisateur

Autodesk

Autodesk 003A1-121111-1001 - AutoSketch v.9.0 Manuel utilisateur

Autodesk

Autodesk AUTOCAD 2006 Manuel d'utilisation

Autodesk

Autodesk 507B1-90A211-1301 - NavisWorks Manage 2010 Manuel utilisateur

Autodesk

Autodesk 18507-051452-9325 - UPG ARCH DESKTOP 2007 Manuel utilisateur

Autodesk

Autodesk CAICE VISUAL ROADS 10 Manuel utilisateur

Autodesk

Autodesk 24000-000000-9860 - Revit Architecture - PC Manuel utilisateur

Autodesk

Autodesk TASKalfa 2420w Manuel utilisateur

Autodesk

Autodesk AUTODESK ROBOT STRUCTURAL ANALYSIS PROFESSIONAL 2011 - SYSTEM... Manuel utilisateur

Autodesk

Autodesk 495B1-05A111-1301 - 3ds Max Design 2010 Manuel utilisateur

Manuels Logiciel populaires d'autres marques

COMPRO

COMPRO COMPROFM Manuel utilisateur

Muratec

Muratec OFFICEBRIDGE ONLINE Manuel utilisateur

Oracle

Oracle Contact Center Anywhere 8.1 Manuel utilisateur

Adobe

Adobe 65007312 - Photoshop Lightroom Manuel

Avaya

Avaya NULL One-X for RIM Blackberry Manuel utilisateur

HP ProLiant BL420c Manuel utilisateur

PS Audio

PS Audio PowerPlay Manuel du propriétaire

Brady

Brady LOCKOUT PRO 3.0 Manuel de service

Avaya

Avaya Interaction Center Manuel utilisateur

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuel

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuel utilisateur

Oracle

Oracle Application 9i Manuel utilisateur

Acer

Acer RDM Manuel utilisateur

Canon

Canon Vixia HF21 Manuel utilisateur

Canon

Canon ZR950 Manuel utilisateur

Samsung

Samsung Auto Backup Manuel utilisateur

Polycom

Polycom Vortex EF2201 Instructions d'installation et d'utilisation

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuel utilisateur