Skip to main content

Map Matching

The Mapbox Map Matching API snaps fuzzy, inaccurate traces from a GPS unit or a device (such as a phone) to the OpenStreetMap road and path network using the Mapbox Directions API. The result is a clean path that can be displayed on a map or used for other analysis. The API can receive a list of 2 to 100 coordinate pairs.

For more information about this API, including its pricing structure, see the Mapbox Map Matching API documentation.

API request

To begin, you'll need to create a new instance of the MapboxMapMatching object and use its builder to customize your matching request. The options offered in the builder include whether to return steps and turn-by-turn instructions and the format of the returned geometry.

val client = MapboxMapMatching.builder()

Make sure to use the DirectionsCriteria to reference the default Mapbox directions profiles such as driving or walking.

API response

After creating the MapboxMapMatching instance with all your customization parameters, you'll need to handle the API response. Like all API calls made with the Mapbox Java SDK, the response will come inside a Retrofit callback. Inside onResponse(), you can access the API's returned response if successful.

client.enqueueCall(object : Callback<MapMatchingResponse> {
override fun onResponse(call: Call<MapMatchingResponse>, response: Response<MapMatchingResponse>) {


override fun onFailure(call: Call<MapMatchingResponse>, t: Throwable) {

Was this page helpful?