Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
Bing Maps Snap Points to Roads API retirement
Bing Maps Snap Points to Roads API is deprecated and has been retired for all free (Basic) account customers. Enterprise account customers can continue to use Bing Maps Snap Points to Roads API until June 30th, 2028. To avoid service disruptions, all enterprise account customers using Bing Maps Snap Points to Roads API will need to be updated to use Azure Maps Snap to Roads by June 30th, 2028.
Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.
The response returned by the Snap to Road API contains either an SnapToRoadResponse resource or an RouteProxyAsyncStatus resource. The SnapToRoadResponse contains the snapped point data while the RouteProxyAsyncStatus contains status information about an asynchronous request that was made for an isochrone. The following tables provide the descriptions of the SnapToRoadResponse resource fields.
For more information about the common response syntax for the Bing Maps REST Services, see Common Response Description.
SnapToRoadResponse Resource
Represents a list of snapped or interpolated points returned by the Snap to Road API.
| JSON | XML | Type | Description |
|---|---|---|---|
snappedPoints |
SnappedPoints |
SnappedPoint[] |
The array of points that have been snapped as well as any points added through interpolation. |
SnappedPoint Class
Represents a snapped or interpolated point.
| JSON | XML | Type | Description |
|---|---|---|---|
coordinate |
Coordinate |
Coordinate |
The coordinate in which a point was snapped to or an interpolated point. |
index |
Index |
integer |
The index in the original list of points passed into the query that this snapped point corresponds to. Can be a value between -1 and the number of points – 1. The index will be set to -1 when the point is an interpolated point and not one of the snapped input points. |
name |
Name |
string |
The name of the street this snapped point lies on, if available. |
speedLimit |
SpeedLimit |
double? |
The posted speed limit. There are some special values which may be returned: • Null – Speed limit not requested. • 0 – Speed limit unavailable. |