Multimap Open API V1.2 JavaScript Example

Bird's Eye Imagery Example *new*

The Bird's Eye map type provides 45-degree high-resolution detailed imagery which allows users to see close-up aerial shots of locations around the world. A Bird's Eye map consists of several Bird's Eye scenes, each of which is a large aerial photograph. Each scene is generally larger than the area covered by the map viewer. When you pan to the edge of a scene, the map viewer refreshes and shows a new scene. When you switch between orientations, each view that you see is a new scene. Every Bird's Eye scene provided by Microsoft Virtual Earth is given a unique scene identifier, which can be stored and used later to show that specific scene again.

The Bird's Eye map has two controls for rotating the map in clockwise and counter-clockwise directions. For example, by default, the map is displayed as if facing north. If you click on the "rotate clockwise" control, the map displayed shows a view to the east.

There are several general methods that you can use to control the properties of the map viewer:

Function(s) introduced:

MultimapVEViewer: getBirdsEyeOrientation(), rotateBirdsEyeOrientation(), setBirdsEyeOrientation(), setBirdsEyeScene(), getBirdsEyeScene(), findBirdsEyeCoverage(), setBirdsEyeSceneById()

What You Should See

If you view this in your browser you should see a draggable Bird's Eye map centered on Constitution Avenue, Washington, USA, at zoom factor 19.

On the right-hand side of the map is a list of controls which determine the appearance and behavior of Bird's Eye imagery.

• You can check the Bird's Eye coverage for a particular location by specifying new latitude and longitude values in the "Check coverage" box. If Multimap has Bird's Eye map coverage for the specified area, an alert message pops up: "Bird's Eye coverage for this location is available". In certain areas, Multimap is currently not able to offer Bird's Eye map coverage: for these areas, Multimap displays an alert message explaining this.
• When you click on the "Get current scene ID:" link, it returns the unique scene identifier for the current Bird's Eye scene in the map viewer.
• When you click on the "Go to London" link, a Bird's Eye map centered on the London Eye, London, Great Britain is displayed.
• To change the orientation of a Bird's Eye map, select any of the directions (north, east, south and west) listed below "Set Bird's Eye orientation:".
• To rotate the Bird's Eye map in a clockwise or counter-clockwise direction, select the relevant link below "Rotate Bird's Eye scene:".

The Map

The Code

There are three parts to the code below. The first is the line that links to the Multimap Open API. The second is an example of the HTML you must have in your page. The third is an example of the JavaScript required to implement the page.

The header code

<script type="text/javascript" src="http://developer.multimap.com/API/maps/1.2/OA08061815803962482"></script>

The body code

Sorry, JavaScript required...

Sorry, JavaScript required...

Sorry, JavaScript required...

The JavaScript code

Sorry, JavaScript required...

For more information on the subject of Multimap Open API JavaScript code, please read the Multimap Open API documentation at: http://www.multimap.com/share/documentation/openapi/1.2/classes/.

Back to examples.

Further Help

If you require further help with your Multimap Open API implementation, please visit the Multimap Developer Forums.

For Open API news, announcements and other information, please see our blog.

For general account enquiries or further services, please contact the Multimap Sales team: