5.3 KiB
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:
- 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.
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:
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
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.