Multimap Open API V1.2 Example

Routing - Combining Features of the Multimap Open API Routing Module *new*

This example demonstrates how to use the Multimap Open API's optional Routing module to calculate routes and present travel directions in a list and on a map.

You can use the Multimap Open API to show and describe a highlighted route between two locations (including intermediate 'via' points, if required) while controlling the restrictions on the routes that are available and the language in which travel directions are presented.

The Routing module of the Multimap Open API can generate routes that link numerous locations: it achieves this by processing a list of locations, treating the list's:

• first item as the route's start point;
• last item as the route's end point; and
• any intermediate items as 'via' points.

What You Should See

If you view this in your browser you should see a Multimap draggable map centered on Saint James Avenue, Boston, Massachusetts, USA, at zoom factor 15.

To generate a route:

1. Enter a search string in at least the first two of the four boxes to calculate a route between locations: for example, "Boston" and "New York" in the United States.
2. Select your language and route preferences from the controls below. You can choose whether to calculate the least time-consuming or most direct route, whether to walk or to drive, whether to avoid large busy roads and whether you wish to optimize your route (as described below).
3. Click on the "Go" button to view your results.
4. If Multimap has found more than one possible match for any of your details you have entered, it lists all possible values for that description in a drop-down list. Click on the correct location for each of these results then click on the "Go" button again.
5. Your route is displayed, highlighted on a draggable map, with a numbered series of travel directions listed below it; each of the list's numbered instructions is shown on the map as a marker with an info box. This example also includes a section above the list of travel directions, which gives details of the route's start and end points, distance and estimated duration.
6. To commence a new search, click on the "Clear" button to clear all location boxes for further data entry.

In this example you can include one or two intermediate locations (or 'via' points):

• If you wish to calculate a route including one intermediate location, enter the details of that location in the "Location 2" box and the final destination in the "Location 3" box.
• If you wish to add two 'via' points, enter your intermediate locations in the "Location 2" and "Location 3" boxes and the final destination in the "Location 4" box.

A journey with 'via' points is listed beneath the map in separate stages, each of which can show its individual start and end points, distance, duration and an 'abstract summary' of the steps that are involved in that stage of the route (such as a list of major roads).

Please note that, in this example, you must populate the drop-down lists of locations from the top list downwards; for example, if you enter data in the box whose label is "Location 3", you must also enter data in "Location 1" and "Location 2".

Important note: You must display copyright and disclaimer notices when providing travel directions.

The Map

Get directions: Location 1: Country: Australia Austria Belgium Canada Czech Republic Denmark Finland France Germany Greenland Iceland Ireland Italy Liechtenstein Luxembourg Netherlands Norway New Zealand Portugal Spain Sweden Switzerland Turkey United Kingdom USA Multiple results found for Location 1. Please select one: Location 2: Country: Australia Austria Belgium Canada Czech Republic Denmark Finland France Germany Greenland Iceland Ireland Italy Liechtenstein Luxembourg Netherlands Norway New Zealand Portugal Spain Sweden Switzerland Turkey United Kingdom USA Multiple results found for Location 2. Please select one: Location 3: Country: Australia Austria Belgium Canada Czech Republic Denmark Finland France Germany Greenland Iceland Ireland Italy Liechtenstein Luxembourg Netherlands Norway New Zealand Portugal Spain Sweden Switzerland Turkey United Kingdom USA Multiple results found for Location 3. Please select one: Location 4: Country: Australia Austria Belgium Canada Czech Republic Denmark Finland France Germany Greenland Iceland Ireland Italy Liechtenstein Luxembourg Netherlands Norway New Zealand Portugal Spain Sweden Switzerland Turkey United Kingdom USA Multiple results found for Location 4. Please select one: Choose language: English (United States) English (United Kingdom) Danish German Spanish French Italian Dutch Norwegian Portuguese Swedish Quickest Shortest Driving Walking Exclude highways

Messages and results will be placed here

The Code

There are four 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. Finally, the fourth is the CSS code that you should add to your web page.

The header code

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" >

<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...

The CSS code

Sorry, JavaScript required...

Note on printing

Please note that you may not be able to print a highlighted route or a polyline from the Multimap Open API when using a Mozilla Firefox or an Opera browser. If you encounter such a problem, please try a different browser.

For more information on the subject of Multimap Open API JavaScript code (including error codes for the Routing module), 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 enquiries about further Multimap services, please contact the Multimap Sales team:

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