Using Promises

Request Woosmap services asynchronously through Map JavaScript API

  1. Handling Asynchronous Operations
  2. Working with Promises
  3. Using Async and Await

Handling Asynchronous Operations

The Woosmap Map JavaScript API provides a convenient way to manage asynchronous service calls. Each service operation is associated with an asynchronous function that initiates the operation and returns a Promise object. You can attach handlers to this Promise object, which will be executed when the operation is either successful or unsuccessful.

The services currently implemented in Map JS that support Promises are:

Any error that occurs during the execution of the service call is captured and handled as a rejected Promise. It is then passed in the catch callback as an APIError object.

Working with Promises

The Promise object includes then, catch, and finally methods, each accepting callback functions.

In the following example, a promise is returned that is either fulfilled with a Localities geocode response object or rejected with an error object. This approach allows for separate callbacks for success and failure scenarios, rather than a single callback responsible for error detection.

Using ES6 Promises
        const localitiesService = new;
const latLng = {lat: 43.610, lng: 3.876};

const promise = localitiesService.geocode({latLng});

    .then((response) => {
    .catch((error) => {
    .finally(() => {


Using Async and Await

You can use the async/await pattern in your calls to the Map JS API. The await operator is used to wait for a Promise. It can only be used inside an async function.

The following example uses async/await to reverse geocode a location using LocalitiesService.

Using async/await pattern
        const runLocalitiesGeocode = async () => {
    const localitiesService = new;
    const latLng = {lat: 43.610, lng: 3.876};
    try {
        const response = await localitiesService.geocode({latLng});
    } catch (error) {


Was this article helpful?
Have more questions? Submit a request