Rendering Images and Retrieving the Image Data
The renderBitmapImage operation renders static bitmap images. The image is returned in the response. The structure of the operation in the WSDL file of the Map24 MGI Service is shown in the following listing:
...
<message name="renderBitmapImageRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="RenderBitmapImageRequest" type="tns:RenderBitmapImageRequest" />
</message>
<message name="renderBitmapImageResponse" >
<part name="GetBitmapImageResonse" type="tns:RenderBitmapImageResponse" />
</message>
<portType name="Map24MGIPortType" >
<operation name="renderBitmapImage" >
<input message="tns:renderBitmapImageRequest" />
<output message="tns:renderBitmapImageResponse" />
</operation>
...
</portType>
...
Request
RenderBitmapImageRequest contains the parameters for the renderBitmapImage operation.
For HTTP GET requests the operation is called renderMapImage (action=renderMapImage).
| Field |
Description |
HTTP GET Parameter |
| BitmapDescriptor |
A BitmapDescriptor element containing the attributes for the image to be rendered. |
See BitmapDescriptor. |
| MRC |
A Map24MRC element for executing MRC commands before rendering the image.
|
MRC commands, for example ADD for adding a Map24 Location. The HTTP GET requests and parameters are described in the Map24 Maplet Remote Control User's Guide.
|
| Properties |
Additional settings (key-value pairs) for the rendering of the bitmap image that are not contained in the BitmapDescriptor. The properties are listed in the following table.
|
prop:<property>
|
Properties of the RenderBitmapImageRequest:
| Key |
Description |
Values |
HTTP GET Parameter |
| DPI |
Resolution of the image in dots per inch (dpi). |
from 72 (default) to 600 dpi |
DPI |
| gamma |
The gamma value used to set the luminance of the image. |
0 -7 |
gamma |
| mime |
The actual output MIME type of the image. Wbmp is a WAP format for mobile phones etc., imap/csv is a text based internet format. It will return text based data and an image. |
image/png | image/gif (default) | image/jpg | image/jpeg | image/vnd.wap.wbmp | imap/csv |
mime |
| dither |
Only used for mono (black and white) images: 1: Enables Floyd-Steinberg dithering; 0: Disables dithering. |
1 | 0 |
dither |
| logo_dpi |
Resolution of the Map24 Locations that are pushed onto the map (in dpi). |
from 72 (default) to 600 dpi |
logo_dpi |
| distanceunit |
The distance unit of the scale bar. metric: meters and kilometers; english:feet and miles. |
metric (default) | english |
distanceunit |
Response
RenderBitmapImageResponse contains the result of a renderBitmapImage operation.
| Field |
Description |
| BitmapDescriptor |
Deliveres the same data that was provided in the BitmapDescriptor element of the request. |
| BitmapData |
The image data of type base64Binary. |
SOAP Example
An example SOAP request is provided here.
HTTP GET Example
An example HTTP GET request is provided here.
|
