MapGuide Maestro Developer Documentation

This page describes how to use the MaestroAPI from the MapGuide Maestro project in your own application.

The official API for MapGuide is a wrapper for the C++ classes, and focuses on portability and map interactions with the displayed map. The MapGuide server has a large set of functionality that handles authoring and managing maps and spatial data. This functionality is only exposed through a few methods that allow reading and writing of Xml. The C++ classes are wrapped for PHP and Java as well as for .Net. This means that they do not support native streams or other .Net components. The C++ classes communicate with the MapGuide server through a dedicated port. This means that it is only possible to interact with servers on the local intranet (opening the port is not recommended for security reasons).

The MaestroAPI attempts to deal with those shortcommings. It exposes all the Xml structures in the MapGuide server as managed .Net classes. It reads and writes .Net native streams and documents. Finally it has an optional usage that will communicate with the standard installation of the Web server through regular http communcation. This last point makes it possible to write standalone applications that manage the server, just like the MapGuide Maestro application does.

The developer contents currently consists of the following pages:

• Basic MaestroAPI Basic explanation of the MaestroAPI and features.
• Code overview An explanation of different parts of the MaestroAPI.
• ​MaestroAPI.chm A compiled help document describing the MaestroAPI details (If you are unable to use it, try rightclicking the file and select "Unblock").

If you want some extra information or explanations, please ask at the MapGuide Users Mailing list. You may add your own examples of MaestroAPI usage here:

• Utilizing RuntimeMap via Maestro API - a short example of getting to RuntimeMap instance.
• Adding a layer before startup via Maestro API - an example of how to add a layer to map before the viewer loads.
• Creating a temporary WebLayout with customized zoom - shows how to modify an existing WebLayout to select the initial zoom level.
• Modifying the filter on a layer - shows how to modify the filter on a layer for the current user.
• Add your cool sample here You must be logged in with an ​OSGeo ID before you can edit the page.