MapQuest Developer Network Blog

Today we've released a preview of our upcoming 6.0 version of the MapQuest Platform: JavaScript SDK. This version release is a complete overhaul of the code base and designed to be more modular, more lightweight, and easier-to-use code. We've also simplified our documentation, making it easier to follow and reference and complete with inline samples and source-code snippets.

One notable feature in this initial release is that Draggable Route functionality is included. This will allow developers to build applications that let their users dynamically edit their directions right from the map.

Find out more information on our Developer Network Beta Page, and we welcome your feedback.

Last week we pushed out Optimized Routing to our Directions Web Service beta. The week before that we introduced our new Directions Web Service. Today we're making the Route Matrix feature available.

A Route Matrix request in the Directions Web Service will return a quick and easy calculation of the distances and drive times between a bunch of points.

In the table below, we want to compare the times and distances between:

• York, PA
• Lancaster, PA
• Boalsburg, PA
• and Sunbury, PA

You'd ask the Directions Web Service something like this:

    REQUEST URL:
 http://platform.beta.mapquest.com/directions/v1/routematrix?key=YOUR_KEY_HERE

    REQUEST BODY:
    {
       locations: [
          "York, PA",
          "Lancaster, PA",
          "Boalsburg, PA",
          "Sunbury, PA"
       ],
       options: {
          allToAll: true
       }
    }    
  

And with the results, you could display something like this:

Driving distance (in miles)

Driving times (in seconds)

Check out the complete documentation for Route Matrix and the rest of the Directions Web Service Beta and please continue to send us your feedback.

For our Enterprise Edition users, we've just introduced Premium Data Sets. This allows easy integration of location-based point, boundary, and demographic data into your application.

New York Median Income

Premium Data Sets include:

• US Boundaries
  • Parcels
  • City, County & State
  • ZIP codes
  • Neighborhoods
  • School districts
  • Core Based Statistical Areas, including Metropolitan Statistical Areas (MSAs)
  • Congressional Districts
• US Census Data (2000)
  • Broken down by Block, Group, Tract, ZIP Code Tabulation Area (ZCTA), City, County & State
  • Over 400 Categories to choose
• Premium Business Listings
  • 13+ million US and 2+ million Canada Business Listings
• US Public School Locations
  • Over 102,000 public schools
• US Traffic
  • Incident and Flow data

Existing customers should contact your MapQuest Sales Account Manager or email sales@mapquest.com to enable access.

If you don't already have access to the MapQuest Platform, sign-up for a free Developer License, then email sales@mapquest.com.

Denver Parcel Data

New York ZIP Code Data

San Francisco Neighborhoods

We recently announced the beta of our new Directions Web Service for the MapQuest Platform; today we want to tell you that the team just added Optimized Routing functionality to the code.

If you're not familiar with Optimized Routing, it basically works like this:

Say the users of the app you've built using the Directions Web Service plug in a bunch of places they need to go. They have the addresses, but aren't really familiar with how far away all of these stops are from each other. With Optimized Routing, all of the stops between the first and last are reordered for the shortest overall distance or drive time.

Now it is still a work in progress, so keep in mind that Optimized Routing is designed for use on locations that are relatively nearby to each other (e.g.: delivery or repair services, planning a tour of open houses, etc.) It will attempt to optimize longer distances, but to meet performance limits, it may estimate the drive time calculation. This could lead to a less than optimally optimized route.

If you haven't yet checked out the Developer's Guide to the beta Web Directions Service, please do so and give us your thoughts and feedback.

Also, thanks for all the Directions Web Service mentions on the blogs and on Twitter. We are paying attention to your feedback and comments and appreciate the support. We also dig that you enjoy the phrase "sane and modern web service" as much as we do.

More features are on the way. Stay tuned.

Today we're celebrating "One small step for man..." However, it turns out that it's the 40^th anniversary of the Moon Landing we're celebrating, not today's beta release of our new Directions Web Service. Well I say: "Why can't we celebrate both?"

And while you'll likely never set foot on the Moon, you can check out our first beta of our new MapQuest Platform: Directions Web Service right now. We've taken our decades worth of routing technology and know-how and have been rewriting it into a sane and modern web service that's easy to use.

How easy?

http://platform.beta.mapquest.com/directions/v1/route?key=<your app key here>&from=Lancaster,PA&to=York,PA&callback=renderNarrative

