Multimap API V1.2 - Release Notes

Introduction

These Release Notes are intended for all developers, including those users familiar with previous versions of the Multimap API, and describe the key changes available in the latest version of Multimap API V1.2.

New features

New features in this release:

• New modules
  • Availability of Spatial Searching module
  • Availability of Routing module
  • Availability of Local Information module
  • Availability of Secure module
  If you do not have access to any of these new modules and would like to be able to use its functionality, please contact your Multimap account manager.
• Draggable maps
  • New widgets
    • New Location Widget - shows the location of the current location in a 'breadcrumb trail'
    • New Overview Widget - shows the contextual map of the current location
    • New Tools Widget - provides dragging, zooming and navigation modes
    • New Local Information Widget - shows points of interest of various kinds around a location on a map
    • Widgets can be placed outside the map viewer
  • Marker improvements
    • Markers can be automatically 'de-cluttered' where they overlap
    • Markers can be dragged within a map
    • Markers now support text overlays for numbering and identification purposes
    • Markers can be 'inert' so receive no click events
  • New map types
    • Support for aerial imagery
    • Support for 'hybrid' maps (aerial images that show a map overlay)
  • Usability improvements
    • Smoothly zooming between adjacent zoom factors
    • Zoom widgets contain a slider bar
    • Mouse wheel zooming now zooms in and out from current location of cursor
    • Size of JavaScript API reduced
    • Customizable right-click Context Menu available
    • Improved cursors used within maps
  • Other features
    • Info boxes can now be tabulated
    • Support for polylines and polygons in map viewer
    • Programmatic control over zoom levels to display
    • Programmatic control over user interactions with maps such as drag, click and double-click actions
    • Programmatic control over which map data is displayed
    • Method for calculating distance between points
    • Support for a callback method when the API completes loading
• Geocoding - functionality improvements
  • Single field input for Geocoding module
  • Limit on maximum number of results to return in geocoding requests

Changes

A number of methods in the Multimap API have been deprecated in Multimap API V1.2:

zoom(1) has been replaced by zoom (-1);

zoom(-1) has been replaced by zoom (1);

setSmoothPanning has been replaced by setOption( 'smoothpan', 'true/false' );

getSmoothPanning has been replaced by getOption( 'smoothpan' );

setKeyboardPanning has been replaced by setOption( 'keyboard', 'pan' );

getKeyboardPanning has been replaced by getOption( 'keyboard' );

setMouseWheelZoom has been replaced by setOption( 'mousewheel:wheelup' , 'zoomin' ); setOption( 'mousewheel:wheeldown', 'zoomout' );

getMouseWheelZoom has been replaced by getOption( 'mousewheel:wheelup' ); getOption( 'mousewheel:wheeldown' );

setDraggable has been replaced by setOption( 'drag', 'dragmap' );

getDraggable has been replaced by getOption( 'drag' );

setZoomDoubleClickable has been replaced by setOption( 'doubleclick', 'zoomin' ); setOption( 'doubleclick:ctrl', 'zoomout' ); setOption ( 'doubleclick:rightbutton', 'zoomout' );

getZoomDoubleClickable has been replaced by getOption( 'doubleclick' ); getOption( 'doubleclick:ctrl' ); getOption ( 'doubleclick:rightbutton' );

setZoomDraggable has been replaced by setOption( 'drag:shift', 'zoombox' );

getZoomDraggable has been replaced by getOption( 'drag:shift' );

setScaleBarUnits has been replaced by setOption( 'units', 'miles/km' );

getScaleBarUnits has been replaced by getOption( 'units' );

drawAndPositionMap has been replaced by goToPosition( 'location' );

Additionally, the configuration options for MMMarkerOverlay, MMInfoBoxOverlay and MMPolyLineOverlay are now contained within a generic "Options" attribute. Please see the documentation for further information.

As a result of functionality enhancements, if you wish to customize the appearance of any info boxes and widgets, please refer to the Restyled Info Boxes and Advanced Widgets examples for details of how these customizations should be performed in this version of the Multimap API.

Revision History

Default Settings

The Multimap API has a number of default options and settings. These can be retrieved and modified if required. For further details, please see the topic on Options.

Other Information

Please read this document first before working with the Multimap API V1.2.

Back to examples.

Further Help

If you require further help with your API implementation, please contact our Customer Support team:

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