MapboxMapMatching.Builder (services 4.2.0-SNAPSHOT API)

java.lang.Object
- com.mapbox.api.matching.v5.MapboxMapMatching.Builder

Enclosing class:

MapboxMapMatching
```
public abstract static class MapboxMapMatching.Builder
extends java.lang.Object
```
Builds your map matching query by adding parameters.

Since:

2.0.0

Constructor Summary

Constructors
Constructor and Description

Builder()

Constructors
Constructor and Description
`Builder()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract MapboxMapMatching.Builder`	`accessToken(java.lang.String accessToken)` Required to call when this is being built.
`MapboxMapMatching.Builder`	`addApproaches(java.lang.String... approaches)` Optionally used to indicate how map matched routes consider rom which side of the road to approach a waypoint.
`MapboxMapMatching.Builder`	`addWaypointNames(java.lang.String... waypointNames)` Custom names for waypoints used for the arrival instruction, each separated by ; .
`MapboxMapMatching.Builder`	`annotations(java.lang.String... annotations)` Whether or not to return additional metadata along the route.
`protected abstract MapboxMapMatching.Builder`	`annotations(java.lang.String annotations)`
`protected abstract MapboxMapMatching`	`autoBuild()`
`abstract MapboxMapMatching.Builder`	`bannerInstructions(java.lang.Boolean bannerInstructions)` Setting this will determine Whether or not to return banner objects associated with the `routeSteps`.
`abstract MapboxMapMatching.Builder`	`baseUrl(java.lang.String baseUrl)` Optionally change the APIs base URL to something other then the default Mapbox one.
`MapboxMapMatching`	`build()` This uses the provided parameters set using the `MapboxMapMatching.Builder` and first checks that all values are valid, formats the values as strings for easier consumption by the API, and lastly creates a new `MapboxMapMatching` object with the values provided.
`abstract MapboxMapMatching.Builder`	`clientAppName(java.lang.String clientAppName)` Base package name or other simple string identifier.
`MapboxMapMatching.Builder`	`coordinate(com.mapbox.geojson.Point coordinate)` This will add a single `Point` to the coordinate list which is used to determine the duration between points.
`MapboxMapMatching.Builder`	`coordinates(java.util.List<com.mapbox.geojson.Point> coordinates)` Add a list of `Point`'s which define the points to perform the map matching on.
`protected abstract MapboxMapMatching.Builder`	`coordinates(java.lang.String coordinates)`
`abstract MapboxMapMatching.Builder`	`geometries(java.lang.String geometries)` alter the default geometry being returned for the map matching route.
`MapboxMapMatching.Builder`	`language(java.util.Locale language)` Set the instruction language for the map matching request, the default is english.
`abstract MapboxMapMatching.Builder`	`language(java.lang.String language)` Set the instruction language for the map matching request, the default is english.
`abstract MapboxMapMatching.Builder`	`overview(java.lang.String overview)` Type of returned overview geometry.
`abstract MapboxMapMatching.Builder`	`profile(java.lang.String profile)` This selects which mode of transportation the user will be using to accurately give the map matching route.
`MapboxMapMatching.Builder`	`radiuses(java.lang.Double... radiuses)` Optionally, set the maximum distance in meters that each coordinate is allowed to move when snapped to a nearby road segment.
`abstract MapboxMapMatching.Builder`	`roundaboutExits(java.lang.Boolean roundaboutExits)` Setting this will determine whether to return steps and turn-by-turn instructions.
`abstract MapboxMapMatching.Builder`	`steps(java.lang.Boolean steps)` Setting this will determine whether to return steps and turn-by-turn instructions.
`abstract MapboxMapMatching.Builder`	`tidy(java.lang.Boolean tidy)` Whether or not to transparently remove clusters and re-sample traces for improved map matching results.
`MapboxMapMatching.Builder`	`timestamps(java.lang.String... timestamps)` Timestamps corresponding to each coordinate provided in the request; must be numbers in Unix time (seconds since the Unix epoch) converted to a String.
`protected abstract MapboxMapMatching.Builder`	`timestamps(java.lang.String timestamps)`
`abstract MapboxMapMatching.Builder`	`user(java.lang.String user)` The username for the account that the directions engine runs on.
`abstract MapboxMapMatching.Builder`	`voiceInstructions(java.lang.Boolean voiceInstructions)` Setting this will determine whether to return steps and turn-by-turn instructions.
`abstract MapboxMapMatching.Builder`	`voiceUnits(java.lang.String voiceUnits)` Specify what unit you'd like voice and banner instructions to use.
`MapboxMapMatching.Builder`	`waypoints(java.lang.Integer... waypoints)` Optionally, set which input coordinates should be treated as waypoints.

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
  - accessToken
