Migrating from Google Directions & Distance Matrix

Migrate from Google Directions API and Distance Matrix API to Woosmap Distance API — REST endpoints, JS SDK examples, and key differences.

Google’s Directions API and Distance Matrix API map to Woosmap’s Distance API: Route endpoint for directions, Matrix endpoint for many-to-many calculations.

REST API: Directions (Route)

Shell
        # 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

Shell
        # 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:

JavaScript
        // 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.

route() has no Promise form. It returns undefined, and without a callback it throws an uncaught TypeError. Google code that uses await or .then() needs the callback, or a wrapper:

JavaScript
        const route = (request) =>
  new Promise((resolve, reject) => {
    directionsService.route(request, (result, status) => {
      if (status === "OK") resolve(result);
      else reject(new Error(status));
    });
  });

const result = await route({ origin, destination, travelMode: woosmap.map.TravelMode.DRIVING });

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)
‹ Driving Directions with Map JS Language Support ›
Was this helpful?