Kentico CMS 6.0 Developer's Guide

Bing maps

Bing maps

Previous topic Next topic Mail us feedback on this topic!  

Bing maps

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

The Bing maps web parts enable displaying a map with defined location markers using the Bing maps service. They use the Bing maps API, which is described in detail in the following location: http://www.microsoft.com/maps/isdk/ajax/.

 

The maps show the location markers and are zoomed according to the settings made by the Large view scale property. For a document-related map and for a map with a data source, the center is on the coordinates specified by the Default latitude and Default longitude properties of the corresponding web part. However, a static map has its center on the location marker.

 

Static Bing maps

 

The Static Bing maps web part is used. Geographical location is displayed based on manually entered coordinates. Only one location can be displayed at a time. Learn here how to display a location marker on the map.

In the screenshot below, you can see how the web part looks on page load.

 

devguide_clip1595

 

Document-related Bing maps

 

The Bing maps web part is used. Geographical location is displayed dynamically based on the properties of the document. More locations can be displayed at a time. Learn here how to display location markers on the map.

In the screenshot below, you can see how the web part looks on page load.

 

devguide_clip0909

 

Bing maps with a data source

 

The Basic Bing maps web part in combination with a data source web part is used. Geographical location is displayed dynamically based on the data source, e.g. documents data source, query data source, xml data source etc. More locations can be displayed at a time. Learn here how to display location markers on the map.

 

The screenshot below shows how any of the web parts looks when one of the location markers is clicked. Regardless of its type, the map is zoomed according to the value of the Detailed view scale property and a tooltip is displayed. It shows the heading loaded from a document type field specified in the Tooltip field property and the rest of the content loaded using a transformation specified in the Transformation property.

 

devguide_clip0913

 

If you enable the Enable keyboard shortcuts property, the following shortcuts can be used to control the map:

 

R - switch to Road view.

A - switch to Aerial view.

H - switch to Aerial view with labels.

O - switch to Bird's eye view.

B - switch to Bird's eye view with labels.

 

Plus Sign (+) - zoom the map in.

Minus Sign (-) - zoom the map out.

 

Detailed descriptions of all properties of the web parts can be found in the Kentico CMS Web Parts Reference or directly in the web part properties dialog after clicking the Documentation Documentation link at the top right corner of the dialog.

 

 

 

Please note

 

Certain Bing maps services, e.g. location translations, require that you have your Bing maps account. As a Bing map account holder, you can create keys to use these services.

 

 

The Bing maps widget is derived from the Static Bing maps web part. It provides the same functionality and look as this web part, while only a limited set of properties can be configured.