Surface placemark

[pdavidc]

Display of icon and text draped on the terrain surface with a geographic location. From the COE requirements document:

Points

• Plot from existing coordinate
• Point Icon may be set to render in two ways with a property indicating the display method provided in the constructor of the annotation:
  • Point Icon should support draping with rotation. The annotation text is draped over terrain as if it were painted on the ground and is oriented in the direction from the left of the text with a default rotation of 90 degrees to appear as normal text when viewing the map top down with not rotation, tilt, North point up.
  • Point Icon shall support bill boarding so that it floats near the point attached and always faces users view regardless of the globes tilt and rotation
• Custom icon provided as:
  • URL to an image file of: png, jpg, gif, svg
  • a base64 dataURI string containing an image in one of the above formats
• By default, the icon shall be plotted with the center of the image located at the latitude, longitude position. In the case of an icon that is displayed as a bill board the default point that the icon should rotate from shall be the center of the image. The image should lift above the terrain enough that when it is billboarded no portion of the icon is covered by the terrain
• The Icon shall allow for a pixel based x,y offset that allows the image to be offset from its default center location
• In the case the provided icon fails to load, the map will display a default icon which can be configured by the application using the map engine SDK