3.1.4 Map Response DTD

The following is the DTD for the map response resulting from normal processing of a map request. (MapViewer Exception DTD shows the DTD for the response if there was an exception or unrecoverable error.)

<!ELEMENT map_response (map_image)>
<!ELEMENT map_image (map_content, box, themes, WMTException)>
<!ELEMENT map_content EMPTY>
<!ATTLIST map_content url CDATA #REQUIRED>
<!ELEMENT WMTException (#PCDATA)>
<!ATTLIST WMTException version CDATA "1.0.0"
  error_code (SUCCESS|FAILURE) #REQUIRED
>

The response includes the URL for retrieving the image, as well as any error information. When a valid map is generated, its minimum bounding box is also returned, along with the list of themes that have features within the minimum bounding rectangle (MBR) that intersects with the bounding box.

Example 3-25 shows a map response.

Example 3-25 Map Response

<?xml version="1.0" encoding="UTF-8"?>
<map_response>
    <map_image>
        <map_content url="http://map.oracle.com/output/map029763.gif" />
        <box srsName="default">
            <coordinates>-122.260443,37.531621 -120.345,39.543</coordinates>
        </box>
        <themes>
            <theme name="US_STATES" />
            <theme name="US_HIGHWAYS" />
        </themes>
        <WMTException version="1.0.0"
                      error_code="SUCCESS" />
    </map_image>
</map_response>