Packagecom.esri.aws.services
Interfacepublic interface IMapImage

More map content for your Internet applications. Map Image Web Service accesses data from several leading data publishers. Based on ArcWeb Services Map Image web service. Requires MapImageActivator in Framework.

View the examples.

See also

MapImageActivator
More about Map Image
Available data sources


Public Methods
 MethodDefined by
  
getCustomThematicMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicData:ThematicData, thematicOptions:ThematicOptions, thematicColors:ThematicColors, responder:IResponder):void
Returns a thematic map based on user-supplied data that match specific geography IDs.
IMapImage
  
getESRIThematicMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicField:String, thematicOptions:ThematicOptions, thematicColors:ThematicColors, responder:IResponder):void
Returns a thematic map based on ESRI-supplied variables.
IMapImage
  
getMap(mapArea:MapArea, mapImageOptions:MapImageOptions, responder:IResponder):void
Returns map URLs for given map areas.
IMapImage
  
getThematicFields(thematicDataSource:String, responder:IResponder):void
Returns a list of available fields for creating a thematic map with the method getESRIThematicMap.
IMapImage
  
getValueMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicData:ThematicData, codeColorValues:Array, thematicOptions:ThematicOptions, responder:IResponder):void
Returns a value map based on user-supplied data that matches specific geography IDs.
IMapImage
Method detail
getCustomThematicMap()method
public function getCustomThematicMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicData:ThematicData, thematicOptions:ThematicOptions, thematicColors:ThematicColors, responder:IResponder):void

Returns a thematic map based on user-supplied data that match specific geography IDs. Coloring of each region is based on ESRI class breaks.

Parameters
mapArea:MapArea — MapArea parameters
 
mapImageOptions:MapImageOptions — MapImageOptions parameters.

Must use one of the following thematic map data sources for the dataSource value:
"ArcWeb:ESRI.DemographicsByBlockGroup.US"
"ArcWeb:ESRI.DemographicsByCounty.US"
"ArcWeb:ESRI.DemographicsByState.US"
"ArcWeb:ESRI.DemographicsByTract.US"
"ArcWeb:ESRI.DemographicsByZipCode.US"

 
thematicData:ThematicData — ThematicData parameters
 
thematicOptions:ThematicOptions — ThematicOptions parameters
 
thematicColors:ThematicColors — ThematicColors parameters
 
responder:IResponder — The IResponder object to be called when the SOAP request returns\fails
getESRIThematicMap()method 
public function getESRIThematicMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicField:String, thematicOptions:ThematicOptions, thematicColors:ThematicColors, responder:IResponder):void

Returns a thematic map based on ESRI-supplied variables. Coloring of each region is based on ESRI class breaks.

Parameters
mapArea:MapArea — MapArea parameters
 
mapImageOptions:MapImageOptions — MapImageOptions parameters.

Must use one of the following thematic map data sources for the dataSource value:
"ArcWeb:ESRI.DemographicsByBlockGroup.US"
"ArcWeb:ESRI.DemographicsByCounty.US"
"ArcWeb:ESRI.DemographicsByState.US"
"ArcWeb:ESRI.DemographicsByTract.US"
"ArcWeb:ESRI.DemographicsByZipCode.US"

 
thematicField:String — the thematic field (i.e. variable name)
 
thematicOptions:ThematicOptions — ThematicOptions parameters
 
thematicColors:ThematicColors — ThematicColors parameters
 
responder:IResponder — The IResponder object to be called when the SOAP request returns\fails
getMap()method 
public function getMap(mapArea:MapArea, mapImageOptions:MapImageOptions, responder:IResponder):void

Returns map URLs for given map areas.

Parameters
mapArea:MapArea — MapArea parameters.
 
mapImageOptions:MapImageOptions — MapImageOptions parameters.
 
responder:IResponder — The user-defined IResponder object to be called when the SOAP request returns\fails

See also

getThematicFields()method 
public function getThematicFields(thematicDataSource:String, responder:IResponder):void

Returns a list of available fields for creating a thematic map with the method getESRIThematicMap.

