Creating Templates
The declareMapTPMapLayerTemplates operation creates templates for all or some of the map objects within a DMap layer. The templates are uploaded to the server and can be retrieved with a getMapTPTemplatesRequest operation.
In principle, a template created with the declareMapTPMapLayerTemplates operation is a map object that is stored on the server. For example, a template for a location can be created just like a Map24 Location in the Map24 Maplet Remote Control Service with a DeclareMap24Location command.
You can use a template to define the default values of some or all map objects within a layer. This is useful if you want to create multiple map objects with the same attributes. For example, you can create a template for polygons with a yellow partly transparent fill color, and a light blue border. Then you can create polygons and assign them to the template. The polygons will be shown with the defined fill and border colors.
The following listing shows the general structure of the operation in the WSDL file of the Map24 MapTPMap Service:
...
<message name="declareMapTPMapLayerTemplatesRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="DeclareMapTPMapLayerTemplatesRequest" type="tns:DeclareMapTPMapLayerTemplatesRequest" />
</message>
<message name="declareMapTPMapLayerTemplatesResponse" >
<part name="DeclareMapTPMapLayerTemplatesResponse" type="tns:MapTPMapUploadResponse" />
</message>
<portType name="Map24MapTPMapServicePortType" >
<operation name="declareMapTPMapLayerTemplates" >
<input message="tns:declareMapTPMapLayerTemplatesRequest" />
<output message="tns:declareMapTPMapLayerTemplatesResponse" />
</operation>
</portType>
...
Request
The DeclareMapTPMapLayerTemplatesRequest element contains the parameters for the declareMapTPMapLayerTemplates operation.
| Field |
Description
|
| MapName |
The DMap for which layer templates are uploaded. |
| MapTPMapLocationTemplates |
Adds templates for location layers to the given map on the server. This field is of type DeclareMap24Location. |
| MapTPMapPolylineTemplates |
Adds templates for polyline layers to the given map on the server. This field is of type DeclareMap24Polyline. |
| MapTPMapPolygonTemplates |
Adds templates for polygon layers to the given map on the server. This field is of type DeclareMap24Polygon. If no FillPaintRules are set a default FillPaintRule is used with the default values MaxMPP: 10000 and MinMPP: 0. The setting in the DeclareMap24Polygon.FillColor field is used as fill color. |
| MapTPMapTemplateAssignments |
Array that is used to define the map objects for which the template is created. The template will be applied to these map objects only. |
Response
The response is of type MapTPMapUploadResponse. Besides the ResponseHeader the response of an uploadMapTPMapFromHTTPResource operation does not contain any data.
Examples
An example request is provided here.
|
