Class DirectionFinder

Buscador dedirecciones

Permite recuperar instrucciones sobre cómo llegar entre ubicaciones.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para obtener las indicaciones sobre cómo ir de Times Square a Central Park, detenerte primero en el Lincoln Center, trazar las ubicaciones y la ruta en un mapa, y enviar el mapa por 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

Métodos

MétodoTipo de datos que se devuelveDescripción breve
addWaypoint(latitude, longitude)DirectionFinderAgrega una parada obligatoria por la que debe pasar la ruta, utilizando un punto (latitud y longitud).
addWaypoint(address)DirectionFinderAgrega una parada obligatoria por la que debe pasar la ruta, usando una dirección.
clearWaypoints()DirectionFinderBorra el conjunto actual de puntos de referencia.
getDirections()ObjectObtiene las instrucciones sobre cómo llegar usando el origen, el destino y otras opciones que se configuraron.
setAlternatives(useAlternatives)DirectionFinderEstablece 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)DirectionFinderEstablece la hora de llegada deseada (cuando corresponda).
setAvoid(avoid)DirectionFinderEstablece si se deben evitar ciertos tipos de restricciones.
setDepart(time)DirectionFinderEstablece la hora de salida deseada (cuando corresponda).
setDestination(latitude, longitude)DirectionFinderEstablece la ubicación final para la que se deben calcular las indicaciones sobre cómo llegar, utilizando un punto (latitud/longitud).
setDestination(address)DirectionFinderEstablece la ubicación final para la que se calcularán las instrucciones sobre cómo llegar, utilizando una dirección.
setLanguage(language)DirectionFinderEstablece el idioma que se usará para las instrucciones sobre cómo llegar.
setMode(mode)DirectionFinderEstablece el medio de viaje (de forma predeterminada, se establece en automóvil).
setOptimizeWaypoints(optimizeOrder)DirectionFinderEstablece si se optimizará o no la ruta proporcionada reordenando los puntos de referencia en un orden más eficiente (el valor predeterminado es false).
setOrigin(latitude, longitude)DirectionFinderEstablece la ubicación de partida desde la que se calcularán las instrucciones para llegar, utilizando un punto (latitud y longitud).
setOrigin(address)DirectionFinderEstablece la ubicación de inicio desde la que se calcularán las instrucciones para llegar, utilizando una dirección.
setRegion(region)DirectionFinderEstablece una región para usar cuando se interpreten nombres de ubicaciones.

Documentación detallada

addWaypoint(latitude, longitude)

Agrega una parada obligatoria por la que debe pasar la ruta, utilizando un punto (latitud y longitud). 

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

Parámetros

NombreTipoDescripción
latitudeNumberLatitud del punto de ruta.
longitudeNumberEs la longitud del punto de referencia.

Volver

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

addWaypoint(address)

Agrega una parada obligatoria por la que debe pasar la ruta, usando una dirección. 

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

Parámetros

NombreTipoDescripción
addressStringEs 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 usando el origen, el destino y otras opciones que se configuraron. 

// Logs how long it takes 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 indicaciones, como se describe aquí.

Consulta también

setAlternatives(useAlternatives)

Establece si se deben devolver rutas alternativas o no, en lugar de solo la ruta con la clasificación más alta (el valor predeterminado es false). Si es true, 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

NombreTipoDescripción
useAlternativesBooleantrue para devolver rutas alternativas; de lo contrario, false.

Volver

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

setArrive(time)

Establece la hora de llegada deseada (cuando corresponda). 

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

NombreTipoDescripción
timeDateEs la hora de llegada.

Volver

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

Consulta también

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

NombreTipoDescripción
avoidStringEs un valor constante de Avoid.

Volver

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

Consulta también

setDepart(time)

Establece la hora de salida deseada (cuando corresponda). 

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

NombreTipoDescripción
timeDateHora de salida.

Volver

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

Consulta también

setDestination(latitude, longitude)

Establece la ubicación final para la que se deben calcular las indicaciones sobre cómo llegar, utilizando un punto (latitud/longitud). 

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

Parámetros

NombreTipoDescripción
latitudeNumberLatitud de la ubicación final.
longitudeNumberEs la longitud de la ubicación final.

Volver

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

setDestination(address)

Establece la ubicación final para la que se calcularán las instrucciones sobre cómo llegar, utilizando 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

NombreTipoDescripción
addressStringEs la dirección final.

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

NombreTipoDescripción
languageStringEs un identificador de idioma BCP-47.

Volver

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

Consulta también

setMode(mode)

Establece el medio de viaje (de forma predeterminada, se establece en automóvil). 

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

Parámetros

NombreTipoDescripción
modeStringEs un valor constante de Mode.

Volver

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

Consulta también

setOptimizeWaypoints(optimizeOrder)

Establece si se optimizará o no la ruta proporcionada reordenando los puntos de referencia en un orden más eficiente (el valor predeterminado es false). 

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

Parámetros

NombreTipoDescripción
optimizeOrderBooleantrue para optimizar el pedido o false en cualquier otro caso.

Volver

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

Consulta también

setOrigin(latitude, longitude)

Establece la ubicación de partida desde la que se calcularán las indicaciones para llegar, utilizando un punto (latitud y longitud). 

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

Parámetros

NombreTipoDescripción
latitudeNumberEs la latitud de la ubicación de partida.
longitudeNumberEs 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 inicio desde la que se calcularán las instrucciones para llegar, utilizando 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

NombreTipoDescripción
addressStringEs la dirección de inicio.

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 nombres de 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

NombreTipoDescripción
regionStringEs el código de región que se usará.

Volver

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

Consulta también