Promessas

Métodos assíncronos na API Google Maps JavaScript retornam promessas.

Suporte

API	Métodos retornam promessas
Directions	Sim
Distance Matrix	Sim
Elevation	Sim
Geocoder	Sim
Maximum Zoom Imagery	Sim
Places	Não
Serviço Place Autocomplete	Parcial^1
Streetview	Sim

Observação: a partir de 2020, as novas APIs só aceitam promessas.

Uso

Consulte este guia sobre o uso de promessas ou os exemplos abaixo para fazer chamadas de método assíncronas com a API Google Maps JavaScript.

Async e await

O operador "await" é usado para aguardar uma promessa. Ele só pode ser colocado em uma função assíncrona.

const app = async () => {
  const elevationService = google.maps.ElevationService();
  const locations = [{lat: 27.986065, lng:86.922623}];

  const response = await elevationService.getElevationForLocation({locations});
  console.log(response.results);
};

app();

Then, catch e finally

O objeto Promise tem métodos then, catch e finally, que recebem funções de callback.

const elevationService = google.maps.ElevationService();
const locations = [{lat: 27.986065, lng:86.922623}];

const promise = elevationService.getElevationForLocation({locations});

promise
    .then((response) => {
      console.log(response.results);
    })
    .catch((error) => {
      console.log(error);
    });
    .finally(() => {
      console.log('done');
    });

Padrão de callback assíncrono

O padrão de callback continua válido e compatível.

const elevationService = google.maps.ElevationService();
const locations = [{lat: 27.986065, lng:86.922623}];

const callback = (results, status) => {
  if (status === 'OK') {
    console.log(results);
  } else {
    // handle this case
  }
};

elevationService.getElevationForLocation({locations}, callback);

Observação: desde 2020, as novas APIs só aceitam promessas.

---

1. No momento, as promessas são aceitas apenas em getPlacePredictions(). ↩