Share via

MapSpecification.Pushpins Property

  • Article

An array of pushpins (Pushpin[] objects) to render on the map. Valid array range is 0 through 100. Optional.

Public Dim Pushpins As [Namespace].Pushpin()
    Member of [Namespace].MapSpecification
[C#]
public [Namespace].Pushpin[] Pushpins
    Member of [Namespace].MapSpecification

Remarks

  • The Pushpins property applies to each map returned by the RenderServiceSoap.GetMap method. If a pushpin in the array is not within the boundaries of the map view, it does not appear.
  • Each Pushpin object in the array must include an IconDataSource property and either a LatLong or Pixel property.

Example

 
[Visual Basic] 
'This example assumes that the service instances 
''routeService' and 'renderService' have already 
'been created and that the MapPoint Web Service namespace 
'has been imported 

'Route between two locations
Dim latLongs(1) As LatLong
latLongs(0) = New LatLong()
latLongs(1) = New LatLong()
latLongs(0).Latitude = 40
latLongs(0).Longitude = -120
latLongs(1).Latitude = 41
latLongs(1).Longitude = -121

Dim myRoute As Route
myRoute = routeService.CalculateSimpleRoute(latLongs, "MapPoint.NA", SegmentPreference.Quickest)

'Get a map of the route and add pushpins to the start and end 
Dim myRouteViews(0) As ViewByHeightWidth
myRouteViews(0) = myRoute.Itinerary.View.ByHeightWidth

Dim myPushpins(1) As Pushpin
myPushpins(0) = New Pushpin()
myPushpins(0).IconDataSource = "MapPoint.Icons"
myPushpins(0).IconName = "31"
myPushpins(0).Label = "Start"
myPushpins(0).LatLong = myRoute.Itinerary.Segments(0).Waypoint.Location.LatLong
myPushpins(1) = New Pushpin()
myPushpins(1).IconDataSource = "MapPoint.Icons"
myPushpins(1).IconName = "29"
myPushpins(1).Label = "End"
myPushpins(1).LatLong = myRoute.Itinerary.Segments(1).Waypoint.Location.LatLong

Dim mapSpec As New MapSpecification()
mapSpec.DataSourceName = "MapPoint.NA"
mapSpec.Route = myRoute
mapSpec.Pushpins = myPushpins
mapSpec.Views = myRouteViews

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

 
[C#]
//This example assumes that the service instances 
//'routeService' and 'renderService' have already 
//been created and that the MapPoint Web Service namespace 
//has been imported 

//Route between two locations
LatLong[] latLongs = new LatLong[2];
latLongs[0] = new LatLong();
latLongs[1] = new LatLong();
latLongs[0].Latitude = 40;
latLongs[0].Longitude = -120;
latLongs[1].Latitude = 41;
latLongs[1].Longitude = -121;

Route myRoute = routeService.CalculateSimpleRoute(latLongs, "MapPoint.NA", SegmentPreference.Quickest);

//Get a map of the route and add pushpins to the start and end
ViewByHeightWidth[] myRouteViews = new ViewByHeightWidth[1];
myRouteViews[0] = myRoute.Itinerary.View.ByHeightWidth;

Pushpin[] myPushpins = new Pushpin[2];
myPushpins[0] = new Pushpin();
myPushpins[0].IconDataSource = "MapPoint.Icons";
myPushpins[0].IconName = "31";
myPushpins[0].Label = "Start";
myPushpins[0].LatLong = myRoute.Itinerary.Segments[0].Waypoint.Location.LatLong;
myPushpins[1] = new Pushpin();
myPushpins[1].IconDataSource = "MapPoint.Icons";
myPushpins[1].IconName = "29";
myPushpins[1].Label = "End";
myPushpins[1].LatLong = myRoute.Itinerary.Segments[1].Waypoint.Location.LatLong;

MapSpecification mapSpec  = new MapSpecification();
mapSpec.DataSourceName = "MapPoint.NA";
mapSpec.Route = myRoute;
mapSpec.Pushpins = myPushpins;
mapSpec.Views = myRouteViews;

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

 

See Also

MapSpecification Class | Pushpin Class | RenderServiceSoap.GetMap Method | Pushpin.IconDataSource Property | Pushpin.LatLong Property | Pushpin.Pixel Property