com.google.maps

Class DirectionsApiRequest

java.lang.Object

com.google.maps.DirectionsApiRequest

All Implemented Interfaces:

PendingResult<DirectionsResult>

public class DirectionsApiRequest
extends java.lang.Object

Request for the Directions API.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.maps.PendingResult

PendingResult.Callback<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	optimizeWaypoints
protected java.lang.String[]	waypoints

Method Summary

Modifier and Type	Method and Description
DirectionsApiRequest	alternatives(boolean alternateRoutes) If set to true, specifies that the Directions service may provide more than one route alternative in the response.
DirectionsApiRequest	arrivalTime(org.joda.time.ReadableInstant time) Set the arrival time for a Transit directions request.
DirectionsApiRequest	avoid(DirectionsApi.RouteRestriction... restrictions) Indicates that the calculated route(s) should avoid the indicated features.
T	await() Performs the GET request synchronously.
T	awaitIgnoreError() Performs the request synchronously, ignoring exceptions while performing the request and errors returned by the server.
void	cancel() Attempt to cancel the request.
A	channel(java.lang.String channel) A channel to pass with the request.
A	custom(java.lang.String parameter, java.lang.String value) Custom parameter.
DirectionsApiRequest	departureTime(org.joda.time.ReadableInstant time) Set the departure time for a transit or driving directions request.
DirectionsApiRequest	destination(LatLng destination) The destination, as a latitude,longitude location.
DirectionsApiRequest	destination(java.lang.String destination) The address or textual latitude/longitude value from which you wish to calculate directions.
A	language(java.lang.String language) The language in which to return results.
DirectionsApiRequest	mode(TravelMode mode) Specifies the mode of transport to use when calculating directions.
DirectionsApiRequest	optimizeWaypoints(boolean optimize) Allow the Directions service to optimize the provided route by rearranging the waypoints in a more efficient order.
DirectionsApiRequest	origin(LatLng origin) The origin, as a latitude,longitude location.
DirectionsApiRequest	origin(java.lang.String origin) The address or textual latitude/longitude value from which you wish to calculate directions.
protected A	param(java.lang.String key, java.lang.String val)
protected A	param(java.lang.String key, com.google.maps.internal.StringJoin.UrlValue val)
protected java.util.Map<java.lang.String,java.lang.String>	params()
DirectionsApiRequest	region(java.lang.String region)
void	setCallback(PendingResult.Callback<T> callback) Performs the request asynchronously, calling onResult or onFailure after the request has been completed.
DirectionsApiRequest	trafficModel(TrafficModel trafficModel) Specifies the traffic model to use when requesting future driving directions.
DirectionsApiRequest	transitMode(TransitMode... transitModes) Specifies one or more preferred modes of transit.
DirectionsApiRequest	transitRoutingPreference(TransitRoutingPreference pref) Specifies preferences for transit requests.
DirectionsApiRequest	units(Unit units) Specifies the unit system to use when displaying results.
protected void	validateRequest()
DirectionsApiRequest	waypoints(LatLng... waypoints) The list of waypoints as latitude,longitude locations.
DirectionsApiRequest	waypoints(java.lang.String... waypoints) Specifies a list of waypoints.

Methods inherited from class java.lang.Object

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

Field Detail

optimizeWaypoints

protected boolean optimizeWaypoints

waypoints

protected java.lang.String[] waypoints

Method Detail

validateRequest

protected void validateRequest()

origin

public DirectionsApiRequest origin(java.lang.String origin)

The address or textual latitude/longitude value from which you wish to calculate directions. If you pass an address as a string, the Directions service will geocode the string and convert it to a latitude/longitude coordinate to calculate directions. If you pass coordinates, ensure that no space exists between the latitude and longitude values.

destination

public DirectionsApiRequest destination(java.lang.String destination)

The address or textual latitude/longitude value from which you wish to calculate directions. If you pass an address as a string, the Directions service will geocode the string and convert it to a latitude/longitude coordinate to calculate directions. If you pass coordinates, ensure that no space exists between the latitude and longitude values.

origin

public DirectionsApiRequest origin(LatLng origin)

The origin, as a latitude,longitude location.

destination

public DirectionsApiRequest destination(LatLng destination)

The destination, as a latitude,longitude location.

mode

public DirectionsApiRequest mode(TravelMode mode)

Specifies the mode of transport to use when calculating directions. The mode defaults to driving if left unspecified. If you set the mode to TRANSIT you must also specify either a departureTime or an arrivalTime.

Parameters:

mode - The travel mode to request directions for.

avoid