```
public abstract MapboxMapMatching.Builder accessToken(@NonNull
                                                      java.lang.String accessToken)
```
    Required to call when this is being built. If no access token provided, ServicesException will be thrown.
    
    Parameters:
    
    accessToken - Mapbox access token, You must have a Mapbox account inorder to use the Map Matching API
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - tidy
```
public abstract MapboxMapMatching.Builder tidy(@Nullable
                                               java.lang.Boolean tidy)
```
    Whether or not to transparently remove clusters and re-sample traces for improved map matching results. Pass in null to reset to the APIs default setting.
    
    Parameters:
    
    tidy - true if you'd like the API to remove coordinates clustered together, otherwise false
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - user
```
public abstract MapboxMapMatching.Builder user(@NonNull
                                               java.lang.String user)
```
    The username for the account that the directions engine runs on. In most cases, this should always remain the default value of DirectionsCriteria.PROFILE_DEFAULT_USER.
    
    Parameters:
    
    user - a non-null string which will replace the default user used in the map matching request
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - profile
```
public abstract MapboxMapMatching.Builder profile(@NonNull
                                                  java.lang.String profile)
```
    This selects which mode of transportation the user will be using to accurately give the map matching route. The options include driving, driving considering traffic, walking, and cycling. Using each of these profiles will result in different durations
    
    Parameters:
    
    profile - required to be one of the String values found in the DirectionsCriteria.ProfileCriteria
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - geometries
```
public abstract MapboxMapMatching.Builder geometries(@Nullable
                                                     java.lang.String geometries)
```
    alter the default geometry being returned for the map matching route. A null value will reset this field to the APIs default value vs this SDKs default value of DirectionsCriteria.GEOMETRY_POLYLINE6.
    Note that while the API supports GeoJson as an option for geometry, this SDK intentionally removes this as an option since an encoded string for the geometry significantly reduces bandwidth on mobile devices and speeds up response time.
    
    Parameters:
    
    geometries - null if you'd like the default geometry, else one of the options found in DirectionsCriteria.GeometriesCriteria.
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.0.0
  - radiuses
```
public MapboxMapMatching.Builder radiuses(@Nullable
                                          java.lang.Double... radiuses)
```
    Optionally, set the maximum distance in meters that each coordinate is allowed to move when snapped to a nearby road segment. There must be as many radiuses as there are coordinates in the request. Values can be any number greater than 0 or they can be unlimited simply by passing Double.POSITIVE_INFINITY.
    If no routable road is found within the radius, a NoSegment error is returned.
    
    Parameters:
    
    radiuses - double array containing the radiuses defined in unit meters.
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    1.0.0
  - waypoints
```
public MapboxMapMatching.Builder waypoints(@Nullable
                                           java.lang.Integer... waypoints)
```
    Optionally, set which input coordinates should be treated as waypoints.
    Most useful in combination with steps=true and requests based on traces with high sample rates. Can be an index corresponding to any of the input coordinates, but must contain the first ( 0 ) and last coordinates' index separated by ; . MapboxMapMatching.steps()
    
    Parameters:
    
    waypoints - integer array of coordinate indices to be used as waypoints
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - steps
```
public abstract MapboxMapMatching.Builder steps(@Nullable
                                                java.lang.Boolean steps)
```
    Setting this will determine whether to return steps and turn-by-turn instructions. Can be set to either true or false to enable or disable respectively. null can also optionally be passed in to set the default behavior to match what the API does by default.
    
    Parameters:
    
    steps - true if you'd like step information
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    1.0.0
  - overview
