Controlling Map Components
Here it is described in detail how to set properties of map components. Most of the map components are GUI controls on top of the map such as the toolbar, the map overview window, or the scalebar. Users of the Map24 mapping client can use these components to control the behavior of the map. For example, the toolbar provides buttons that can be used for panning or zooming the map view.
When sending SOAP requests map components are controlled with the ControlComponent MRC command. The ControlComponent command can be used to
- Set the visibility of map components.
- Set additional properties for map components. Some map components allow or even require you to set additional properties. For example, the route flight control needs the ID of a calculated route to be able to perform a route flight.
For HTTP GET requests the equivalent commands are SHOWCOMPONENT for showing a map component, or HIDECOMPONENT for hiding a map component. With HTTP GET requests it is possible to set the visibility of a map component, but no further properties.
The following table lists all available map components and their abbreviation. The abbreviation is used in the ControlComponent command to specify the map component.
| Abbreviation |
Map Component |
| MRC |
The MRC component. Note that this map component is no GUI control. Instead, it is a client-side control that receives and processes MRC commands from the Map24 MRC Service. Here the ControlComponent command is not used for defining the visibility of the control, but for defining other properties.
See Properties of the MRC Component |
| TBAR |
The toolbar. |
| SHOWTBAR |
The button for showing the toolbar. |
| OV |
The overview map that shows the geographical neighbourhood of the view that is currently displayed in the main panel. |
| SHOWOV |
The button for showing the overview map. |
| M3D |
A map control that shows the current map surface in three dimensions. In this document the control is called "3D view" for brevity. It allows to rotate the map view in the main panel about the x-axis and the z-axis. |
| SHOWM3D |
The button for showing the 3D view. |
| M3DROUTE |
The route flight control. The route flight control needs the ID of a calculated route to be able to perform a route flight. It is possible to set further properties.
See Properties of the Route Flight Control |
| SHOWM3DROUTE |
The button for showing the route flight control. |
| TILES |
Map component for enabling the satellite view of the map. If the satellite view is enabled, instead of a map a satellite image of the geographical area is shown. It is possible to set further porperties.
See Properties of the Tiles Component. |
CMU
|
The course marker allows users to easily draw routes on the map. See The Course Marker. |
SOAP Examples
A large set of example SOAP requests is provided here.
HTTP GET Examples
HTTP Get example requests are provided here.
Related Topics
With the ControlComponent command it is also possible to trigger toolbar actions. Examples are: Zooming the map view in or out, or going back in the history of previously shown map views.
See Triggering Toolbar Actions
|
