Awesome

[!WARNING] Bing Maps for Enterprise is deprecated and will be retired

• Enterprise account customers can continue to use Bing Maps for Enterprise services until June 30th, 2028.
• Free (Basic) account customers can continue to use Bing Maps for Enterprise services until June 30th, 2025.
• To avoid service disruptions, all implementations using Bing Maps for Enterprise REST APIs and SDKs will need to be updated to use Azure Maps by the retirement date that applies to your Bing Maps for Enterprise account type.
• For migration documentation, please see Bing Maps Migration Overview.
• For more details on the retirement, see the announcement on the Bing Maps Blog.

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:

• Autosuggest
• 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
• Local search
• And much more!

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, truck, 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.

Reference locally

The NuGet package is not updated as frequently as the source code in this repo. You can use the latest version by downloading the source code and copying the contents of the Source folder into your solution folder. Then in your solution add an "Existing project" and select the "BingMapsRESTToolkit.csproj" file.

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)

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 opencode@microsoft.com 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.