Skip to main content
All notable changes to react-native-maps-routes are documented on this page.

Latest Version: 1.5.2

1.5.2 (2026-02-27)

Bug Fixes

  • deps: update dependency react-native to v0.84.1 (#736) (9399b6e)

Previous Versions

1.5.1 (2026-02-11)

Bug Fixes

  • deps: update dependency react-native to v0.84.0 (#725) (7037f67)

1.5.0 (2026-02-10)

Features

  • Route Modifiers and Request Overrides (#724) (9bc55e2)
Adds support for route modifiers to customize routing behavior:
  • routeModifiers prop: Control route preferences like avoidTolls, avoidHighways, avoidFerries, and avoidIndoor
  • requestBodyOverrides prop: Override or add any field to the Routes API request body for advanced customization
Example:
import type { RouteModifiers } from 'react-native-maps-routes';

const routeModifiers: RouteModifiers = {
  avoidTolls: true,
  avoidHighways: false,
};

<MapViewRoute
  routeModifiers={routeModifiers}
  requestBodyOverrides={{ languageCode: 'en', regionCode: 'us' }}
  // ...
/>

1.4.0 (2026-02-10)

Features

Adds support for route legs and turn-by-turn navigation:
  • legFields prop: Request leg-level data like duration, distance, start/end locations
  • legStepFields prop: Request step-level data including navigation instructions
  • onLegs callback: Receive detailed route segment information
Example:
<MapViewRoute
  legFields={['duration', 'distanceMeters']}
  legStepFields={['navigationInstruction']}
  onLegs={(legs) => {
    legs.forEach(leg => {
      leg.steps?.forEach(step => {
        console.log(step.navigationInstruction?.instructions);
      });
    });
  }}
  // ...
/>
Only request the fields you need to minimize API costs. The field mask is automatically generated based on your selections.

1.3.8 (2025-12-18)

Bug Fixes

  • deps: update dependency react-native to v0.83.1 (#702) (4b6c0c1)

1.3.7 (2025-12-15)

Bug Fixes

  • deps: update dependency react-native to v0.83.0 (#696) (9b2ff93)

1.3.6 (2025-10-20)

Bug Fixes

  • deps: update dependency react-native to v0.82.1 (#672) (c1686e0)

1.3.5 (2025-10-08)

Bug Fixes

  • deps: update dependency react-native to v0.82.0 (#663) (bae9936)

1.3.4 (2025-09-12)

Bug Fixes

  • deps: update dependency react-native to v0.81.4 (#642) (ad26843)

1.3.3 (2025-08-27)

Bug Fixes

  • deps: update dependency react-native to v0.81.1 (#632) (340a6e3)

1.3.2 (2025-08-12)

Bug Fixes

  • deps: update dependency react-native to v0.81.0 (#625) (d249e34)

1.3.1 (2025-07-24)

Bug Fixes

  • deps: update dependency react-native to v0.80.2 (#611) (e57e618)

1.3.0 (2025-07-05)

Features

Adds support for intermediate waypoints between origin and destination:
  • waypoints prop: Array of up to 25 LatLng objects
  • Routes now pass through each waypoint in order
Example:
const waypoints = [
  { latitude: 37.352280, longitude: -122.030980 },
  { latitude: 37.382199, longitude: -122.054068 },
];

<MapViewRoute
  origin={origin}
  destination={destination}
  waypoints={waypoints}
  // ...
/>

1.2.2 (2025-06-30)

Bug Fixes

  • deps: update dependency react-native to v0.80.1 (#593) (f7d2f8d)

1.2.1 (2025-06-12)

Bug Fixes

  • deps: update dependency react-native to v0.80.0 (#583) (80e5d28)

1.2.0 (2025-05-27)

Features

Adds ability to fetch the total distance of the route:
  • enableDistance prop: Set to true to enable distance calculation
  • onDistance callback: Receives the distance in meters
Example:
<MapViewRoute
  enableDistance
  onDistance={(distanceInMeters) => {
    console.log('Route distance:', distanceInMeters / 1000, 'km');
  }}
  // ...
/>

1.1.0 (2025-05-07)

Features

Adds ability to fetch estimated travel time (ETA):
  • enableEstimatedTime prop: Set to true to enable ETA calculation
  • onEstimatedTime callback: Receives the estimated time in milliseconds
Example:
<MapViewRoute
  enableEstimatedTime
  onEstimatedTime={(timeInMs) => {
    const minutes = Math.floor(timeInMs / 60000);
    console.log('ETA:', minutes, 'minutes');
  }}
  // ...
/>

Bug Fixes

1.0.4 (2025-03-01)

Bug Fixes

  • dx: align developer experience with other react-native-maps libraries (#514) (047b89c)

1.0.3 (2023-06-09)

Bug Fixes

  • deps: align peer dependencies (#6) (9d73adc)

1.0.2 (2023-06-09)

Minor improvements and documentation updates.

1.0.1 (2023-06-09)

Minor improvements and documentation updates.

1.0.0 (2023-06-09)

Features

First stable release of react-native-maps-routes! Core Features:
  • Route rendering between origin and destination coordinates
  • Support for multiple travel modes: DRIVE, WALK, BICYCLE, TWO_WHEELER
  • Customizable route styling (stroke color, width, line cap, line join)
  • Integration with Google Maps Routes API
  • TypeScript support with full type definitions
  • Callbacks for route ready and error states

View all releases on GitHub: https://github.com/huextrat/react-native-maps-routes/releases
Want to stay updated? Watch the GitHub repository to get notified about new releases.

Upgrade Guide

For help upgrading between versions, see the Migration Guide.

Build docs developers (and LLMs) love