MapStyle Enumeration

Article
03/16/2007

The possible map styles to use for rendering a map. The following table shows the data sources for which a MapStyle enumeration member is valid and the default map style for each data source.


Public Enum MapStyle
    Member of [Namespace]


[C#]

public enum MapStyle : System.Enum
    Member of [Namespace]

Remarks

The following table lists the values for the MapStyle enumeration.

Name	Description
Climate	Characteristic climate for areas on the Earth, defined by long-term weather patterns. Color.
Comprehensive	For the MapPoint.World data source, contains several categories of information for purposes of general reference, including topographic, political, and geographic information. Color. For the MapPoint.Moon data source, contains views of the moon as a composite of satellite images, including identification of craters, landing sites, and lunar seas. Color.
DefaultStyle	Default map style for a data source.
EarthByDay	Idealized map of the Earth as it looks from space in daylight without clouds, as a composite of satellite images. Color.
EarthByNight	Idealized map of the Earth as it looks from space at night without clouds, as a composite of satellite images. Color.
Ecoregions	Landscapes, such as forests, woodlands, grasslands, deserts, and ice. Color.
Europe	Maps drawn with a color scheme common in European maps.
Languages	Language spoken by a majority of people in an area. Color.
Locator	Roads and some political geographies, optimized for overview maps. Color.
LocatorBW	Roads and some political geographies, optimized for overview maps. High contrast for black and white printing.
Night	A map designed for viewing in low-light conditions.
Outline	Current borders of the world's sovereign nations and their dependencies, and at higher resolutions, borders between states, provinces, or other internal subdivisions. Also indicated are names and locations of selected cities and towns; rivers, lakes, and seas; and mountains, plateaus, deserts, and other physical features. Color.
Parks	Significant protected areas, such as World Heritage Sites; national, provincial, and state parks; other major reserves; and territories reserved for indigenous peoples in the Americas. Color.
Phone	Shows roads and political geographies, optimized for small screens (size ranged from 101 x 80 pixels to 176 x 220 pixels). Color.
PhoneBW	Shows roads and political geographies, optimized for small screens (size ranged from 101 x 80 pixels to 176 x 220 pixels). High contrast for black and white printing.
PhysicalFeatures	Landforms and water bodies. Color.
Political	Political geography; political entities are shown in contrasting colors for emphasis. Color.
PoliticalBW	Political geography; political entities are shown in outline. High contrast for black and white printing.
PopulationDensity	Number of people per square kilometer throughout the world. Color.
PrecipitationAnnual	Average accumulation of rain or snow over an entire year. Color.
PrecipitationJanuary	Average accumulation of rain or snow during the month of January. Color.
PrecipitationJuly	Average accumulation of rain or snow during the month of July. Color.
Religions	Distribution of the adherents of the world's major regions. Color.
Road	Roads, highways, towns, and cities. Color.
RoadBW	Roads, highways, towns, and cities. High contrast for black and white printing.
Small	Roads and political geographies, optimized for low resolution maps. Color.
SmallBW	Roads and political geographies, optimized for low resolution maps. High contrast for black and white printing.
Tectonic	Distribution of plates that make up the Earth's crust, location of volcanoes and earthquakes, and age of the floor beneath the seas. Color.
TemperatureJanuary	Average air temperature during the month of January. Color.
TemperatureJuly	Average air temperature during the month of July. Color.
Terrain	Roads, highways, towns, cities, and geographic terrain. Color.
TerrainBW	Roads, highways, towns, cities, and geographic terrain. High contrast for black and white printing.
TimeZones	Zones of uniform time recognized by national agreement. Color.

For more information about map styles and the data sources that support each style, see MapPoint Web Service Map Styles.
The MapStyle enumeration is used with the MapOptions.Style property.
MapPoint Web Service constrains the map view in terms of how far the map is zoomed out or zoomed in. The constraints vary per data source and map style. If the MapSpecification.Views or MapSpecification.Options properties are set such that these limits would be exceeded, the returned map image is modified to meet the limit and the MapImage.View property contains the returned view.

Example

[Visual Basic]

'Get a map using height and width
Dim myViews(0) As ViewByHeightWidth
myViews(0) = New ViewByHeightWidth()
myViews(0).CenterPoint = New LatLong()
myViews(0).CenterPoint.Latitude = 40
myViews(0).CenterPoint.Longitude = -120
myViews(0).Height = 200
myViews(0).Width = 300

Dim mapSpec As New MapSpecification()
mapSpec.DataSourceName = "MapPoint.NA"
mapSpec.Views = myViews
mapSpec.Options = New MapOptions()
mapSpec.Options.Style = MapStyle.Terrain

Dim mapImages() As MapImage
mapImages = renderService.GetMap(mapSpec)



[C#]

//Get a map using height and width
ViewByHeightWidth[] myViews = new ViewByHeightWidth[1];
myViews[0] = new ViewByHeightWidth();
myViews[0].CenterPoint = new LatLong();
myViews[0].CenterPoint.Latitude = 40;
myViews[0].CenterPoint.Longitude = -120;
myViews[0].Height = 200;
myViews[0].Width = 300;

MapSpecification mapSpec  = new MapSpecification();
mapSpec.DataSourceName = "MapPoint.NA";
mapSpec.Views = myViews;
mapSpec.Options = new MapOptions();
mapSpec.Options.Style = MapStyle.Terrain;

MapImage[] mapImages;
mapImages = renderService.GetMap(mapSpec);

Share via

MapStyle Enumeration

Remarks

Example

See Also

Additional resources