com.here.mobility.sdk.demand

Class RideOffersRequest.Builder

java.lang.Object

com.here.mobility.sdk.demand.RideOffersRequest.Builder

Enclosing class:

RideOffersRequest

public abstract static class RideOffersRequest.Builder
extends Object

Builder to create RideOffersRequest object.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
abstract RideOffersRequest	build() Return the newly-created RideOffersRequest.
abstract RideOffersRequest.Builder	setConstraints(BookingConstraints newConstraints) Constraints that the supplier must allow, like number of passengers, wheelchair, etc.
abstract RideOffersRequest.Builder	setLocale(String locale) Set the locale to use for the RideOffer.
abstract RideOffersRequest.Builder	setMaxNumberOfOffers(Integer maxOffers) Optional Maximun number of offers sets Maximun number of offers to be returned
abstract RideOffersRequest.Builder	setPassengerNote(String passengerNote) Optional note from the passenger.
abstract RideOffersRequest.Builder	setPaymentTypeFilter(PaymentTypeFilter paymentTypeFilter) Optional payment type filter.
abstract RideOffersRequest.Builder	setPrebookPickupTime(Long newPrebookPickupTime) Optional pickup time, if the ride is requested for more than 30 minutes in the future.
abstract RideOffersRequest.Builder	setPriceRange(PriceRange newPriceRange) Optional allowed price range.
abstract RideOffersRequest.Builder	setRideWaypoints(RideWaypoints newRideWaypoints) The requested waypoints.
abstract RideOffersRequest.Builder	setSortType(RideOffersRequest.SortType newSortType) Optional sort type.
abstract RideOffersRequest.Builder	setTransitOptions(TransitOptions options) Optional Transit options.
abstract RideOffersRequest.Builder	setTransportTypeFilter(Collection<RideOffer.TransitType> transportTypeFilter) Optional Transport type Filter.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

setRideWaypoints

public abstract RideOffersRequest.Builder setRideWaypoints(RideWaypoints newRideWaypoints)

The requested waypoints.

setConstraints

public abstract RideOffersRequest.Builder setConstraints(BookingConstraints newConstraints)

Constraints that the supplier must allow, like number of passengers, wheelchair, etc.

setPrebookPickupTime

public abstract RideOffersRequest.Builder setPrebookPickupTime(Long newPrebookPickupTime)

Optional pickup time, if the ride is requested for more than 30 minutes in the future. The time is given in milliseconds since Epoch. The pre-book time can be calculated easily by use of DemandDateTime. It's important to calculate the Epoch pre-book time by using the correct pickup TimeZone to prevent mismatch timezone for example using the current application timezone when the requested pickup point is in a different timeZone. It can be done by sending the pickup location to TimeZoneClient.findTimeZone(LatLng, Long).
Code example:

  
 	LatLng pickupLocation = LatLng.fromDegrees(lat, lng);
  TimeZoneClient client = TimeZoneClient.newInstance();
  client.findTimeZone(pickupLocation).registerListener(new ResponseListener<TimeZone>() {

  	public void onResponse(@NonNull TimeZone timeZone) {
  		DemandDateTime prebookPickupTime = DemandDateTime(2019, 1, 1, 12, 0);
  		Long timeSinceEpoch = prebookPickupTime.getEpochTime(timeZone);
  	}

  	public void onError(@NonNull ResponseException exception) {}
  });
  client.shutdown();
 	
 

setPriceRange

public abstract RideOffersRequest.Builder setPriceRange(PriceRange newPriceRange)

Optional allowed price range.

setSortType

public abstract RideOffersRequest.Builder setSortType(RideOffersRequest.SortType newSortType)

Optional sort type. If not given, the order is by price, and then by ETA.

setPassengerNote

public abstract RideOffersRequest.Builder setPassengerNote(String passengerNote)

Optional note from the passenger.

setTransitOptions

public abstract RideOffersRequest.Builder setTransitOptions(TransitOptions options)

Optional Transit options. This will affect the public transport offers.

setTransportTypeFilter

public abstract RideOffersRequest.Builder setTransportTypeFilter(Collection<RideOffer.TransitType> transportTypeFilter)

Optional Transport type Filter. sets which transport types offers will be returned If set to null it's the same as not being set, i.e. get all Transport type

setLocale

public abstract RideOffersRequest.Builder setLocale(String locale)

Set the locale to use for the RideOffer. Complies with the ISO 639-1 standard. If not set the default is MobilitySdk#getUserPreferences()#getLocale().

setMaxNumberOfOffers

public abstract RideOffersRequest.Builder setMaxNumberOfOffers(Integer maxOffers)

Optional Maximun number of offers sets Maximun number of offers to be returned

setPaymentTypeFilter

public abstract RideOffersRequest.Builder setPaymentTypeFilter(PaymentTypeFilter paymentTypeFilter)

Optional payment type filter. Sets which payment types offers will be returned If set to null or not set, it will be considered as the default value of PaymentTypeFilter.OFFLINE

build

public abstract RideOffersRequest build()

Return the newly-created RideOffersRequest.