Bing Maps REST Toolkit for .NET

This is a portable .NET class library which provides a set of tools that make it easy to access the Bing Maps REST services in .NET based apps. Take a look at the Getting Started documentation. The Bing Maps REST Services provides the following functionality:

• Forward and reverse geocoding
• Route calculations - for driving, walking, transit and truck
• Distance matricies - time and distance based matrices between a set of origins and destinations. Optionally retrieve this data over a period of time using predictive traffic data
• Isochrones (drive time polygons)
• Snap to Road API - snap GPS points to their closest logical point on a road. Also provides speed limit data
• Traffic incident data
• Elevation data
• Static map imagery and metadata

Toolkit Features

• Uses HTTPS by default.
• Implements the documented best practices for Bing Maps. For example, it automatically encodes query parameters. A commonly overlooked stepped which greatly reduces the chances of invalid queries being sent to the service.
• Handles errors and rate limiting by catching exception and returning response with error message.
• Automatically determines when a POST request should be made instead of a GET request.
• Fast indexed lookups of Distance Matrix results.
• Supports calculating driving, walking and transit routes that have more than 25 waypoints.
• Travelling Salesmen algorithms that tie into the distance matrix API documentation.
• Truck routing based Distance Matricies - The Bing Maps distance matric API does not support truck routing based matricies. This library adds support for this by wrapping the truck routing API.

NuGet Package

The Bing Maps REST Services Toolkit is available as a NuGet package. If using Visual Studio, open the nuget package manager, select the Browse tab and search for "Bing Maps REST". This should reduce the list of results enough to find the "BingMapsRESTToolkit" package. The owner of the package is bingmaps and the author is Microsoft.

Alternatively, if you are using the nuget command line:

PM> Install-Package BingMapsRESTToolkit

If you prefer to use the NuGet package manager interface, ere are the steps to add the Bing Maps REST toolkit to your project:

1. In Visual Studio select Tools -> Nuget Package Manager -> Managed Nuget Packages for Solution
2. Select Browse tab and search for "BingMapsRESTToolkit".
3. Select the top result from Microsoft.
4. Check the projects you want to add it to then press install.

Supported Platforms

• .NET Framework 4.5+
• .NET Standard 2.0+
• Universal Windows Platform (UWP)
• Windows 8+
• Xamarin.Android
• Xamarin.iOS
• Xamarin.iOS (Classic)

TODO

Here are some tasks that are being considered:

• Add QPS limiting to SimpleWaypoint batch geocoding.
• Consider wrapping truck routing service to generate truck based distance matrices.

Contributing

We welcome contributions. Feel free to file issues and pull requests on the repo and we'll address them as we can. Learn more about how you can help on our Contribution Rules & Guidelines.

You can reach out to us anytime with questions and suggestions using our communities below:

• MSDN Forums
• StackOverflow

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Related Projects

• Bing Maps SDS Toolkit for .NET

Additional Resources

• Bing Maps REST Services MSDN Documentation
• Bing Maps MSDN Documentation
• Bing Maps Blog
• Bing Maps forums
• Bing Maps for Enterprise site

License

MIT

See License for full license text.