topic Re: Routing/Rerouting & Turn by Turn License in Swift Maps SDK Questions

Routing/Rerouting & Turn by Turn License

RTC — Thu, 04 Sep 2025 23:41:17 GMT

Our app needs provide Route with Turn by Turn and Rerouting capabilities.

My question is; What license(s) do we need for Esri routing service as well as an MMPK (network dataset) routing with Rerouting and Turn by Turn?

From what I can gather from online, a license of Basic or higher should be enough for Esri routing service. When I try using a user type of Mobile Worker the Esri routing service does not work. I get an error of forbidden. However, the MMPK routing does work and has turn by turn.

I understand that currently the Esri routing service does not support auto rerouting. That is fine, we can do that manually.

Re: Routing/Rerouting & Turn by Turn License

Nicholas-Furness — Fri, 05 Sep 2025 15:21:19 GMT

Hi @RTC.

To clarify… there are two things being discussed here:

Routing (creating turn-by-turn directions using the RouteTask API and the World Routing service or an MMPK)
Navigating (following along the route, getting real-time guidance, using the RouteTracker API)

There are also two other things that you talk about that are a bit muddied above:

Licensing the SDK (Lite, Basic, Standard)
Accessing the World Routing Service (with an appropriate access token)

There's no licensing restriction to use the World Routing service or an MMPK to calculate turn-by-turn directions (Routes).

However, you will need an appropriately scoped access token to use the World Routing service.

To use the RouteTracker API for interactive navigation, you need a Basic license unless you are using the World Routing Service, in which case Lite is sufficient (when you pay Esri for the route calculation, that includes use of the RouteTracker API). That's covered in the Lite section of the Licensing and Capabilities table:

Navigate a route using the RouteTracker API and ArcGIS location services.

If you're using an MMPK (or some other routing service), then you need a Basic License to use the RouteTracker API. That's covered in the Basic section of the Licensing and Capabilities table:

Navigate a route using the RouteTracker API and any ArcGIS routing service, or a network dataset that is stored locally on the device.

So yes, Mobile Worker user type will allow you to use the interactive navigation guidance capabilities of the RouteTracker API with any service or local network dataset. But if you're using the World Routing service, you can even use the RouteTracker API with a Viewer user type.

But: either way you need to make sure you have an access token for the World Routing service.

I suspect that the "forbidden" error is because the access token you're using is not properly scoped (perhaps it just includes basemaps?). See this tutorial on selecting privileges.

Hope that helps!

Re: Routing/Rerouting & Turn by Turn License

RTC — Fri, 05 Sep 2025 16:31:56 GMT

Hi Nick,

Thank you for your detailed reply!

Yes, I understand that this involves a couple of different items and I think that is where the confusion is.

1) With User Authentication method and the user type of Mobile Worker.

For MMPK with network dataset:
RouteTask API works and so does RouteTracker API

For online user maps (World routing service):
RouteTask API does not works nor does RouteTracker API
Error of forbidden is thrown

2) If we change the User Auth to a Lite user:

For MMPK with network dataset:
RouteTask API works but RouteTracker API does NOT work

For online user maps (World routing service):
RouteTask API and RouteTracker API does work

Making the user type Mobile Worker seems to breaks World routing service. My understanding is that this user type is considered a Basic user so it should have access to both RouteTask and RouteTracking APIs. Is that not correct?

Re: Routing/Rerouting & Turn by Turn License

Nicholas-Furness — Fri, 05 Sep 2025 17:13:48 GMT

Yes. That's correct.

I still think the "forbidden" error is coming from the service (in contrast to us locking the API by license level).

Has your mobile worker's Role been modified to disabled Network Analysis?

Re: Routing/Rerouting & Turn by Turn License

RTC — Fri, 05 Sep 2025 17:34:34 GMT

Yes, that was it, thanks! Looks like the Mobile Worker's role was not set to allow Network Analysis.

Re: Routing/Rerouting & Turn by Turn License

Nicholas-Furness — Fri, 05 Sep 2025 17:38:28 GMT

Excellent! Seems there's always another way to break things. Glad that was it, because otherwise I was out of ideas 🧐