What's New in the REST Services


The Bing Maps REST Services contains the following new features.

April, 2014

Get route information without detailed route instructions (itinerary items) or return route path points with the new routeAttributes parameter. [Calculate a Route, Calculate Routes from Major Roads, Route Data]

The new routeAttributes parameter provides options for what information is returned when you request a route. Currently, this new parameter can have one or both of the following values:

  • excludeItinerary: Specifies to exclude itinerary items from the response.

  • routePath: Specifies to return a set of coordinates (latitude|longitude) that define the route. This route attribute gives the same result as setting routePathOutput=Points in the request and is now the recommended way to get route path coordinates (see note below).

Why you should use the routeAttributes=routePath instead of routePathOutput

The new routeAttributes=routePath method for getting route points is now recommended over the routePathOutput parameter. The results are the same. However, the routeAttributes parameter can take other values (see Calculate a Route), and when it is set, the routePathOutput parameter is ignored. If you are using routePathOutput in your application, consider updating your request to use the routeAttributes parameter.

Get alternate route information without detailed instructions (itinerary items). [Calculate a Route, Calculate Routes from Major Roads, Route Data]

When set to 1 (true), the new mfa (metadata for alternate routes) parameter excludes itinerary items for alternate routes in the response. Alternate routes may be returned when you set the maxSolutions parameter to a number greater than 1. By default, only one route is returned.

Get route summary information between waypoints and via-waypoints with new route sub-leg fields [Calculate a Route, Route Data]

For each route leg (defined by two waypoints) of a route, new routeSubLeg response fields summarize sections of the route leg between waypoints and any intermediate via-waypoints. For example, if the route leg describes the route between Philadelphia and New York with a via-waypoint of Asbury Park, you would receive route sub-leg information for Philadelphia to Asbury Park and for Asbury Park to New York.

January, 2014

New API Release History

Starting with January, 2014, the Bing Maps REST Services API documentation includes Release History.

You now have an additional 40 pushpin icons to use with static maps. [Get a Static Map]

See Pushpin Syntax and Icon Styles to view the new icons with IDs 73-112.

Specify include=cios2 to receive the two-letter ISO country code when you geocode or reverse-geocode. [Locations API]

When you specify include=cios2 in your Locations API request, the two-letter ISO 3166 country code is returned in for each address in the response in a new a CountryRegionIso2 field.



Example address response

  <AddressLine>1 Microsoft Way</AddressLine>
  <AdminDistrict2>King Co.</AdminDistrict2>
  <CountryRegion>United States</CountryRegion>
  <FormattedAddress>1 Microsoft Way, Redmond, WA 98052</FormattedAddress>

October, 2013

You can now select the icons for route waypoints on static maps [Get a Static Map]

 A new feature allows you to specify any pushpin icon style and a label for every route waypoint when you a make a static map route request (Walking/Routing/Transit). Prior to this new feature, pushpin icon styles 50 and 53 were used to display route waypoints on a static map. With this new feature, you can optionally choose any pushpin icon and create labels up to three characters. The new waypoint syntax is wp.n=location;iconID;label.

The following road map example uses icons 64 and 66 to display the road route endpoints which are identified as “1” and “2”.

Static map with route overlay