Stay on the move with powerful routing: the OpenRouteService Android Client brings ORS’s routing APIs to your Android apps with ease.

What is it?

The ORS Android Client is a lightweight Kotlin library that connects Android apps to the OpenRouteService APIs. It supports creating routes, retrieving GPX tracks, and more — all with simple, structured code. See the project on GitHub.

Key Features

• Full ORS API access: routing for car, bike, pedestrian, and more.
• Flexible request constructs: use domain objects or a Kotlin DSL.
• Helper classes: utilities for GPX export and coordinate handling.
• Open source under the Apache-2.0 license.

How to get started

1. Add the dependency

   implementation("org.nitri.ors:ors-android-client:<latest-version>")

   or

   implementation("com.github.Pygmalion69:ors-android-client:<latest-version>")

2. Create a client with your ORS API key

   val ors = Ors.create("<your_api_key>", context)

3. Make routing requests

   val request = RouteRequest(
     coordinates = listOf(
       listOf(8.681495, 49.41461),
       listOf(8.687872, 49.420318)
     )
   )
   val route: RouteResponse = ors.getRoute(Profile.DRIVING_CAR, request)

4. Use helpers for convenience
   The RouteHelper makes it easy to convert coordinates, format routes, or export GPX.

Why use it?

• Quickly integrate routing into your Android projects.
• Reduce boilerplate with ready-made helpers and DSLs.
• Get full control over ORS API features.
• Open source: inspect, contribute, or adapt freely.

More Information

Visit the GitHub repository for documentation, setup instructions, and examples.