Se usó la API de Cloud Translation para traducir esta página.

Class 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

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, utilizando un punto (lat/long).
`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 según el origen, el destino y otras opciones que se hayan establecido.
`setAlternatives(useAlternatives)`	`DirectionFinder`	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).
`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 hasta la que se calcularán las indicaciones, utilizando un punto (lat./long.).
`setDestination(address)`	`DirectionFinder`	Establece la ubicación de destino para la que se calcularán las instrucciones sobre cómo llegar, mediante una dirección.
`setLanguage(language)`	`DirectionFinder`	Establece el idioma que se utilizará para las instrucciones sobre cómo llegar.
`setMode(mode)`	`DirectionFinder`	Establece el medio de transporte (la configuración predeterminada es En automóvil).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Define 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)`	`DirectionFinder`	Establece la ubicación de partida desde la que se calcularán las indicaciones mediante un punto (lat./long.).
`setOrigin(address)`	`DirectionFinder`	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.
`setRegion(region)`	`DirectionFinder`	Configura 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

Nombre	Tipo	Descripción
`latitude`	`Number`	Latitud del punto de referencia.
`longitude`	`Number`	Longitud 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

Nombre	Tipo	Descripción
`address`	`String`	Una 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

API de Google Directions

`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

Nombre	Tipo	Descripción
`useAlternatives`	`Boolean`	true 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

Nombre	Tipo	Descripción
`time`	`Date`	la hora de llegada

Volver

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

Parámetros

Nombre	Tipo	Descripción
`time`	`Date`	la hora de salida

Volver

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

Consulta también

API de Google Directions

`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

Nombre	Tipo	Descripción
`latitude`	`Number`	la latitud de la ubicación de finalización
`longitude`	`Number`	la 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

Nombre	Tipo	Descripción
`address`	`String`	la 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

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

Volver

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

Consulta también

Compatibilidad de idiomas en las APIs de Google Maps

`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

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

Volver

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

Consulta también

API de Google Directions

`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

Nombre	Tipo	Descripción
`optimizeOrder`	`Boolean`	true para optimizar el orden; de lo contrario, false

Volver

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

Consulta también

API de Google Directions

`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

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

Nombre	Tipo	Descripción
`address`	`String`	la 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

Nombre	Tipo	Descripción
`region`	`String`	el código de región para usar

Volver

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

Consulta también

API de Google Directions