```
public abstract MapboxMapMatching.Builder overview(@Nullable
                                                   java.lang.String overview)
```
    Type of returned overview geometry. Can be DirectionsCriteria.OVERVIEW_FULL (the most detailed geometry available), DirectionsCriteria.OVERVIEW_SIMPLIFIED (a simplified version of the full geometry), or DirectionsCriteria.OVERVIEW_FALSE (no overview geometry). The default is simplified. Passing in null will use the APIs default setting for the overview field.
    
    Parameters:
    
    overview - null or one of the options found in DirectionsCriteria.OverviewCriteria
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    1.0.0
  - bannerInstructions
```
public abstract MapboxMapMatching.Builder bannerInstructions(@Nullable
                                                             java.lang.Boolean bannerInstructions)
```
    Setting this will determine Whether or not to return banner objects associated with the `routeSteps`. Should be used in conjunction with `steps`. Can be set to either true or false to enable or disable respectively. null can also optionally be passed in to set the default behavior to match what the API does by default.
    
    Parameters:
    
    bannerInstructions - true if you'd like step information
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - voiceInstructions
```
public abstract MapboxMapMatching.Builder voiceInstructions(@Nullable
                                                            java.lang.Boolean voiceInstructions)
```
    Setting this will determine whether to return steps and turn-by-turn instructions. Can be set to either true or false to enable or disable respectively. null can also optionally be passed in to set the default behavior to match what the API does by default.
    
    Parameters:
    
    voiceInstructions - true if you'd like step information
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - voiceUnits
```
public abstract MapboxMapMatching.Builder voiceUnits(@Nullable
                                                     java.lang.String voiceUnits)
```
    Specify what unit you'd like voice and banner instructions to use.
    
    Parameters:
    
    voiceUnits - either Imperial (default) or Metric
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - roundaboutExits
```
public abstract MapboxMapMatching.Builder roundaboutExits(@Nullable
                                                          java.lang.Boolean roundaboutExits)
```
    Setting this will determine whether to return steps and turn-by-turn instructions. Can be set to either true or false to enable or disable respectively. null can also optionally be passed in to set the default behavior to match what the API does by default.
    
    Parameters:
    
    roundaboutExits - true if you'd like step information
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - annotations
```
public MapboxMapMatching.Builder annotations(@Nullable
                                             java.lang.String... annotations)
```
    Whether or not to return additional metadata along the route. Possible values are: DirectionsCriteria.ANNOTATION_DISTANCE, DirectionsCriteria.ANNOTATION_DURATION, DirectionsCriteria.ANNOTATION_DURATION and DirectionsCriteria.ANNOTATION_CONGESTION.
    
    Parameters:
    
    annotations - string referencing one of the annotation direction criteria's. The strings restricted to one or multiple values inside the DirectionsCriteria.AnnotationCriteria or null which will result in no annotations being used
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
    
    See Also:
    
    RouteLeg object documentation
  - annotations
```
protected abstract MapboxMapMatching.Builder annotations(@Nullable
                                                         java.lang.String annotations)
```
  - timestamps
```
public MapboxMapMatching.Builder timestamps(@Nullable
                                            java.lang.String... timestamps)
```
    Timestamps corresponding to each coordinate provided in the request; must be numbers in Unix time (seconds since the Unix epoch) converted to a String. There must be as many timestamps as there are coordinates in the request.
    
    Parameters:
    
    timestamps - timestamp corresponding to the coordinate added at the identical index
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - timestamps
```
protected abstract MapboxMapMatching.Builder timestamps(@Nullable
                                                        java.lang.String timestamps)
```
  - coordinates
```
public MapboxMapMatching.Builder coordinates(@NonNull
                                             java.util.List<com.mapbox.geojson.Point> coordinates)
```
    Add a list of Point's which define the points to perform the map matching on. The minimum points is 2 and the maximum points allowed in totals 100. You can use this method in conjunction with coordinate(Point).
    
    Parameters:
    
    coordinates - a List full of Points which define the points to perform the map matching on
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - coordinates
```
protected abstract MapboxMapMatching.Builder coordinates(@NonNull
                                                         java.lang.String coordinates)
```
  - coordinate
