com.nbmap.api.directions.v5

Class NbmapDirections

java.lang.Object

com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

com.nbmap.api.directions.v5.NbmapDirections

public abstract class NbmapDirections
extends com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

The Directions API allows the calculation of routes between coordinates. The fastest route can be returned with geometries, turn-by-turn instructions, and much more. The Nbmap Directions API supports routing for driving cars (including live traffic), riding bicycles and walking. Requested routes can include as much as 25 coordinates anywhere on earth (except the traffic profile).

Requesting a route at a bare minimal must include, a Nbmap access token, destination, and an origin.

Since:

1.0.0

See Also:

Android Directions documentation, Directions API documentation

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NbmapDirections.Builder This builder is used to create a new request to the Nbmap Directions API.

Field Summary

Fields inherited from class com.nbmap.core.NbmapService

MAX_URL_SIZE, okHttpClient

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NbmapDirections()

Method Summary

Modifier and Type	Method and Description
protected abstract java.lang.String	baseUrl()
static NbmapDirections.Builder	builder() Build a new NbmapDirections object with the initial values set for baseUrl(), profile(), user(), and geometries().
void	enqueueCall(retrofit2.Callback<com.nbmap.api.directions.v5.models.DirectionsResponse> callback) Wrapper method for Retrofits Call.enqueue(Callback) call returning a response specific to the Directions API.
retrofit2.Response<com.nbmap.api.directions.v5.models.DirectionsResponse>	executeCall() Wrapper method for Retrofits Call.execute() call returning a response specific to the Directions API.
protected com.google.gson.GsonBuilder	getGsonBuilder()
protected okhttp3.OkHttpClient	getOkHttpClient()
protected retrofit2.Call<com.nbmap.api.directions.v5.models.DirectionsResponse>	initializeCall()
abstract NbmapDirections.Builder	toBuilder() Returns the builder which created this instance of NbmapDirections and allows for modification and building a new directions request with new information.

Methods inherited from class com.nbmap.core.NbmapService

cancelCall, cloneCall, enableDebug, getCall, getCallFactory, getRetrofit, getService, isEnableDebug, setCallFactory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NbmapDirections

protected NbmapDirections()

Method Detail

initializeCall

protected retrofit2.Call<com.nbmap.api.directions.v5.models.DirectionsResponse> initializeCall()

Specified by:

initializeCall in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

getGsonBuilder

protected com.google.gson.GsonBuilder getGsonBuilder()

Overrides:

getGsonBuilder in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

executeCall

public retrofit2.Response<com.nbmap.api.directions.v5.models.DirectionsResponse> executeCall()
                                                                                      throws java.io.IOException

Wrapper method for Retrofits Call.execute() call returning a response specific to the Directions API.

Overrides:

executeCall in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

Returns:

the Directions v5 response once the call completes successfully

Throws:

java.io.IOException - Signals that an I/O exception of some sort has occurred

Since:

1.0.0

enqueueCall

public void enqueueCall(retrofit2.Callback<com.nbmap.api.directions.v5.models.DirectionsResponse> callback)

Wrapper method for Retrofits Call.enqueue(Callback) call returning a response specific to the Directions API. Use this method to make a directions request on the Main Thread.

Overrides:

enqueueCall in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

Parameters:

callback - a Callback which is used once the DirectionsResponse is created.

Since:

1.0.0

getOkHttpClient

protected okhttp3.OkHttpClient getOkHttpClient()

Overrides:

getOkHttpClient in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

baseUrl

@NonNull
protected abstract java.lang.String baseUrl()

Specified by:

baseUrl in class com.nbmap.core.NbmapService<com.nbmap.api.directions.v5.models.DirectionsResponse,DirectionsService>

builder

public static NbmapDirections.Builder builder()

Build a new NbmapDirections object with the initial values set for baseUrl(), profile(), user(), and geometries().

Returns:

a NbmapDirections.Builder object for creating this object

Since:

3.0.0

toBuilder

public abstract NbmapDirections.Builder toBuilder()

Returns the builder which created this instance of NbmapDirections and allows for modification and building a new directions request with new information.

Returns:

NbmapDirections.Builder with the same variables set as this directions object

Since:

3.0.0