MapStyle Enumeration

  • Article

MapStyle Enumeration

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);

See Also

  MapOptions.Style Property   |   MapSpecification.Views Property   |   MapSpecification.Options Property   |   MapImage.View Property   |   MapPoint Web Service Map Styles