public DirectionsApiRequest avoid(DirectionsApi.RouteRestriction... restrictions)

Indicates that the calculated route(s) should avoid the indicated features.

Parameters:

restrictions - one or more of DirectionsApi.RouteRestriction.TOLLS, DirectionsApi.RouteRestriction.HIGHWAYS, DirectionsApi.RouteRestriction.FERRIES

units

public DirectionsApiRequest units(Unit units)

Specifies the unit system to use when displaying results.

region

public DirectionsApiRequest region(java.lang.String region)

Parameters:

region - The region code, specified as a ccTLD ("top-level domain") two-character value.

arrivalTime

public DirectionsApiRequest arrivalTime(org.joda.time.ReadableInstant time)

Set the arrival time for a Transit directions request.

Parameters:

time - The arrival time to calculate directions for.

departureTime

public DirectionsApiRequest departureTime(org.joda.time.ReadableInstant time)

Set the departure time for a transit or driving directions request. If both departure time and traffic model are not provided, then "now" is assumed. If traffic model is supplied, then departure time must be specified.

Parameters:

time - The departure time to calculate directions for.

waypoints

public DirectionsApiRequest waypoints(java.lang.String... waypoints)

Specifies a list of waypoints. Waypoints alter a route by routing it through the specified location(s). A waypoint is specified as either a latitude/longitude coordinate or as an address which will be geocoded. Waypoints are only supported for driving, walking and bicycling directions.

For more information on waypoints, see Using Waypoints in Routes.

waypoints

public DirectionsApiRequest waypoints(LatLng... waypoints)

The list of waypoints as latitude,longitude locations.

optimizeWaypoints

public DirectionsApiRequest optimizeWaypoints(boolean optimize)

Allow the Directions service to optimize the provided route by rearranging the waypoints in a more efficient order.

alternatives

public DirectionsApiRequest alternatives(boolean alternateRoutes)

If set to true, specifies that the Directions service may provide more than one route alternative in the response. Note that providing route alternatives may increase the response time from the server.

transitMode

public DirectionsApiRequest transitMode(TransitMode... transitModes)

Specifies one or more preferred modes of transit. This parameter may only be specified for requests where the mode is transit.

transitRoutingPreference

public DirectionsApiRequest transitRoutingPreference(TransitRoutingPreference pref)

Specifies preferences for transit requests. Using this parameter, you can bias the options returned, rather than accepting the default best route chosen by the API.

trafficModel

public DirectionsApiRequest trafficModel(TrafficModel trafficModel)

Specifies the traffic model to use when requesting future driving directions. Once set, you must specify a departure time.

setCallback

public final void setCallback(PendingResult.Callback<T> callback)

Description copied from interface: PendingResult

Performs the request asynchronously, calling onResult or onFailure after the request has been completed.

Specified by:

setCallback in interface PendingResult<T>

await

public final T await()
              throws ApiException,
                     java.lang.InterruptedException,
                     java.io.IOException

Description copied from interface: PendingResult

Performs the GET request synchronously.

Specified by:

await in interface PendingResult<T>

Returns:

The result.

Throws:

ApiException

java.lang.InterruptedException

java.io.IOException

awaitIgnoreError

public final T awaitIgnoreError()

Description copied from interface: PendingResult

Performs the request synchronously, ignoring exceptions while performing the request and errors returned by the server.

Specified by:

awaitIgnoreError in interface PendingResult<T>

Returns:

The result, or null if there was any error or exception ignored.

cancel

public final void cancel()

Description copied from interface: PendingResult

Attempt to cancel the request.

Specified by:

cancel in interface PendingResult<T>

param

protected A param(java.lang.String key,
                  java.lang.String val)

param

protected A param(java.lang.String key,
                  com.google.maps.internal.StringJoin.UrlValue val)

params

protected java.util.Map<java.lang.String,java.lang.String> params()

language

public final A language(java.lang.String language)

The language in which to return results. Note that we often update supported languages so this list may not be exhaustive.

Parameters:

language - The language code, e.g. "en-AU" or "es"

See Also:

List of supported domain languages

channel

public A channel(java.lang.String channel)

A channel to pass with the request. channel is used by Google Maps API for Work users to be able to track usage across different applications with the same clientID. See: https://developers.google.com/maps/documentation/business/clientside/quota

Parameters:

channel - String to pass with the request for analytics

custom

public A custom(java.lang.String parameter,
                java.lang.String value)

Custom parameter. For advanced usage only. Note: Using this escape hatch parameter pass though voids all warranties, only use in extreme circumstances.