Beta Web Services & SDKs
Information
NOTICE: Any code or SDK version obtained from this page is to be considered incomplete, untested, and unsupported. Use at Your Own Risk! By downloading any code or using any Web Service or SDK version obtained from this page, you agree to our Terms.
Remember - this IS beta - a REAL beta - we expect you might find things that don't work, and we REALLY, REALLY want you to tell us about them in the Beta Forum.
Beta and Pre-release versions of the MapQuest Platform and libraries are only available using Developer AppKeys.
Sign-up for a Developer AppKey here.
Available Beta and Preview Products
5.2 / 5.3 SDKs with New Map Styles
We have retrofitted the 5.2 and 5.3 Action Script and JavaScript Toolkits to utilize our new map styles.
In the upcoming weeks we will be rolling these styles out to all of our b2b products. No changes to your application of any kind will be required when we make this switch in production.
In the mean time if you would like to view these styles in your application you simply need to download the correct Action Script Toolkit below and recompile your application or point your JavaScript Application to our beta servers
NOTE - you will need a Developer Edition key to access the beta servers - click here to create one.
| 5.2/5.3 SDKs with new map styles |
|---|
| Language | Version | Link |
|---|
| JavaScript | 5.2.1 | http://btilelog.beta.mapquest.com /tilelog/transaction ?transaction=script &key=mjtd%7Clu6znu0tn9%2Caw%3Do5-la7xg &ipr=true&itk=true&v=5.2.1
|
| JavaScript | 5.3.2 | http://btilelog.beta.mapquest.com /tilelog/transaction ?transaction=script &key=mjtd%7Clu6znu0tn9%2Caw%3Do5-la7xg &ipr=true&itk=true&v=5.3.s
|
| ActionScript | 5.2 | Components |
| ActionScript | 5.3.2 | Components |
Directions Web Service
The MapQuest Platform: Directions Web Service provides route ribbons, and maneuver text between multiple locations
- Base URL for all services
- http://platform.beta.mapquest.com
- Directions Service
- http://platform.beta.mapquest.com/directions/v1/
Major Updates
Enhancement 1: Time Of Day enhancement and PathFromRoute function - 11.17.09
- Time Of Day:
- The Route function has been enhanced to account for the time of day that the journey will take place. By providing the time that someone intends to leave on their travels, we can now account for such things as lane closures, HOV roads or time-based turn restrictions.
- Path From Route:
- This is a new function to help you find which locations, out of a given set, are within a certain Travelling-Time or -Distance from a known route. For each of the points you provide, we return its time and distance from the route, and the lat/lng coordinates of where to leave the primary route to reach the location.
Geocoding Web Service
The MapQuest Platform: Geocoding Web Service takes addresses and turns them into latitude / longitude, or vice-versa
- Base URL for all services
- http://platform.beta.mapquest.com
- Geocoding Service
- http://platform.beta.mapquest.com/geocoding/v1/
Major Updates
Release 3: Delimited File Output - 11.09.09
- Delimited File Output:
- For any of the geocoding service functions, you can now specify
outFormat=file
and a delimiter=
of Comma(,) Pipe(|) Colon(:) or semi-colon(;). The service will then return a delimited text file including a header row. This should be especially useful for the batch geocoding function
Release 2: Batch Geocode, ViewPort Biasing, ccTLD Biasing, Thumbnail Ambiguity Static Maps - 10.16.09
- Batch Geocode function:
- Geocode up to 100 locations at once in a single batch function call.
- ViewPort Biasing:
- If you provide a Map Bounds as part of your geocode call, ambiguity results within the map bounds will be moved to the top of the results list
- ccTLD Biasing (Country Code Domains):
- If you don't provide a country for the address, the country will default to the domain of the web address making the geocoding request. For example, if you make a request from http://www.myAwesomeSite.co.fr, we will default the country to France unless you tell us differently.
- Thumbnail Ambiguity maps:
- Each ambiguity result can now return a static map URL that provides a thumbnail image of the ambiguous location, if you wish to display these to end-users for some context when disambiguating.
-
Release 1: Geocode and Reverse Geocode - 09.11.09
- Address Geocode function
- Provide either a single line address, or an address broken down into its component parts (5-line) and receive back potential addresses and lat/lngs, in order of confidence
- Reverse Geocode function
- Provide a Latitude and Longitude, and receive back the known address information of that location
- Reflected User-provided values
- Add your own data into the location object on your request, and receive it back in the response. Great for helping you maintain state in your application, and for keeping your own information about the location packaged together for your application
Static Map Web Service
The MapQuest Platform: Static Map Web Service lets you embed a printer-friendly MapQuest Map image on your web page without requiring any code, by accepting querystring parameters on the image URL.
- Base URL for all services
- http://platform.beta.mapquest.com
- Static Map Service
- http://platform.beta.mapquest.com/staticmap/v3/
Major Updates
-
Release 3: auto best fit, declutter, single-line address - 11.09.09
- Auto Best Fit
- If you provide POIs without providing a zoom level and a map center, we will return a map that fits all your POIs on it, as zoomed in as possible
- Additional Map Styles
- A new parameter has been exposed called
&style= that lets you get street maps in a variety of other styles like black & white or eauropean or classic MapQuest - Check the documentation for the list.
- Support for Compressed format for Line Overlays
- the
&shapeFormat parameter has been added to Static Map to bring it inline with the other services - so you can now pass in raw or compressed shapepoints to draw the line. NOTE: It still currently requires an initial "Count" value that says how many Lat/Lng paris are in the rest of the input - This requirement will be removed shortly.
- Auto Declutter
- there is a new parameter
"declutter=true
that will auto-declutter the POIs on the map without you having to provide the X/Y pixel co-ordinates.
- getPlacemap single-line address function
- there is a new
/getPlaceMap?location=
function that takes a single line address and optionally a single icon, to provide a very convenient short-cut method of getting a static map for a location without needing to have the geocoded lat/lngs first. NOTE! There are NO ambiguity rules on this! you always get a map of the top result, so check to make sure you are getting the map you want.
- Various Defaultery put in place
- MapType now defaults to "map" if you dont provide the parameter
- POI offset values now default to 0,0 if you dont provide them - so need to provide them!
- Map Size minimums removed - you can now request a static map of as small a height " width as you like
- Empty parameters are now ignored - so if you provide a parameter, but no value, we will treat it like you didnt pass the parameter
-
Release 2 - 10.06.09
- You can now provide URLs of your own icons to use for POIs on a static map!
- We cache the icons for performance, so we also provide a function to flush your icon from our cache
- Support for jpg, png, gif image output formats
- You can now request the static map in different image formats
- Support for mcenter, pcenter, scenter, ecenter, stop icons as parameters to 'pois'
- the "pois" parameter now supports using the icons that are used by the other parameters.
-
Initial Release - 09.11.09
- Get A Map!
- Embed a printer-friendly MapQuest Map image on your web page without requiring any code, by accepting querystring parameters on the image URL.
- Put a route highlight on your static map by passing in a sessionID from the Routing Service.
AS3 SDK 6.0
Version 6.0 of our AS3 SDK has been rebuilt to improve performance, reduce size, and add new features.
In a simple map sample, the 6.0 version of your final .swf file is 34% smaller than in version 5.3.0.
| AS3 SDK 6.0 Information |
|---|
| Downloads | Documentation | Samples |
|---|
| | |
-
Release 3: 10.29.09
- Internal changes to the SDK to support the new MapQuest Map Style
-
Release 2: 10.23.09
- NEW! Directions Package! Includes Draggable Routes! Do NOT use AdvantageAPI.swc any more for routing, use the new directions.swc! It contains the following
- New simplified Routing function that uses the new Directions Web Service. Attach your route easily and directly to the map. Set a simple flag and have a draggable route!
- Optimized routing function for when you need to know the most efficient order to visit several places
- Route Matrix function that tells you the driving time and distance between a group of locations
- PointLL and IPointLL Removed - consolidated to LatLng
- All instances of these two classes have been removed in favour of the LatLng class. From now on you should only ever need to use LatLng
- Known Bugs - A few issues we haven't had time to fix yet:
| 521452 - Ocean Breeze large zoom control will not change zoom level if user's mouse drags past the last tick mark. |
| 522049 - Scrolling a mousewheel while a draggable route is displayed on a map will cause the tooltip and dragDot to be offset from the route ribbon. |
| 522050 - The route ribbon still has some style issues. |
| 522084 - Double clicking on a draggable POI will give an Actionscript error. |
| 522855 - Using removeAllOverlays() will cause an Actionscript error if there are no overlays on the map and also if the only shapes on a map are a route and its stops. |
| 523539 & 523506 - There are some underlying issues with putting Flex components in an InfoWindow including lack of documentation, styling issues, anmd ease of use. |
| 523541 - Ocean Breeze large zoom control will zoom all the way in/out if the white space around the zoom in or zoom out buttons is clicked. |
| 523546 - Route ribbon properties cannot yet be customized. |
-
Initial release: 08.17.09
- POI Decluttering Refactored
- Globe View Refactored and relocated to a separate .swc
- New Control Component style (Ocean Breeze)
- Raster image assets removed from .swc files and remotely loaded
- Vector-based POI star added. Now scalable and color-customizable
- Overview map control added
- Mouse-wheel zoom control added
- Keyboard controls added
JavaScript SDK 6.0
Version 6.0 of our JavaScript SDK will have the following:
- Draggable routes are now available for you to include in your application.
- Smaller initial download footprint for the toolkit
- Simplified request strings to download the toolkit; More modular requests to only download what you need
- Simpler and easier-to-use documentation, complete with samples and referenced source-code snippets; organized for the functionality you're trying to implement
| JavaScript SDK 6.0 Information |
|---|
| Component | Documentation | Samples |
|---|
<script src=" http://platform.beta.mapquest.com /api/js/mqa.toolkit.js ?key=YOUR_KEY_GOES_HERE" type="text/javascript"> </script>
| User Guide | |
-
Release 4: 10.29.09
- Updated map styles (Sample)
- Added Overview Map control (Sample)
- Added custom poi image support (Sample)
- Trimmed down route, optimizedRoute, and dragRoute call URL length. This will allow you to add more route stops with the routing functions in IE6 & IE7 without using a proxy.
- Updated user guide style.
- Added route stop icons up to 50 (A - WW).
-
Release 3: 09.17.09
- Added support for iPhone / Mobile Safari events (e.g:
pinchToZoom, etc) - Added Overlays into the latest build, including the new
CircleOverlay for easily showing a radius - You can now run a route without needing a map
- Added wrapper functions over the Route Service's
RouteMatrix call for easy access if using the SDK
-
Release 2: 08.17.09
- Added route options for tailoring a route
- Added simplified mechanism to add routes
- Added ability to toggle route dragging feature and changed the default to be off
- Added basic mouse wheel zoom in/out support
-
Release 1: 08.07.09
- Introduction of the new modular SDK
- Developer guide with inline samples of current functionality:
- Basic map controls for zooming and map type change
- Traffic Control
- POIs and Info windows
- Routing and Draggable routes (without need for server proxy)
- Initial Reference documentation
