org.opentripplanner.api.common.RoutingResource Maven / Gradle / Ivy
Show all versions of otp Show documentation
package org.opentripplanner.api.common;
import org.opentripplanner.api.parameter.QualifiedModeSet;
import org.opentripplanner.model.FeedScopedId;
import org.opentripplanner.routing.core.BicycleOptimizeType;
import org.opentripplanner.routing.api.request.RoutingRequest;
import org.opentripplanner.routing.api.request.BannedStopSet;
import org.opentripplanner.standalone.server.OTPServer;
import org.opentripplanner.standalone.server.Router;
import org.opentripplanner.util.ResourceBundleSingleton;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.Context;
import javax.xml.datatype.DatatypeConfigurationException;
import javax.xml.datatype.DatatypeConstants;
import javax.xml.datatype.DatatypeFactory;
import javax.xml.datatype.XMLGregorianCalendar;
import java.time.Duration;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.HashMap;
import java.util.List;
import java.util.TimeZone;
/**
* This class defines all the JAX-RS query parameters for a path search as fields, allowing them to
* be inherited by other REST resource classes (the trip planner and the Analyst WMS or tile
* resource). They will be properly included in API docs generated by Enunciate. This implies that
* the concrete REST resource subclasses will be request-scoped rather than singleton-scoped.
*
* All defaults should be specified in the RoutingRequest, NOT as annotations on the query parameters.
* JSON router configuration can then overwrite those built-in defaults, and only the fields of the resulting prototype
* routing request for which query parameters are found are overwritten here. This establishes a priority chain:
* RoutingRequest field initializers, then JSON router config, then query parameters.
*
* @author abyrd
*/
public abstract class RoutingResource {
private static final Logger LOG = LoggerFactory.getLogger(RoutingResource.class);
/** The start location -- either latitude, longitude pair in degrees or a Vertex
* label. For example, 40.714476,-74.005966 or
* mtanyctsubway_A27_S. */
@QueryParam("fromPlace")
protected String fromPlace;
/** The end location (see fromPlace for format). */
@QueryParam("toPlace")
protected String toPlace;
/**
* An ordered list of intermediate locations to be visited (see the fromPlace for format).
* Parameter can be specified multiple times.
*
* @deprecated TODO OTP2 - Regression. Not currently working in OTP2. Must be re-implemented
* - using raptor.
*/
@Deprecated
@QueryParam("intermediatePlaces")
protected List intermediatePlaces;
/** The date that the trip should depart (or arrive, for requests where arriveBy is true). */
@QueryParam("date")
protected String date;
/** The time that the trip should depart (or arrive, for requests where arriveBy is true). */
@QueryParam("time")
protected String time;
/**
* This is the time/duration in seconds from the earliest-departure-time(EDT) to
* latest-departure-time(LDT). In case of a reverse search it will be the time from earliest
* to latest arrival time (LAT minus EAT).
*
* All optimal travels that depart within the search window is guarantied to be found.
*
* This is sometimes referred to as the Range Raptor Search Window - but should apply to all
* scheduled/time dependent travels.
*
* Optional - it is NOT recommended to set this value, unless you use the value returned by the
* previous search. Then it can be used to get the next/previous "page". The value is
* dynamically assigned a suitable value, if not set. In a small to medium size operation
* you may use a fixed value, like 60 minutes. If you have a mixture of high frequency cities
* routes and infrequent long distant journeys, the best option is normally to use the dynamic
* auto assignment.
*/
@QueryParam("searchWindow")
protected Integer searchWindow;
/**
* Whether the trip should depart or arrive at the specified date and time.
*
* @deprecated TODO OTP2 Regression. Needs to be implemented in Raptor.
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2885
*/
@Deprecated
@QueryParam("arriveBy")
protected Boolean arriveBy;
/**
* Whether the trip must be wheelchair accessible.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2. This is not implemented
* in Raptor jet.
*/
@Deprecated
@QueryParam("wheelchair")
protected Boolean wheelchair;
/**
* The maximum distance (in meters) the user is willing to walk. Defaults to unlimited.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2. We might not implement the
* old functionality the same way, but we will try to map this parameter
* so it does work similar as before.
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2886
*/
@Deprecated
@QueryParam("maxWalkDistance")
protected Double maxWalkDistance;
/**
* The maximum time (in seconds) of pre-transit travel when using drive-to-transit (park and
* ride or kiss and ride). Defaults to unlimited.
*
* @deprecated TODO OTP2 - Regression. Not currently working in OTP2.
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2886
*/
@Deprecated
@QueryParam("maxPreTransitTime")
protected Integer maxPreTransitTime;
/**
* A multiplier for how bad walking is, compared to being in transit for equal lengths of time.
* Defaults to 2. Empirically, values between 10 and 20 seem to correspond well to the concept
* of not wanting to walk too much without asking for totally ridiculous itineraries, but this
* observation should in no way be taken as scientific or definitive. Your mileage may vary.
*/
@QueryParam("walkReluctance")
protected Double walkReluctance;
/**
* How much worse is waiting for a transit vehicle than being on a transit vehicle, as a
* multiplier. The default value treats wait and on-vehicle time as the same.
*
* It may be tempting to set this higher than walkReluctance (as studies often find this kind of
* preferences among riders) but the planner will take this literally and walk down a transit
* line to avoid waiting at a stop. This used to be set less than 1 (0.95) which would make
* waiting offboard preferable to waiting onboard in an interlined trip. That is also
* undesirable.
*
* If we only tried the shortest possible transfer at each stop to neighboring stop patterns,
* this problem could disappear.
*/
@QueryParam("waitReluctance")
protected Double waitReluctance;
/** How much less bad is waiting at the beginning of the trip (replaces waitReluctance) */
@QueryParam("waitAtBeginningFactor")
protected Double waitAtBeginningFactor;
/** The user's walking speed in meters/second. Defaults to approximately 3 MPH. */
@QueryParam("walkSpeed")
protected Double walkSpeed;
/** The user's biking speed in meters/second. Defaults to approximately 11 MPH, or 9.5 for bikeshare. */
@QueryParam("bikeSpeed")
protected Double bikeSpeed;
/** The time it takes the user to fetch their bike and park it again in seconds.
* Defaults to 0. */
@QueryParam("bikeSwitchTime")
protected Integer bikeSwitchTime;
/** The cost of the user fetching their bike and parking it again.
* Defaults to 0. */
@QueryParam("bikeSwitchCost")
protected Integer bikeSwitchCost;
/** For bike triangle routing, how much safety matters (range 0-1). */
@QueryParam("triangleSafetyFactor")
protected Double triangleSafetyFactor;
/** For bike triangle routing, how much slope matters (range 0-1). */
@QueryParam("triangleSlopeFactor")
protected Double triangleSlopeFactor;
/** For bike triangle routing, how much time matters (range 0-1). */
@QueryParam("triangleTimeFactor")
protected Double triangleTimeFactor;
/**
* The set of characteristics that the user wants to optimize for. @See OptimizeType.
*
* @deprecated TODO OTP2 this should be completely removed and done only with individual cost
* parameters
* Also: apparently OptimizeType only affects BICYCLE mode traversal of
* street segments. If this is the case it should be very well
* documented and carried over into the Enum name.
*/
@Deprecated
@QueryParam("optimize")
protected BicycleOptimizeType optimize;
/**
* The set of modes that a user is willing to use, with qualifiers stating whether vehicles
* should be parked, rented, etc.
*
* The possible values of the comma-separated list are:
*
*
* - WALK
* - TRANSIT
* - BICYCLE
* - BICYCLE_RENT
* - BICYCLE_PARK
* - CAR
* - CAR_PARK
* - TRAM
* - SUBWAY
* - RAIL
* - BUS
* - CABLE_CAR
* - FERRY
* - GONDOLA
* - FUNICULAR
* - AIRPLANE
*
*
* For a more complete discussion of this parameter see
* Routing modes.
*/
@QueryParam("mode")
protected QualifiedModeSet modes;
/**
* The minimum time, in seconds, between successive trips on different vehicles.
* This is designed to allow for imperfect schedule adherence. This is a minimum;
* transfers over longer distances might use a longer time.
*
* @deprecated TODO OTP2: Needs to be implemented
*/
@Deprecated
@QueryParam("minTransferTime")
protected Integer minTransferTime;
/** The maximum number of possible itineraries to return. */
@QueryParam("numItineraries")
protected Integer numItineraries;
/**
* The comma-separated list of preferred agencies.
*
* @deprecated TODO OTP2: Needs to be implemented
*/
@Deprecated
@QueryParam("preferredAgencies")
protected String preferredAgencies;
/**
* The comma-separated list of unpreferred agencies.
*
* @deprecated TODO OTP2: Needs to be implemented
*/
@Deprecated
@QueryParam("unpreferredAgencies")
protected String unpreferredAgencies;
/**
* The comma-separated list of banned agencies.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@QueryParam("bannedAgencies")
protected String bannedAgencies;
/**
* Functions the same as banned agencies, except only the listed agencies are allowed.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@QueryParam("whiteListedAgencies")
protected String whiteListedAgencies;
/**
* Whether intermediate stops -- those that the itinerary passes in a vehicle, but
* does not board or alight at -- should be returned in the response. For example,
* on a Q train trip from Prospect Park to DeKalb Avenue, whether 7th Avenue and
* Atlantic Avenue should be included.
*/
@QueryParam("showIntermediateStops")
protected Boolean showIntermediateStops;
/**
* Prevents unnecessary transfers by adding a cost for boarding a vehicle. This is the cost that
* is used when boarding while walking.
*/
@QueryParam("walkBoardCost")
protected Integer walkBoardCost;
/**
* Prevents unnecessary transfers by adding a cost for boarding a vehicle. This is the cost that
* is used when boarding while cycling. This is usually higher that walkBoardCost.
*/
@QueryParam("bikeBoardCost")
protected Integer bikeBoardCost;
/**
* The comma-separated list of banned routes. The format is agency_[routename][_routeid], so
* TriMet_100 (100 is route short name) or Trimet__42 (two underscores, 42 is the route
* internal ID).
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@Deprecated
@QueryParam("bannedRoutes")
protected String bannedRoutes;
/**
* Functions the same as bannnedRoutes, except only the listed routes are allowed.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@QueryParam("whiteListedRoutes")
@Deprecated
protected String whiteListedRoutes;
/**
* The list of preferred routes. The format is agency_[routename][_routeid], so TriMet_100
* (100 is route short name) or Trimet__42 (two underscores, 42 is the route internal ID).
*
* @deprecated TODO OTP2 Needs to be implemented
*/
@Deprecated
@QueryParam("preferredRoutes")
protected String preferredRoutes;
/**
* The list of unpreferred routes. The format is agency_[routename][_routeid], so TriMet_100
* (100 is route short name) or Trimet__42 (two underscores, 42 is the route internal ID).
*
* @deprecated TODO OTP2 Needs to be implemented
*/
@Deprecated
@QueryParam("unpreferredRoutes")
protected String unpreferredRoutes;
/**
* Penalty added for using every route that is not preferred if user set any route as
* preferred, i.e. number of seconds that we are willing to wait for preferred route.
*
* @deprecated TODO OTP2 Needs to be implemented
*/
@Deprecated
@QueryParam("otherThanPreferredRoutesPenalty")
protected Integer otherThanPreferredRoutesPenalty;
/**
* The comma-separated list of banned trips. The format is agency_trip[:stop*], so:
* TriMet_24601 or TriMet_24601:0:1:2:17:18:19
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@Deprecated
@QueryParam("bannedTrips")
protected String bannedTrips;
/**
* A comma-separated list of banned stops. A stop is banned by ignoring its
* pre-board and pre-alight edges. This means the stop will be reachable via the
* street network. Also, it is still possible to travel through the stop. Just
* boarding and alighting is prohibited.
* The format is agencyId_stopId, so: TriMet_2107
*
* @deprecated TODO OTP2 This no longer works in OTP2, see issue #2843.
*/
@Deprecated
@QueryParam("bannedStops")
protected String bannedStops;
/**
* A comma-separated list of banned stops. A stop is banned by ignoring its
* pre-board and pre-alight edges. This means the stop will be reachable via the
* street network. It is not possible to travel through the stop.
* For example, this parameter can be used when a train station is destroyed, such
* that no trains can drive through the station anymore.
* The format is agencyId_stopId, so: TriMet_2107
*
* @deprecated TODO OTP2 This no longer works in OTP2, see issue #2843.
*/
@Deprecated
@QueryParam("bannedStopsHard")
protected String bannedStopsHard;
/**
* An additional penalty added to boardings after the first. The value is in OTP's
* internal weight units, which are roughly equivalent to seconds. Set this to a high
* value to discourage transfers. Of course, transfers that save significant
* time or walking will still be taken.
*/
@QueryParam("transferPenalty")
protected Integer transferPenalty;
/**
* An additional penalty added to boardings after the first when the transfer is not
* preferred. Preferred transfers also include timed transfers. The value is in OTP's
* internal weight units, which are roughly equivalent to seconds. Set this to a high
* value to discourage transfers that are not preferred. Of course, transfers that save
* significant time or walking will still be taken.
* When no preferred or timed transfer is defined, this value is ignored.
*
* TODO OTP2 This JavaDoc needs clarification. What is a "preferred" Transfer, the GTFS
* specification do not have "preferred Transfers". The GTFS spec transfer
* type 0 is _Recommended transfer point_ - is this what is meant?
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2. We might not implement the
* old functionality the same way, but we will try to map this parameter
* so it does work similar as before.
*/
@Deprecated
@QueryParam("nonpreferredTransferPenalty")
protected Integer nonpreferredTransferPenalty;
/**
* The maximum number of transfers (that is, one plus the maximum number of boardings)
* that a trip will be allowed.
*
* Consider using the {@link #transferPenalty} instead of this parameter.
*
* @deprecated TODO OTP2 Regression. A maxTransfers should be set in the router config, not
* here. Instead the client should be able to pass in a parameter for
* the max number of additional/extra transfers relative to the best
* trip (with the fewest possible transfers) within constraint of the
* other search parameters.
* This might be to complicated to explain to the customer, so we
* might stick to the old limit, but that have side-effects that you
* might not find any trips on a day where a critical part of the
* trip is not available, because of some real-time disruption.
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2886
*/
@Deprecated
@QueryParam("maxTransfers")
protected Integer maxTransfers;
/**
* If true, goal direction is turned off and a full path tree is built (specify only once)
*
* @Deprecated - This is not supported in OTP2 any more.
*/
@Deprecated
@QueryParam("batch")
protected Boolean batch;
/**
* A transit stop required to be the first stop in the search (AgencyId_StopId)
*
* @deprecated TODO OTP2 Is this in use, what is is used for. It seems to overlap with
* the fromPlace parameter. Is is used for onBoard routing only?
*/
@Deprecated
@QueryParam("startTransitStopId")
protected String startTransitStopId;
/**
* A transit trip acting as a starting "state" for depart-onboard routing (AgencyId_TripId)
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2. We might not implement the
* old functionality the same way, but we will try to map this parameter
* so it does work similar as before.
*/
@Deprecated
@QueryParam("startTransitTripId")
protected String startTransitTripId;
/**
* When subtracting initial wait time, do not subtract more than this value, to prevent overly
* optimistic trips. Reasoning is that it is reasonable to delay a trip start 15 minutes to
* make a better trip, but that it is not reasonable to delay a trip start 15 hours; if that
* is to be done, the time needs to be included in the trip time. This number depends on the
* transit system; for transit systems where trips are planned around the vehicles, this number
* can be much higher. For instance, it's perfectly reasonable to delay one's trip 12 hours if
* one is taking a cross-country Amtrak train from Emeryville to Chicago. Has no effect in
* stock OTP, only in Analyst.
*
* A value of 0 means that initial wait time will not be subtracted out (will be clamped to 0).
* A value of -1 (the default) means that clamping is disabled, so any amount of initial wait
* time will be subtracted out.
*
* @deprecated This parameter is not in use any more.
*/
@Deprecated
@QueryParam("clampInitialWait")
protected Long clampInitialWait;
/**
* THIS PARAMETER IS NO LONGER IN USE.
*
* If true, this trip will be reverse-optimized on the fly. Otherwise, reverse-optimization
* will occur once a trip has been chosen (in Analyst, it will not be done at all).
*
* @deprecated This parameter is not in use any more after the transit search switched from
* AStar to Raptor.
*/
@Deprecated
@QueryParam("reverseOptimizeOnTheFly")
protected Boolean reverseOptimizeOnTheFly;
/**
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@Deprecated
@QueryParam("boardSlack")
private Integer boardSlack;
/**
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@Deprecated
@QueryParam("alightSlack")
private Integer alightSlack;
@QueryParam("locale")
private String locale;
/**
* If true, realtime updates are ignored during this search.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2.
*/
@Deprecated
@QueryParam("ignoreRealtimeUpdates")
protected Boolean ignoreRealtimeUpdates;
/**
* If true, the remaining weight heuristic is disabled. Currently only implemented for the long
* distance path service.
*/
@QueryParam("disableRemainingWeightHeuristic")
protected Boolean disableRemainingWeightHeuristic;
/**
* @deprecated TODO OTP2 This is not useful as a search parameter, but could be used as a
* post search filter to reduce number of itineraries down to an
* acceptable number, but there are probably better ways to do that.
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2886
*/
@Deprecated
@QueryParam("maxHours")
private Double maxHours;
/**
* @deprecated see {@link #maxHours}
* @see https://github.com/opentripplanner/OpenTripPlanner/issues/2886
*/
@QueryParam("useRequestedDateTimeInMaxHours")
@Deprecated
private Boolean useRequestedDateTimeInMaxHours;
@QueryParam("disableAlertFiltering")
private Boolean disableAlertFiltering;
@QueryParam("debugItineraryFilter")
private Boolean debugItineraryFilter;
/**
* If true, the Graph's ellipsoidToGeoidDifference is applied to all elevations returned by this query.
*/
@QueryParam("geoidElevation")
private Boolean geoidElevation;
/**
* Set the method of sorting itineraries in the response. Right now, the only supported value is "duration";
* otherwise it uses default sorting. More sorting methods may be added in the future.
*
* @deprecated TODO OTP2 Regression. Not currently working in OTP2 at the moment.
*/
@Deprecated
@QueryParam("pathComparator")
private String pathComparator;
/**
* somewhat ugly bug fix: the graphService is only needed here for fetching per-graph time zones.
* this should ideally be done when setting the routing context, but at present departure/
* arrival time is stored in the request as an epoch time with the TZ already resolved, and other
* code depends on this behavior. (AMB)
* Alternatively, we could eliminate the separate RoutingRequest objects and just resolve
* vertices and timezones here right away, but just ignore them in semantic equality checks.
*/
@Context
protected OTPServer otpServer;
/**
* Range/sanity check the query parameter fields and build a Request object from them.
*
* @throws ParameterException when there is a problem interpreting a query parameter
*/
protected RoutingRequest buildRequest() throws ParameterException {
Router router = otpServer.getRouter();
RoutingRequest request = router.defaultRoutingRequest.clone();
// The routing request should already contain defaults, which are set when it is initialized or in the JSON
// router configuration and cloned. We check whether each parameter was supplied before overwriting the default.
if (fromPlace != null)
request.from = LocationStringParser.fromOldStyleString(fromPlace);
if (toPlace != null)
request.to = LocationStringParser.fromOldStyleString(toPlace);
{
//FIXME: move into setter method on routing request
TimeZone tz;
tz = router.graph.getTimeZone();
if (date == null && time != null) { // Time was provided but not date
LOG.debug("parsing ISO datetime {}", time);
try {
// If the time query param doesn't specify a timezone, use the graph's default. See issue #1373.
DatatypeFactory df = javax.xml.datatype.DatatypeFactory.newInstance();
XMLGregorianCalendar xmlGregCal = df.newXMLGregorianCalendar(time);
GregorianCalendar gregCal = xmlGregCal.toGregorianCalendar();
if (xmlGregCal.getTimezone() == DatatypeConstants.FIELD_UNDEFINED) {
gregCal.setTimeZone(tz);
}
Date d2 = gregCal.getTime();
request.setDateTime(d2);
} catch (DatatypeConfigurationException e) {
request.setDateTime(date, time, tz);
}
} else {
request.setDateTime(date, time, tz);
}
}
if(searchWindow != null) {
request.searchWindow = Duration.ofSeconds(searchWindow);
}
if (wheelchair != null)
request.setWheelchairAccessible(wheelchair);
if (numItineraries != null)
request.setNumItineraries(numItineraries);
if (maxWalkDistance != null) {
request.setMaxWalkDistance(maxWalkDistance);
request.maxTransferWalkDistance = maxWalkDistance;
}
if (maxPreTransitTime != null)
request.setMaxPreTransitTime(maxPreTransitTime);
if (walkReluctance != null)
request.setWalkReluctance(walkReluctance);
if (waitReluctance != null)
request.setWaitReluctance(waitReluctance);
if (waitAtBeginningFactor != null)
request.setWaitAtBeginningFactor(waitAtBeginningFactor);
if (walkSpeed != null)
request.walkSpeed = walkSpeed;
if (bikeSpeed != null)
request.bikeSpeed = bikeSpeed;
if (bikeSwitchTime != null)
request.bikeSwitchTime = bikeSwitchTime;
if (bikeSwitchCost != null)
request.bikeSwitchCost = bikeSwitchCost;
if (optimize != null) {
// Optimize types are basically combined presets of routing parameters, except for triangle
request.setOptimize(optimize);
if (optimize == BicycleOptimizeType.TRIANGLE) {
RoutingRequest.assertTriangleParameters(
triangleSafetyFactor, triangleTimeFactor, triangleSlopeFactor
);
request.setBikeTriangleSafetyFactor(triangleSafetyFactor);
request.setBikeTriangleSlopeFactor(triangleSlopeFactor);
request.setBikeTriangleTimeFactor(triangleTimeFactor);
}
}
if (arriveBy != null) {
request.setArriveBy(arriveBy);
}
if (showIntermediateStops != null) {
request.showIntermediateStops = showIntermediateStops;
}
if (intermediatePlaces != null) {
request.setIntermediatePlacesFromStrings(intermediatePlaces);
}
if (preferredRoutes != null) {
request.setPreferredRoutesFromSting(preferredRoutes);
}
if (otherThanPreferredRoutesPenalty != null) {
request.setOtherThanPreferredRoutesPenalty(otherThanPreferredRoutesPenalty);
}
if (preferredAgencies != null) {
request.setPreferredAgenciesFromString(preferredAgencies);
}
if (unpreferredRoutes != null) {
request.setUnpreferredRoutesFromSting(unpreferredRoutes);
}
if (unpreferredAgencies != null) {
request.setUnpreferredAgenciesFromString(unpreferredAgencies);
}
if (walkBoardCost != null) {
request.setWalkBoardCost(walkBoardCost);
}
if (bikeBoardCost != null) {
request.setBikeBoardCost(bikeBoardCost);
}
if (bannedRoutes != null) {
request.setBannedRoutesFromSting(bannedRoutes);
}
if (whiteListedRoutes != null) {
request.setWhiteListedRoutesFromSting(whiteListedRoutes);
}
if (bannedAgencies != null) {
request.setBannedAgenciesFromSting(bannedAgencies);
}
if (whiteListedAgencies != null) {
request.setWhiteListedAgenciesFromSting(whiteListedAgencies);
}
HashMap bannedTripMap = makeBannedTripMap(bannedTrips);
if (bannedTripMap != null) {
request.bannedTrips = bannedTripMap;
}
// The "Least transfers" optimization is accomplished via an increased transfer penalty.
// See comment on RoutingRequest.transferPentalty.
if (transferPenalty != null) { request.transferCost = transferPenalty; }
if (optimize == BicycleOptimizeType.TRANSFERS) {
optimize = BicycleOptimizeType.QUICK;
request.transferCost += 1800;
}
if (optimize != null) {
request.setOptimize(optimize);
}
/* Temporary code to get bike/car parking and renting working. */
if (modes != null && !modes.qModes.isEmpty()) {
request.modes = modes.getRequestModes();
}
if (request.bikeRental && bikeSpeed == null) {
//slower bike speed for bike sharing, based on empirical evidence from DC.
request.bikeSpeed = 4.3;
}
if (boardSlack != null)
request.boardSlack = boardSlack;
if (alightSlack != null)
request.alightSlack = alightSlack;
if (minTransferTime != null) {
int alightAndBoardSlack = request.boardSlack + request.alightSlack;
if (alightAndBoardSlack > minTransferTime) {
throw new IllegalArgumentException(
"Invalid parameters: 'minTransferTime' must be greater than or equal to board slack plus alight slack"
);
}
request.transferSlack = minTransferTime - alightAndBoardSlack;
}
if (nonpreferredTransferPenalty != null)
request.nonpreferredTransferCost = nonpreferredTransferPenalty;
if (maxTransfers != null)
request.maxTransfers = maxTransfers;
final long NOW_THRESHOLD_MILLIS = 15 * 60 * 60 * 1000;
boolean tripPlannedForNow = Math.abs(request.getDateTime().getTime() - new Date().getTime()) < NOW_THRESHOLD_MILLIS;
request.useBikeRentalAvailabilityInformation = tripPlannedForNow; // TODO the same thing for GTFS-RT
if (startTransitStopId != null && !startTransitStopId.isEmpty())
request.startingTransitStopId = FeedScopedId.parseId(startTransitStopId);
if (startTransitTripId != null && !startTransitTripId.isEmpty())
request.startingTransitTripId = FeedScopedId.parseId(startTransitTripId);
if (ignoreRealtimeUpdates != null)
request.ignoreRealtimeUpdates = ignoreRealtimeUpdates;
if (disableRemainingWeightHeuristic != null)
request.disableRemainingWeightHeuristic = disableRemainingWeightHeuristic;
if (maxHours != null)
request.maxHours = maxHours;
if (useRequestedDateTimeInMaxHours != null)
request.useRequestedDateTimeInMaxHours = useRequestedDateTimeInMaxHours;
if (disableAlertFiltering != null)
request.disableAlertFiltering = disableAlertFiltering;
if (geoidElevation != null)
request.geoidElevation = geoidElevation;
if (pathComparator != null)
request.pathComparator = pathComparator;
if(debugItineraryFilter != null ) {
request.debugItineraryFilter = debugItineraryFilter;
}
//getLocale function returns defaultLocale if locale is null
request.locale = ResourceBundleSingleton.INSTANCE.getLocale(locale);
return request;
}
/**
* Take a string in the format agency:id or agency:id:1:2:3:4.
* TODO Improve Javadoc. What does this even mean? Why are there so many colons and numbers?
* Convert to a Map from trip --> set of int.
*/
public HashMap makeBannedTripMap(String banned) {
if (banned == null) {
return null;
}
HashMap bannedTripMap = new HashMap();
String[] tripStrings = banned.split(",");
for (String tripString : tripStrings) {
// TODO this apparently allows banning stops within a trip with integers. Why?
String[] parts = tripString.split(":");
if (parts.length < 2) continue; // throw exception?
String agencyIdString = parts[0];
String tripIdString = parts[1];
FeedScopedId tripId = new FeedScopedId(agencyIdString, tripIdString);
BannedStopSet bannedStops;
if (parts.length == 2) {
bannedStops = BannedStopSet.ALL;
} else {
bannedStops = new BannedStopSet();
for (int i = 2; i < parts.length; ++i) {
bannedStops.add(Integer.parseInt(parts[i]));
}
}
bannedTripMap.put(tripId, bannedStops);
}
return bannedTripMap;
}
}