Class DirectionFinder

DirectionFinder

Permite recuperar direcciones entre ubicaciones.
El siguiente ejemplo muestra cómo puedes usar esta clase para obtener las instrucciones sobre cómo llegar de Times Square a Central Park, se detiene primero en Lincoln Center, traza las ubicaciones y los caminos en un mapa, y envía 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 por el que debe pasar la ruta, utilizando un punto (lat/long).
addWaypoint(address)DirectionFinderAgrega un punto de referencia por el que debe pasar la ruta, con una dirección.
clearWaypoints()DirectionFinderBorra el conjunto actual de puntos de referencia.
getDirections()ObjectObtiene las instrucciones sobre cómo llegar según el origen, el destino y otras opciones que se hayan establecido.
setAlternatives(useAlternatives)DirectionFinderEstablece si se deben mostrar rutas alternativas o no, en lugar de solo las rutas con mejor clasificación ruta (el valor predeterminado es false).
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 de destino hasta la que se calcularán las indicaciones, utilizando un punto (lat./long.).
setDestination(address)DirectionFinderEstablece la ubicación de destino para la que se calcularán las instrucciones sobre cómo llegar, mediante 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)DirectionFinderDefine si se optimizará o no la ruta proporcionada reorganizando los puntos de referencia de una forma eficiente (el valor predeterminado es falso).
setOrigin(latitude, longitude)DirectionFinderEstablece la ubicación de partida desde la que se calcularán las indicaciones mediante un punto (lat./long.).
setOrigin(address)DirectionFinderEstablece la ubicación de partida desde la que se calcularán las instrucciones sobre cómo llegar, en función de una dirección.
setRegion(region)DirectionFinderConfigura la región que se 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, 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.

Volver

DirectionFinder: Es el objeto DirectionsFinder que facilita 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.
var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');

Parámetros

NombreTipoDescripción
addressStringUna dirección.

Volver

DirectionFinder: Es el objeto DirectionsFinder 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();

Volver

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


getDirections()

Obtiene las instrucciones sobre cómo llegar según el origen, el destino y otras opciones que se hayan establecido.

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

Volver

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)

Establece si se deben mostrar rutas alternativas o no, en lugar de solo las rutas con mejor clasificación ruta (el valor predeterminado es false). Si es verdadero, el array routes del objeto resultante puede contienen varias entradas.

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

Parámetros

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

Volver

DirectionFinder: Es el objeto DirectionsFinder 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

Volver

DirectionFinder: Es el objeto DirectionsFinder 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

Volver

DirectionFinder: Es el objeto DirectionsFinder 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

Volver

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

Consulta también


setDestination(latitude, longitude)

Establece la ubicación de destino hasta la que se calcularán las indicaciones, utilizando 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 de finalización

Volver

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


setDestination(address)

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

Volver

DirectionFinder: Es el objeto DirectionsFinder 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

Volver

DirectionFinder: Es el objeto DirectionsFinder 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

Volver

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

Consulta también


setOptimizeWaypoints(optimizeOrder)

Define si se optimizará o no la ruta proporcionada reorganizando los puntos de referencia de una forma 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; de lo contrario, false

Volver

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

Consulta también


setOrigin(latitude, longitude)

Establece la ubicación de partida desde la que 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 partida
longitudeNumberla longitud de la ubicación de partida

Volver

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


setOrigin(address)

Establece la ubicación de partida desde la que se calcularán las instrucciones sobre cómo llegar, en función de 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 de partida

Volver

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


setRegion(region)

Configura la región que se usará cuando se interpreten 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 para usar

Volver

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

Consulta también