Directions Refresh new implementation

[devotaaabel]

This PR creates the infrastructure to allow updating routes with updated annotations via the directions-refresh endpoint (This endpoint is currently only on staging). Included in this PR:

• A directions request can contain a new boolean parameter enable_refresh. If this parameter is set to true, the route will be cached and will be refreshable via the directions-refresh endpoint.

• The directions-refresh request needs to include the route_id, route_index, leg_index, access_token, and whatever annotations needed.

• The directions-refresh response is basically a barebones DirectionsRoute, which only includes a list of barebones RouteLegs, which only include the requested LegAnnotations.

Todo:

• Add enable_refresh option to directions API
• Create DirectionsRefresh service module
• Create sample test
• Create unit test
• Add javadoc

[devotaaabel]

@Guardiola31337 @danesfeder this is ready for review. The sample test runs properly when adjusted to run on staging. See todos for what I'm still working on

[danesfeder]

This is looking great, thanks for the work keeping this moving with @gknisely.

The directions-refresh response is basically a barebones DirectionsRoute, which only includes a list of barebones RouteLegs, which only include the requested LegAnnotations.

My only question is regarding this - if we are only getting a List of LegAnnotation, does it make sense to return just that? If that's the case, I think it would be more clear to developers using the response data.

[danesfeder]

I'm getting a compilation error when running this because route / leg index are defined as Strings

[devotaaabel]

@danesfeder this is updated now. Also it's running on production now so the sample test should pass

[langsmith]

@devotaaabel & @danesfeder , if needed, please don't forget about updating content on https://docs.mapbox.com/android/java/overview/directions given this pr's changes.

thank you

cc @colleenmcginnis

[Guardiola31337]

Typo other *then

[danesfeder]

@devotaaabel great work here - let's do one last sanity check with the updated v1 endpoint before we merge. Otherwise, this is good to go ✅

[Guardiola31337]

let's do one last sanity check with the updated v1 endpoint before we merge

I've just run the BasicDirectionsRefresh sample and it worked so we're good here 🚀

Great work @devotaaabel