```
public MapboxMapMatching.Builder coordinate(@NonNull
                                            com.mapbox.geojson.Point coordinate)
```
    This will add a single Point to the coordinate list which is used to determine the duration between points. This can be called up to 100 times until you hit the maximum allowed points. You can use this method in conjunction with coordinates(List).
    
    Parameters:
    
    coordinate - a Point which you'd like the map matching APi to perform on
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
  - language
```
public MapboxMapMatching.Builder language(@Nullable
                                          java.util.Locale language)
```
    Set the instruction language for the map matching request, the default is english. Only a select number of languages are currently supported, reference the table provided in the see link below.
    
    Parameters:
    
    language - a Locale value representing the language you'd like the instructions to be written in when returned
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.0.0
    
    See Also:
    
    Supported Languages
  - language
```
public abstract MapboxMapMatching.Builder language(java.lang.String language)
```
    Set the instruction language for the map matching request, the default is english. Only a select number of languages are currently supported, reference the table provided in the see link below.
    
    Parameters:
    
    language - a String value representing the language you'd like the instructions to be written in when returned
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.2.0
    
    See Also:
    
    Supported Languages
  - clientAppName
```
public abstract MapboxMapMatching.Builder clientAppName(@NonNull
                                                        java.lang.String clientAppName)
```
    Base package name or other simple string identifier. Used inside the calls user agent header.
    
    Parameters:
    
    clientAppName - base package name or other simple string identifier
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    1.0.0
  - addApproaches
```
public MapboxMapMatching.Builder addApproaches(@Nullable
                                               java.lang.String... approaches)
```
    Optionally used to indicate how map matched routes consider rom which side of the road to approach a waypoint. Accepts unrestricted (default), curb or null. If set to unrestricted , the map matched route can approach waypoints from either side of the road. If set to curb , the map matched route will be returned so that on arrival, the waypoint will be found on the side that corresponds with the driving_side of the region in which the returned route is located. If provided, the list of approaches must be the same length as the list of waypoints.
    
    Parameters:
    
    approaches - null if you'd like the default approaches, else one of the options found in DirectionsCriteria.ApproachesCriteria.
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.2.0
  - addWaypointNames
```
public MapboxMapMatching.Builder addWaypointNames(@Nullable
                                                  java.lang.String... waypointNames)
```
    Custom names for waypoints used for the arrival instruction, each separated by ; . Values can be any string and total number of all characters cannot exceed 500. If provided, the list of waypointNames must be the same length as the list of waypoints, but you can skip a coordinate and show its position with the ; separator.
    
    Parameters:
    
    waypointNames - Custom names for waypoints used for the arrival instruction.
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    3.3.0
  - baseUrl
```
public abstract MapboxMapMatching.Builder baseUrl(java.lang.String baseUrl)
```
    Optionally change the APIs base URL to something other then the default Mapbox one.
    
    Parameters:
    
    baseUrl - base url used as end point
    
    Returns:
    
    this builder for chaining options together
    
    Since:
    
    2.1.0
  - autoBuild
```
protected abstract MapboxMapMatching autoBuild()
```
  - build
```
public MapboxMapMatching build()
```
    This uses the provided parameters set using the MapboxMapMatching.Builder and first checks that all values are valid, formats the values as strings for easier consumption by the API, and lastly creates a new MapboxMapMatching object with the values provided.
    
    Returns:
    
    a new instance of Mapbox Map Matching
    
    Throws:
    
    com.mapbox.core.exceptions.ServicesException - when a provided parameter is detected to be incorrect
    
    Since:
    
    2.1.0

Class MapboxMapMatching.Builder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Builder

Method Detail

accessToken

tidy

user

profile

geometries

radiuses

waypoints

steps

overview

bannerInstructions

voiceInstructions

voiceUnits

roundaboutExits

annotations

annotations

timestamps

timestamps

coordinates

coordinates

coordinate

language

language

clientAppName

addApproaches

addWaypointNames

baseUrl

autoBuild

build