MapBillboard.ReferenceCamera Property

Definition

Namespace:

Windows.UI.Xaml.Controls.Maps

Gets the MapCamera settings that define the position and orientation where the image appears at a 1x scale.

public:
 property MapCamera ^ ReferenceCamera { MapCamera ^ get(); };

MapCamera ReferenceCamera();

public MapCamera ReferenceCamera { get; }

var mapCamera = mapBillboard.referenceCamera;

Public ReadOnly Property ReferenceCamera As MapCamera

Property Value

MapCamera

The MapCamera settings that define the position and orientation where the image appears at a 1x scale.

Remarks

Because a MapBillboard image scales in and out as the ZoomLevel of the map changes, it's important to define where in that ZoomLevel the image appears at a normal 1x scale. You define that position in a Geopoint, and then pass that Geopoint as a parameter to the MapBillboard constructor.

For example, if you use the map's ActualCamera as that constructor parameter, the position defined in the reference camera becomes equal to the position defined in the maps internal camera. This becomes the position of the camera where the MapBillboard image appears at 1x scale. However, if your app gives users the ability to zoom out on the map, the image decreases in size because the maps internal camera is rising in altitude while the image at 1x scale remains fixed at the reference camera's position.