This has been forked from Microsoft's BingMapsRESTToolkit since active development has stalled.
In addition, the Microsoft BinMapsRESTToolkit is showing release v1.1.4, done on 3/10/2018. However, the GitHub project has been updated since then (e.g., FindTimeZoneRequest class updated on 8/29/2018). This is problematic when wanting to access the paid Bing Map Services and use more recently added request and response classes not in the NuGet package. At the moment, there is a need to access their service to get the Time Zone from a postal code.
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
- September 2018: Requests for Location Recognition and the Time Zone API, including Data Contracts, are now available.
- 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.
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:
- In Visual Studio select Tools -> Nuget Package Manager -> Managed Nuget Packages for Solution
- Select Browse tab and search for "BingMapsRESTToolkit".
- Select the top result from Microsoft.
- Check the projects you want to add it to then press install.
- .NET Framework 4.5+
- .NET Standard 2.0+
- Universal Windows Platform (UWP)
- Windows 8+
- Xamarin.Android
- Xamarin.iOS
- Xamarin.iOS (Classic)
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:
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.
- Bing Maps REST Services MSDN Documentation
- Bing Maps MSDN Documentation
- Bing Maps Blog
- Bing Maps forums
- Bing Maps for Enterprise site
MIT
See License for full license text.