Class DirectionFinder

DirectionFinder

Permite recuperar instrucciones sobre cómo llegar entre ubicaciones.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para obtener las instrucciones de cómo ir de Times Square a Central Park, deteniéndote primero en Lincoln Center, trazar las ubicaciones y la ruta en un mapa y enviar el mapa en un correo electrónico.

// Get the directions.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Times Square, New York, NY')
                       .addWaypoint('Lincoln Center, New York, NY')
                       .setDestination('Central Park, New York, NY')
                       .setMode(Maps.DirectionFinder.Mode.DRIVING)
                       .getDirections();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      String.fromCharCode(markerLetterCode),
  );
  map.addMarker(leg.end_location.lat, leg.end_location.lng);
  markerLetterCode++;
}

// Add a path for the entire route.
map.addPath(route.overview_polyline.points);

// Send the map in an email.
const toAddress = Session.getActiveUser().getEmail();
MailApp.sendEmail(
    toAddress,
    'Directions',
    `Please open: ${map.getMapUrl()}&key=YOUR_API_KEY`,
    {
      htmlBody: 'See below.<br/><img src="cid:mapImage">',
      inlineImages: {
        mapImage: Utilities.newBlob(map.getMapImage(), 'image/png'),
      },
    },
);

Consulta también

• API de Google Directions

Métodos

Método	Tipo de datos que se muestra	Descripción breve
addWaypoint(latitude, longitude)	DirectionFinder	Agrega un punto de referencia por el que debe pasar la ruta, con un punto (lat/lng).
addWaypoint(address)	DirectionFinder	Agrega un punto de referencia por el que debe pasar la ruta con una dirección.
clearWaypoints()	DirectionFinder	Borra el conjunto actual de puntos de referencia.
getDirections()	Object	Obtiene las instrucciones sobre cómo llegar con el origen, el destino y otras opciones que se configuraron.
setAlternatives(useAlternatives)	DirectionFinder	Establece si se deben mostrar rutas alternativas en lugar de solo la ruta con la clasificación más alta (el valor predeterminado es "false").
setArrive(time)	DirectionFinder	Establece la hora de llegada deseada (si corresponde).
setAvoid(avoid)	DirectionFinder	Establece si se deben evitar ciertos tipos de restricciones.
setDepart(time)	DirectionFinder	Establece la hora de salida deseada (si corresponde).
setDestination(latitude, longitude)	DirectionFinder	Establece la ubicación de destino para la que se deben calcular las instrucciones de viaje mediante un punto (lat/lng).
setDestination(address)	DirectionFinder	Establece la ubicación de destino para la que se deben calcular las instrucciones de viaje con una dirección.
setLanguage(language)	DirectionFinder	Establece el idioma que se usará para las instrucciones sobre cómo llegar.
setMode(mode)	DirectionFinder	Establece el modo de viaje (predeterminado: conducir).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Establece si se debe optimizar o no la ruta proporcionada reorganizando los puntos de referencia de una forma más eficiente (el valor predeterminado es "false").
setOrigin(latitude, longitude)	DirectionFinder	Establece la ubicación de partida a partir de la cual se deben calcular las instrucciones de conducción mediante un punto (lat/lng).
setOrigin(address)	DirectionFinder	Establece la ubicación de partida a partir de la cual se calcularán las instrucciones sobre cómo llegar, con una dirección.
setRegion(region)	DirectionFinder	Establece una región para usar cuando se interpreten los nombres de las ubicaciones.

Documentación detallada

addWaypoint(latitude, longitude)

Agrega un punto de referencia por el que debe pasar la ruta, con un punto (lat/lng).

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    40.772628,
    -73.984243,
);

Parámetros

Nombre	Tipo	Descripción
latitude	Number	Latitud del punto de referencia.
longitude	Number	Es la longitud del punto de referencia.

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

addWaypoint(address)

Agrega un punto de referencia por el que debe pasar la ruta con una dirección.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

Parámetros

Nombre	Tipo	Descripción
address	String	Una dirección.

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

clearWaypoints()

Borra el conjunto actual de puntos de referencia.

const directionFinder = Maps.newDirectionFinder();
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

getDirections()

Obtiene las instrucciones sobre cómo llegar con el origen, el destino y otras opciones que se configuraron.

// Logs how long it would take to walk from Times Square to Central Park.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Times Square, New York, NY')
                       .setDestination('Central Park, New York, NY')
                       .setMode(Maps.DirectionFinder.Mode.WALKING)
                       .getDirections();
Logger.log(directions.routes[0].legs[0].duration.text);

