Source: https://developers.woosmap.com/products/distance-api/guides/migration/

> For clean Markdown of any page, append `.md` to the page URL.

> For a complete documentation index, see https://developers.woosmap.com/llms.txt

# Migrating from Google Directions & Distance Matrix



Google's Directions API and Distance Matrix API map to Woosmap's **Distance API**:
[Route endpoint](/products/distance-api/features/route/) for directions,
[Matrix endpoint](/products/distance-api/features/matrix/) for many-to-many calculations.

## REST API: Directions (Route)

```bash
# Google Maps
curl "https://maps.googleapis.com/maps/api/directions/json?origin=48.8566,2.3522&destination=52.5246,13.4235&key=YOUR_GOOGLE_KEY"

# Woosmap
curl "https://api.woosmap.com/distance/route/json?origin=48.8566,2.3522&destination=52.5246,13.4235&private_key=YOUR_PRIVATE_KEY"
```

> ⚠️ The endpoint is `/distance/route/json`, not `/directions/json` — a global find-and-replace won't catch this.

## REST API: Distance Matrix

```bash
# Google Maps
curl "https://maps.googleapis.com/maps/api/distancematrix/json?origins=48.8566,2.3522&destinations=52.5246,13.4235|40.7128,-74.0060&key=YOUR_KEY"

# Woosmap
curl "https://api.woosmap.com/distance/distancematrix/json?origins=48.8566,2.3522&destinations=52.5246,13.4235|40.7128,-74.0060&key=YOUR_KEY"
```

## JS SDK

Same pattern as the map migration — namespace swap:

```js
// Google Maps
const directionsService = new google.maps.DirectionsService();
const directionsRenderer = new google.maps.DirectionsRenderer({ map });

directionsService.route(
  {
    origin: { lat: 48.8566, lng: 2.3522 },
    destination: { lat: 52.5246, lng: 13.4235 },
    travelMode: google.maps.TravelMode.DRIVING,
  },
  (result, status) => {
    if (status === "OK") directionsRenderer.setDirections(result);
  }
);

// Woosmap
const directionsService = new woosmap.map.DirectionsService();
const directionsRenderer = new woosmap.map.DirectionsRenderer({ map });

directionsService.route(
  {
    origin: { lat: 48.8566, lng: 2.3522 },
    destination: { lat: 52.5246, lng: 13.4235 },
    travelMode: woosmap.map.TravelMode.DRIVING,
    unitSystem: woosmap.map.UnitSystem.METRIC,
  },
  (result, status) => {
    if (status === "OK") directionsRenderer.setDirections(result);
  }
);
```

Note the `unitSystem` parameter — Woosmap lets you request `METRIC` or `IMPERIAL` results directly.

## Travel Modes

| Travel Mode | Google (Routes API) | Woosmap REST | Woosmap JS SDK                   |
| :---------- | :------------------ | :----------- | :------------------------------- |
| Driving     | `DRIVE`             | `driving`    | `woosmap.map.TravelMode.DRIVING` |
| Walking     | `WALK`              | `walking`    | `woosmap.map.TravelMode.WALKING` |
| Cycling     | `BICYCLE`           | `cycling`    | `woosmap.map.TravelMode.CYCLING` |

Woosmap's `mode` parameter is case-insensitive.

## Key Differences

| Area            | Google Maps            | Woosmap                                 |
| :-------------- | :--------------------- | :-------------------------------------- |
| Directions path | `/directions/json`     | `/distance/route/json`                  |
| Matrix path     | `/distancematrix/json` | `/distance/distancematrix/json`         |
| Authentication  | Single `key`           | `key` (client) / `private_key` (server) |