MapSpecification.Pushpins Property
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