Volver

Object: Es un objeto JSON que contiene el conjunto de rutas para las instrucciones, como se describe aquí.

Consulta también

• API de Google Directions

---

setAlternatives(useAlternatives)

Establece si se deben mostrar rutas alternativas en lugar de solo la ruta con la clasificación más alta (el valor predeterminado es "false"). Si es verdadero, el array routes del objeto resultante puede contener varias entradas.

// Creates a DirectionFinder with alternative routes enabled.
const directionFinder = Maps.newDirectionFinder().setAlternatives(true);

Parámetros

Nombre	Tipo	Descripción
useAlternatives	Boolean	Es verdadero para mostrar rutas alternativas; de lo contrario, es falso.

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

setArrive(time)

Establece la hora de llegada deseada (si corresponde).

// Creates a DirectionFinder with an arrival time of 2 hours from now.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Parámetros

Nombre	Tipo	Descripción
time	Date	la hora de llegada

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions

---

setAvoid(avoid)

Establece si se deben evitar ciertos tipos de restricciones.

// Creates a DirectionFinder that avoid highways.
const directionFinder = Maps.newDirectionFinder().setAvoid(
    Maps.DirectionFinder.Avoid.HIGHWAYS,
);

Parámetros

Nombre	Tipo	Descripción
avoid	String	un valor constante de Avoid

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions

---

setDepart(time)

Establece la hora de salida deseada (si corresponde).

// Creates a DirectionFinder with a departure time of 1 hour from now.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

Parámetros

Nombre	Tipo	Descripción
time	Date	la hora de salida

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions

---

setDestination(latitude, longitude)

Establece la ubicación de destino para la que se deben calcular las instrucciones de viaje mediante un punto (lat/lng).

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    40.777052,
    -73.975464,
);

Parámetros

Nombre	Tipo	Descripción
latitude	Number	la latitud de la ubicación de destino
longitude	Number	la longitud de la ubicación de destino

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

setDestination(address)

Establece la ubicación de destino para la que se deben calcular las instrucciones de viaje con una dirección.

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

Parámetros

Nombre	Tipo	Descripción
address	String	la dirección de destino

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

setLanguage(language)

Establece el idioma que se usará para las instrucciones sobre cómo llegar.

// Creates a DirectionFinder with the language set to French.
const directionFinder = Maps.newDirectionFinder().setLanguage('fr');

Parámetros

Nombre	Tipo	Descripción
language	String	Un identificador de idioma BCP-47

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• Compatibilidad con idiomas en las APIs de Google Maps

---

setMode(mode)

Establece el modo de viaje (predeterminado: conducir).

// Creates a DirectionFinder with the mode set to walking.
const directionFinder = Maps.newDirectionFinder().setMode(
    Maps.DirectionFinder.Mode.WALKING,
);

Parámetros

Nombre	Tipo	Descripción
mode	String	un valor constante de Mode

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions

---

setOptimizeWaypoints(optimizeOrder)

Establece si se debe optimizar o no la ruta proporcionada reorganizando los puntos de referencia de una forma más eficiente (el valor predeterminado es "false").

// Creates a DirectionFinder with wapoint optimization enabled.
const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

Parámetros

Nombre	Tipo	Descripción
optimizeOrder	Boolean	Es verdadero para optimizar el orden; de lo contrario, es falso.

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions

---

setOrigin(latitude, longitude)

Establece la ubicación de partida a partir de la cual se deben calcular las instrucciones de conducción mediante un punto (lat/lng).

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    40.759011,
    -73.984472,
);

Parámetros

Nombre	Tipo	Descripción
latitude	Number	la latitud de la ubicación de partida
longitude	Number	la longitud de la ubicación de partida

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

---

setOrigin(address)

Establece la ubicación de partida a partir de la cual se calcularán las instrucciones sobre cómo llegar, con una dirección.

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    'Times Square, New York, NY',
);

Parámetros

Nombre	Tipo	Descripción
address	String	la dirección de partida

Volver

DirectionFinder: Es la instancia de DirectionFinder para facilitar la encadenación de llamadas.

---

setRegion(region)

Establece una región para usar cuando se interpreten los nombres de las ubicaciones. Los códigos de región admitidos corresponden a los ccTLD que admite Google Maps. Por ejemplo, el código de región "uk" corresponde a "maps.google.co.uk".

// Creates a DirectionFinder with the region set to France.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parámetros

Nombre	Tipo	Descripción
region	String	el código de región que se usará

Volver

DirectionFinder: Es el objeto DirectionFinder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Directions