Rendering Images and Retrieving Additional Image Infomation
You can render an image map with the renderImageMap operation. The image itself is buffered on the server and can be retrieved with a getBufferedBitmapImage operation. The renderImageMap operation returns additional information about the image such as the bounds of the rendered map image.
The general structure of the operation in the WSDL file of the Map24 MGI Service is shown in the following listing:
...
<message name="renderImageMapRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="RenderImageMapRequest" type="tns:RenderImageMapRequest" />
</message>
<message name="renderImageMapResponse" >
<part name="RenderImageMapResonse" type="tns:RenderImageMapResponse" />
</message>
<portType name="Map24MGIPortType" >
<operation name="renderImageMap" >
<input message="tns:renderImageMapRequest" />
<output message="tns:renderImageMapResponse" />
</operation>
...
</portType>
...
Request
The RenderImageMapRequest element contains the parameters of the renderBitmapImage operation.
For HTTP GET requests the operation is called renderMapImage (action=renderMapImage), which is the same as for the renderBitmapImage operation. For creating an image map, the mime type must be set to "imap/csv" in the HTTP GET request parameters (see BitmapDescriptor).
| Field |
Description |
HTTP GET Parameter |
| BitmapDescriptor |
A BitmapDescriptor element for setting the attributes for the image to be rendered. |
See BitmapDescriptor. |
| ReplyBitmapData |
If TRUE, the binary image data will be returned in the response. Otherwise, it will be stored on the server, and can be retrieved with a getBufferedBitmapImage request. |
Not supported. |
| ImageKey |
An integer value that is unique within your Map24 session. This field must only be set if you have set ReplyBitmapData to FALSE. |
imgkey |
| Properties |
Additional settings (key-value pairs) for the rendering of the bitmap image that are not contained in the BitmapDescriptor. |
Not supported. |
Response
RenderImageMapResponse is the response of a renderImageMap operation.
| Field |
Description |
| BitmapDescriptor |
A BitmapDescriptor element with the same contents as specified in the request. |
| BitmapData |
If ReplyBitmapData was set to TRUE in the request, this field contains the base64-encoded binary bitmap image. |
| ImageKey |
If ReplyBitmapData was set to FALSE in the request, this field contains the ImageKey that was specified in the request and that identifies the buffered image on the server. |
| ImageMap |
An ImageMap element that contains metadata about the rendered image.
|
Example Requests
An example SOAP request is provided here.
An example HTTP GET request is provided here.
|
