You are here: Using SOAP > v2006 services > Map Image > Map Image v2006 notes

Map Image Web Service v2006 notes

Thematic mapping	Imagery data	Converting shapes to Geometry
Credit costs	Valid data sources for SVG and SWF	Saved maps
Polygon holes	Valid icons for SVG and SWF	ArcWeb map icons
Line shape examples	PixelCoord
Default extent	Data collection date

Thematic mapping

A thematic map conveys information about a single topic or theme such as population by census tract or sales revenue by ZIP Code. Map Image Web Service offers three methods for creating various forms of thematic maps—getValueMap, getCustomThematicMap, and getESRIThematicMap. Below are tips on using each of these thematic map methods.

Use the method getValueMap to create a value map that renders certain geographic features (such as counties or ZIP Codes) with specific colors. The object ThematicData should consist of the geographic feature’s FIPS code and a lookup value for each feature that you would like rendered. The method input getValueMap.colorCodeValues contains the lookup value specified in the object ThematicData as well as the color value for each lookup value's feature.
Use the method getCustomThematicMap to create a thematic map based on variables that you supply (such as sales revenue) which correspond with certain geographic features (such as counties or ZIP Codes). With this method you also define the classification scheme. The object ThematicData should consist of the geographic features’ FIPS codes and the associated thematic values that you supply (such as sales revenue). The object ThematicOptions contains information on how the thematic classifications should be broken up and the object ThematicColors specifies what colors to use for each classification.
Use the method getESRIThematicMap to create a thematic map based on variables supplied by ESRI (such as population) which correspond with certain geographic features (such as counties or ZIP Codes). With this method you also define the classification scheme. The object ThematicOptions contains information on how the thematic classifications should be broken up and the object ThematicColors specifies what colors to use for each classification. ArcWeb retrieves the variables from the fields you specific in the method input getESRIThematicMap.thematicField.

Credit costs

Use the SOAP credit calculator to see specific credit costs for Map Image requests. You can also use the Support credit calculator to quickly see general costs.

Imagery map cost is based on pixel size. Large maps contain up to 1,000,000 pixels; medium maps contain up to 360,000 pixels, and small maps contains up to 40,000 pixels. The type of imagery (premium, US, or world) determines the cost at each size.
Fused maps cost 0.5 credits, regardless of the credit costs associated with the generation of each individual input map image. See the method getFusedMapImage method description for information on creating a fused map image.
Retrieving saved maps cost the same as the cost of generating the original map. See the method getSavedMap description for information on saving maps.

How to create a "hole" in a polygon

You can create a "donut hole polygon" by using the object PolygonDesc to create a single geometry object. Set one part to specify the outer boundary of the polygon. Set another part to determine the boundary of the hole. The hole's boundary points must be ordered in the opposite direction from the polygon's points (in other words, counter-clockwise vs. clockwise).

Graphic examples of line shapes


Images of LineDesc:endType values	Images of LineDesc:jointType values

Default extent of a data source

To see the default extent of a data source, use the methods getBestMap or getBestMapArea without specifying any acetates (circles, lines, polygons, points, or markers) in the object MapImageOptions.

Imagery data sources are best viewed as JPEG files

Data sources that present imagery content, such as ArcWeb:Pixxures.DOQQ.US and ArcWeb:NGS.Topo.US, look best when the file format is JPEG. SVG and SWF (Flash) formats do not currently support imagery data.

Valid data sources for SVG and SWF maps

SVG and SWF (Flash) image formats support the same data sources as REST mapping. See REST mapping for a list of valid data sources to use with SVG and SWF maps.

Valid icons for SVG and SWF maps

SVG and SWF (Flash) image formats support only the icons listed under REST on the ArcWeb map icons page.

PixelCoord

The PixelCoord object is a location in pixels on a map image. For example, if you have a map that is 400x400 pixels, the map's upper left pixel is the PixelCoord (0,0) and the upper right pixel is the PixelCoord (399,0).

Data collection date

Use Utility Web Service method getDataCollectionDate to see the latest collection or processing date for data within a specified extent. Currently, you can use this feature for ArcWeb:GlobeXplorer.*.* data sources.

Converting shapes to Geometry

Use Utility Web Service to convert various shapes to Geometry objects. See Utility Web Service methods for details.

Saved maps

You may receive an error if you request a saved map immediately after saving it. If this occurs, wait a moment and try your request again.

ArcWeb map icons

For information on valid ArcWeb map icons, see ArcWeb map icons.

Visit the Feedback page to give comments or suggestions about the ArcWeb Developer's Guide.

ArcWeb site | ArcWeb support | support.esri.com