This simple request will return a JSONP response containing the directions narrative data and then fires the defined JavaScript callback function in your app. You then have the flexibility to display the information in your UI however you want.

Yes, that easy.

Some other tidbits of useful information regarding our Directions Web Service:

• The service will utilize the following formats:
  • Key-Value pairs submitted via HTTP GET or POST
  • JSON
  • XML
  • ...and more formats are in the works. Check the Developer Network Beta page for updates.
• The format supplied does not have to match the format requested either. Send us XML but ask for a JSON response. Mix and Match to fit the needs of your application.
• You can make your Directions requests as simple or as advanced as you'd like
• If there's an ambiguity in one of the locations, we will return a list of location choices or you can opt for us to take the first location and just return your directions
• You can return the full route shape or in a performance encoded format for size
• The response returns the image URIs of the road shields, making it easy to manage how and where you display them
• More functionality, such as route matrix and optimized routing will be available in future beta updates

All the details are in the Directions Web Service Documentation, which we've also baked right into the service.

One important thing to note: You need to use a Developer License key in order to use beta services. There is no-cost associated with using a Developer License. Signup here.

I was going to close out this post with something, like "It's out of this world," but it's probably a bit cheesy, ya'know, like the stuff the Moon is made out of. How about you check it out and let us know what you think instead?

Dump your Garmin! No, I don't mean getting rid of your Garmin, so don't go chucking it out the window just yet. I'm referring to dumping the data from the .gpx file your Garmin device utilizes to store location and route information.

A co-worker of mine recently asked me to write an app that reads a Garmin's .gpx file and displays the waypoints and the route on a map. Never having seen a .gpx file (I'm a TomTom boy, myself) I was pretty sure it would include all the basics - lat/lng, name, etc, etc. I found what I was expecting in the file, not much to it, it's fairly simple.

You can view the sample app here. Viewsource is enabled on the sample so you can see the code involved in it. To sum it up, I used an HTTPService to read the file, array collections (I know they're heavy and slow, but they're easy), and looped through the collections displaying the waypoints and route on the map. If you're at all familiar with placing POIs and routes on MapQuest's maps, the whole process is fairly simple.

Hope this helps some one! If you threw your Garmin out the window in the first paragraph, neither MapQuest nor I are responsible.

Use the DotNet API? We've made some updates and improvements to the 5.3 DotNet Simple Samples.

Change #1

Previously, in order to get the samples to build, you needed to download the mapquest API DLL separately and:

• For VB.net and C#.net, edit all the project files
• For ASP.net, you had to add a reference to the DLL

The current 5.3 mapquest20.dll has now been added to each package. For ASP.net, it's in a /bin subdirectory so that it will automatically be picked up as a reference.

For VB.net and C#.net, its been added to the top level of the zip package and we've modified all the project files so that the correct location is referenced.

In short, when you extract the samples archive and open the solution file, the DLL will already be there with a working reference.

Change #2

The relevant MQServers file had localhost and strange development ports settings. These files have been updated so that they default to the appropriate dev server location (e.g., map.dev.mapquest.com) and port 80.

Change #3

The readme.txt for the ASP.net archive to call out that the user needs to modify MQServers with your client id, password and possibly server info.

readme.txt files were added to the VB.net and ASP.net archives.

In general, these changes should make our dotNet samples easier to use.

Back in October we announced that we would be retiring our old OpenAPI product on Saturday, January 31^st. OpenAPI was replaced almost a year ago with our easier-to-use and much more feature-rich MapQuest Platform: Free Edition.

January 31^st is rapidly approaching. If your application is still being powered by the MapQuest OpenAPI product, you will need to complete migration to one of 6 APIs available in the MapQuest Platform: Free Edition within the next two weeks.

The MapQuest OpenAPI product servers will go offline on Saturday, January 31st, 2009. Applications not migrated off of the MapQuest OpenAPI product will stop working after this date.

Please don't be that guy (or gal) who procrastinates and then winds up with the broken app in production.

You can find documentation and downloads for the MapQuest Platform: Free Edition product on our Developer Network.

Hope your Holidays are Sweet!

Warmest Regards,
The Staff at MapQuest

MapQuest will be attending Adobe Max next week in San Francisco. We'll be hanging out with the Adobe community and demonstrating the features and functionality of our AS3 and FUJAX APIs.

If you're going to Adobe Max, please stop by and say "Hi!" We'll be at booth #410 in the Community Pavilion.