Class DirectionFinder

DirectionFinder

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

// Get the directions.
var 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();
var route = directions.routes[0];

// Set up marker styles.
var markerSize = Maps.StaticMap.MarkerSize.MID;
var markerColor = Maps.StaticMap.Color.GREEN
var markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
var map = Maps.newStaticMap();
for (var i = 0; i < route.legs.length; i++) {
  var leg = route.legs[i];
  if (i == 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(markerSize, markerColor, 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.
var 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 muestraDescripción breve
addWaypoint(latitude, longitude)DirectionFinderAgrega un punto de referencia que la ruta debe atravesar utilizando un punto (lat/long).
addWaypoint(address)DirectionFinderAgrega un punto de referencia que la ruta debe atravesar usando una dirección.
clearWaypoints()DirectionFinderBorra el conjunto actual de puntos de referencia.
getDirections()ObjectObtiene las instrucciones sobre cómo llegar utilizando el origen, el destino y otras opciones que se configuraron.
setAlternatives(useAlternatives)DirectionFinderDefine si se deben mostrar rutas alternativas, en lugar de solo la ruta con la clasificación más alta (el valor predeterminado es falso).
setArrive(time)DirectionFinderEstablece la hora de llegada deseada (si corresponde).
setAvoid(avoid)DirectionFinderEstablece si se deben evitar ciertos tipos de restricciones.
setDepart(time)DirectionFinderEstablece la hora de salida deseada (si corresponde).
setDestination(latitude, longitude)DirectionFinderEstablece la ubicación final para la cual deben calcularse las indicaciones, mediante un punto (lat/long).
setDestination(address)DirectionFinderEstablece la ubicación final para la que deben calcularse las instrucciones sobre cómo llegar, utilizando una dirección.
setLanguage(language)DirectionFinderEstablece el idioma que se utilizará para las instrucciones sobre cómo llegar.
setMode(mode)DirectionFinderEstablece el medio de transporte (la configuración predeterminada es En automóvil).
setOptimizeWaypoints(optimizeOrder)DirectionFinderDetermina si se deben optimizar o no la ruta proporcionada reorganizando los puntos de referencia en un orden más eficiente (el valor predeterminado es falso).
setOrigin(latitude, longitude)DirectionFinderEstablece la ubicación inicial a partir de la cual se calcularán las indicaciones, mediante un punto (lat/long).
setOrigin(address)DirectionFinderEstablece la ubicación inicial a partir de la cual se calcularán las instrucciones sobre cómo llegar; para ello, utiliza una dirección.
setRegion(region)DirectionFinderConfigura una región para interpretar los nombres de las ubicaciones.

Documentación detallada

addWaypoint(latitude, longitude)

Agrega un punto de referencia que la ruta debe atravesar utilizando un punto (lat/long).

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

Parámetros

NombreTipoDescripción
latitudeNumberLatitud del punto de referencia.
longitudeNumberLongitud del punto de referencia.

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


addWaypoint(address)

Agrega un punto de referencia que la ruta debe atravesar usando una dirección.

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

Parámetros

NombreTipoDescripción
addressStringUna dirección.

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


clearWaypoints()

Borra el conjunto actual de puntos de referencia.

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

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


getDirections()

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

// Logs how long it would take to walk from Times Square to Central Park.
var 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);

Devolvedor

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

Consulta también


setAlternatives(useAlternatives)

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

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

Parámetros

NombreTipoDescripción
useAlternativesBooleantrue para mostrar rutas alternativas, de lo contrario, false

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita 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.
var now = new Date();
var arrive = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Parámetros

NombreTipoDescripción
timeDatela hora de llegada

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setAvoid(avoid)

Establece si se deben evitar ciertos tipos de restricciones.

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

Parámetros

NombreTipoDescripción
avoidStringun valor constante de Avoid

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setDepart(time)

Establece la hora de salida deseada (si corresponde).

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

Parámetros

NombreTipoDescripción
timeDatela hora de salida

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setDestination(latitude, longitude)

Establece la ubicación final para la cual deben calcularse las indicaciones, mediante un punto (lat/long).

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

Parámetros

NombreTipoDescripción
latitudeNumberLa latitud de la ubicación de finalización
longitudeNumberla longitud de la ubicación final

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


setDestination(address)

Establece la ubicación final para la que deben calcularse las instrucciones sobre cómo llegar, utilizando una dirección.

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

Parámetros

NombreTipoDescripción
addressStringla dirección final

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


setLanguage(language)

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

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

Parámetros

NombreTipoDescripción
languageStringun identificador de idioma BCP-47

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setMode(mode)

Establece el medio de transporte (la configuración predeterminada es En automóvil).

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

Parámetros

NombreTipoDescripción
modeStringun valor constante de Mode

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setOptimizeWaypoints(optimizeOrder)

Determina si se deben optimizar o no la ruta proporcionada reorganizando los puntos de referencia en un orden más eficiente (el valor predeterminado es falso).

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

Parámetros

NombreTipoDescripción
optimizeOrderBooleantrue para optimizar el orden o false de lo contrario

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también


setOrigin(latitude, longitude)

Establece la ubicación inicial a partir de la cual se calcularán las indicaciones, mediante un punto (lat/long).

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

Parámetros

NombreTipoDescripción
latitudeNumberLa latitud de la ubicación de inicio
longitudeNumberla longitud de la ubicación de partida

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.


setOrigin(address)

Establece la ubicación inicial a partir de la cual se calcularán las instrucciones sobre cómo llegar; para ello, utiliza una dirección.

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

Parámetros

NombreTipoDescripción
addressStringla dirección inicial

Devolvedor

DirectionFinder: Es la instancia de DirectionFinder, que facilita el encadenamiento de llamadas.


setRegion(region)

Configura una región para interpretar los nombres de las ubicaciones. Los códigos de región admitidos corresponden a los ccTLD admitidos por Google Maps. Por ejemplo, el código regional "uk" corresponde a "maps.google.co.uk".

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

Parámetros

NombreTipoDescripción
regionStringel código de región que se usará

Devolvedor

DirectionFinder: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.

Consulta también