Parameters
thematicDataSource:String

Must use one of the following thematic map data sources for the dataSource value:
"ArcWeb:ESRI.DemographicsByBlockGroup.US"
"ArcWeb:ESRI.DemographicsByCounty.US"
"ArcWeb:ESRI.DemographicsByState.US"
"ArcWeb:ESRI.DemographicsByTract.US"
"ArcWeb:ESRI.DemographicsByZipCode.US"

 
responder:IResponder — The IResponder object to be called when the SOAP request returns\fails
getValueMap()method 
public function getValueMap(mapArea:MapArea, mapImageOptions:MapImageOptions, thematicData:ThematicData, codeColorValues:Array, thematicOptions:ThematicOptions, responder:IResponder):void

Returns a value map based on user-supplied data that matches specific geography IDs. The user determines the color of each region

Parameters
mapArea:MapArea — MapArea parameters
 
mapImageOptions:MapImageOptions — MapImageOptions parameters.

Must use one of the following thematic map data sources for the dataSource value:
"ArcWeb:ESRI.DemographicsByBlockGroup.US"
"ArcWeb:ESRI.DemographicsByCounty.US"
"ArcWeb:ESRI.DemographicsByState.US"
"ArcWeb:ESRI.DemographicsByTract.US"
"ArcWeb:ESRI.DemographicsByZipCode.US"

 
thematicData:ThematicData — ThematicData parameters
 
codeColorValues:Array — key needs to match ThematicData.data value. value is any RGB color string.
 
thematicOptions:ThematicOptions — ThematicOptions parameters
 
responder:IResponder — The IResponder object to be called when the SOAP request returns\fails
Examples
Basic_MapImage
<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
    xmlns:awx="http://www.arcwebservices.com/2007/awx"
    implements="mx.rpc.IResponder"
    creationComplete="onComplete()"
    >
    
    <mx:Script>
        <![CDATA[
            import com.esri.aws.awx.geom.GeoPoint;
            import com.esri.aws.osgi.framework.ServiceTracker;
            import com.esri.aws.services.MapImageInfo;
            import com.esri.aws.services.MapImageOptions;
            import com.esri.aws.services.MapArea;
            import com.esri.aws.services.IMapImage;
            import com.esri.aws.osgi.framework.IServiceReference;
            import flash.utils.getQualifiedClassName;
            import mx.controls.Alert;
            
            private var imageTracker:ServiceTracker;
            
            private function onComplete():void
            {
                imageTracker = new ServiceTracker(framework.systemContext, getQualifiedClassName(IMapImage));
                imageTracker.open();                
            }
            
            public function getMap():void
            {
                var imageService:IMapImage = imageTracker.getService() as IMapImage
                
                if (imageService)
                {
                    // build map area
                    var mapArea:MapArea = new MapArea();
                    mapArea.center = new GeoPoint(-117, 34);
                    mapArea.scale = 1000000;
                    
                    // build options
                    var mapImageOptions:MapImageOptions = new MapImageOptions();
                    mapImageOptions.width = 640;
                    mapImageOptions.height = 480;
                    mapImageOptions.mapImageFormat = "png";
                    mapImageOptions.dataSource = "ArcWeb:TA.Streets.US";
                    
                    // call the MapImage service using 'this' as the responder.
                    imageService.getMap(mapArea, mapImageOptions, this);
                    info.visible = true;
                }
            }
            
            public function result(data:Object):void
            {
                var mapImageInfo:MapImageInfo = MapImageInfo(data);
                image.source = mapImageInfo.mapURL;
                info.visible = false;
            }
            
            public function fault(info:Object):void
            {
                Alert.show(info.toString());
            }
        ]]>
    </mx:Script>
    
    <awx:Framework id="framework" apiKey="[MY-API-KEY]" frameworkStart="getMap()">
        <awx:MapImageActivator/>
    </awx:Framework>
    
    <mx:Text id="info" fontSize="14" top="80" text="Sending request ..." visible="false"/>
    
    <mx:Image id="image"/>
    
</mx:Application>