renderInlineNamedMap

Description

Returns a map generated from an inline map definition of a named map and a map view. You must define the map view outside of the named map definition. The map view defined in the SOAP request will control the output map image, even if a map view (display conditions) are defined in the named map.

ACL Authorization Flow

To return a map generated from an inline map definition of a named map and a map view, the user (or any roles they belong to) will need Execute permission on the named tables (NamedDataSourceDefinitions) in the following manner:

  • “EXECUTE” for entity type “Location Intelligence.Named Resources”
Note: A remote call is made to resolve top level resources specified in the Named Map and then all the resources are filtered with EXECUTE permission. If the named map contains a mix of Named Layers and inline layers referencing tables then resources may include both layers and tables at top level.

Permission is only checked on those NamedDataSourceDefinitions which have been used to render the map.

Messages

The following table lists the request and response messages for the renderInlineNamedMap operation.

Click on a message name to get more information about the message.

Message Description
RenderInlineNamedMapRequest The request message for the renderInlineNamedMap operation.
RenderInlineNamedMapResponse The response message for the renderInlineNamedMap operation.

Example

Returns a map image generated from an inline map definition of a named map and a map view.



<?xml version="1.0"?> 
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.mapinfo.com/midev/service/mapping/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns3="http://www.mapinfo.com/midev/service/geometries/v1"> 
  <S:Header/> 
  <S:Body> 
    <v1:RenderInlineNamedMapRequest imageMimeType="image/png" returnImage="false"> 
      <v1:MapView xsi:type="v1:ZoomAndCenterMapView"> 
        <v1:Width>800.0</v1:Width> 
        <v1:Height>600.0</v1:Height> 
        <v1:ZoomLevel uom="Mile">3000.0</v1:ZoomLevel> 
        <v1:MapCenter srsName="epsg:4269"> 
          <ns3:Pos> 
            <ns3:X>-101.244772</ns3:X>   
            <ns3:Y>41.614746</ns3:Y>  
          </ns3:Pos> 
        </v1:MapCenter> 
      </v1:MapView> 
      <v1:InlineNamedMap> 
        <NamedMapDefinition version="MXP_WorkSpace_1_5" xmlns="http://www.mapinfo.com/mxp" xmlns:gml="http://www.opengis.net/gml"> 
          <ConnectionSet /> 
          <DataSourceDefinitionSet> 
            <NamedDataSourceDefinitionRef id="id1" resourceID="/Samples/NamedTables/Interstates"/> 
            <NamedDataSourceDefinitionRef id="id2" resourceID="/Samples/NamedTables/MississippiRiver"/> 
            <NamedDataSourceDefinitionRef id="id4" resourceID="/Samples/NamedTables/USA_CAPS"/> 
            <NamedDataSourceDefinitionRef id="id11" resourceID="/Samples/NamedTables/USA"/> 
          </DataSourceDefinitionSet> 
          <MapDefinition id="id5" name="MyMap" alias=""> 
            <DisplayConditions> 
              <MapSize uom="mapinfo:imagesize pixel"> 
                <ImageWidth>960</ImageWidth> 
                <ImageHeight>800</ImageHeight> 
              </MapSize> 
              <ZoomAndCenter> 
                <MapZoom uom="mapinfo:length mi">28014.44036</MapZoom> 
                <gml:Point srsName="mapinfo:coordsys 12,62,7,0"> 
                  <gml:coordinates>-5.4419258,0</gml:coordinates> 
                </gml:Point> 
              </ZoomAndCenter> 
              <DisplayCoordSys> 
                <SRSName>mapinfo:coordsys 12,62,7,0</SRSName> 
              </DisplayCoordSys> 
              <ResizeMethod>preserveZoom</ResizeMethod> 
              <RasterConditions dither="halfTone" rasterReprojectionResampling="cubicConvolution" 
                        rasterReprojection="none" trueColor="true" optimizeRasterLayers="screen" 
                        optimizeVectorLayers="screen"/> 
              <RenderingOptions enableOpacity="true"/> 
            </DisplayConditions> 
            <LayerList> 
              <FeatureLayer id="id7" name="USA Capitals" alias="usacap" volatile="unknown"> 
                <Visibility visible="true"> 
                  <VisibleRange enabled="false"> 
                    <ZoomRange uom="mapinfo:length mi">0 0</ZoomRange> 
                  </VisibleRange> 
                </Visibility> 
                <DataSourceRef ref="id4" /> 
              </FeatureLayer> 
              <FeatureLayer id="id8" name="Interstates" alias="Interstates" volatile="unknown"> 
                <Visibility visible="true"> 
                  <VisibleRange enabled="false"> 
                    <ZoomRange uom="mapinfo:length mi">0 0</ZoomRange> 
                  </VisibleRange> 
                </Visibility> 
                <DataSourceRef ref="id1" /> 
              </FeatureLayer> 
              <FeatureLayer id="id9" name="USA States" alias="usa" volatile="unknown"> 
                <Visibility visible="true"> 
                  <VisibleRange enabled="false"> 
                    <ZoomRange uom="mapinfo:length mi">0 0</ZoomRange> 
                  </VisibleRange> 
                </Visibility> 
                <DataSourceRef ref="id11"/> 
              </FeatureLayer> 
              <FeatureLayer id="id10" name="MississippiRiver" alias="MississippiRiver" volatile="unknown"> 
                <Visibility visible="true"> 
                  <VisibleRange enabled="false"> 
                    <ZoomRange uom="mapinfo:length mi">0 0</ZoomRange> 
                  </VisibleRange> 
                </Visibility> 
                <DataSourceRef ref="id2" /> 
              </FeatureLayer> 
            </LayerList> 
          </MapDefinition> 
        </NamedMapDefinition> 
      </v1:InlineNamedMap> 
    </v1:RenderInlineNamedMapRequest> 
  </S:Body> 
</S:Envelope>