Regional Summary with Azure Truck Routing

Question

I have an existing application that uses Bing Maps Enterprise to determine a route for a commercial truck through one waypoint. The kicker is that in my existing application Bing provides a trip summary, where I can see all states that each route leg goes through and how many miles are spent in each state. This is an absolutely necessary application feature.

I'm trying to migrate to Azure Maps, but from what I can tell the state summary isn't available for trucks; this can be accomplished with travelMode = driving and routeOutputOptions including "regionTravelSummary", but regionTravelSummary is invalid when using travelMode = truck. I'm currently using https://atlas.microsoft.com/route/directions?api-version=2024-07-01-preview as the base URL.

Am I missing something, or is this just not possible yet? I've thought of manually compiling the summary, but that seems unnecessarily complicated. Or, if it's not possible, will Azure offer this in the future? It seems like a pretty big piece of functionality to just not offer anymore since Bing Maps Enterprise is being sunsetted.

Thank you for any help and direction on this!

Answer 1

Hi Larissa,

Thank you for reaching out and providing your feedback! We currently do not plan to support travel summaries for administrative regions in truck routing. However, we are working to support countries and subregions (e.g., states in the US) in the itinerary. Please note that the itinerary will only include information about your waypoints and maneuver instructions.

If you have a waypoint near a state border that the route passes through, you will receive the mileage for the start > waypoint and waypoint > end of the route. Additionally, it will return the subregion the waypoint is in after we add the support, but it will not include information for every subregion by default.

However, you can easily derive that information by running a spatial query to check which state boundary the route path coordinates fall within. You can then get the route path length for each state, which will give you the mileage spent. If you need help with the script, let me know. There are many open data websites available to download US state boundaries, such as the US Census Bureau - https://www.census.gov/geographies/mapping-files/time-series/geo/cartographic-boundary.html

Answer 2

Hi Larissa,

The migration documentation is available here: https://learn.microsoft.com/en-us/azure/azure-maps/migrate-calculate-truck-route and https://learn.microsoft.com/en-us/rest/api/maps/route/post-directions?view=rest-maps-2023-10-01-preview&tabs=HTTP#routeoutputoption

Does the 2023-10-01 version work for you?

Sincerely,

IoTGirl