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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
addWaypoint(latitude, longitude) | DirectionFinder | Agrega un punto de referencia que la ruta debe atravesar utilizando un punto (lat/long). |
addWaypoint(address) | DirectionFinder | Agrega un punto de referencia que la ruta debe atravesar usando una dirección. |
clearWaypoints() | DirectionFinder | Borra el conjunto actual de puntos de referencia. |
getDirections() | Object | Obtiene las instrucciones sobre cómo llegar utilizando el origen, el destino y otras opciones que se configuraron. |
setAlternatives(useAlternatives) | DirectionFinder | 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). |
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 final para la cual deben calcularse las indicaciones, mediante un punto (lat/long). |
setDestination(address) | DirectionFinder | Establece la ubicación final para la que deben calcularse las instrucciones sobre cómo llegar, utilizando 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 | 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). |
setOrigin(latitude, longitude) | DirectionFinder | Establece la ubicación inicial a partir de la cual se calcularán las indicaciones, mediante un punto (lat/long). |
setOrigin(address) | DirectionFinder | 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. |
setRegion(region) | DirectionFinder | Configura 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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | Latitud del punto de referencia. |
longitude | Number | Longitud 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
Nombre | Tipo | Descripción |
---|---|---|
address | String | Una 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
Nombre | Tipo | Descripción |
---|---|---|
useAlternatives | Boolean | true 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
Nombre | Tipo | Descripción |
---|---|---|
time | Date | la 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
Nombre | Tipo | Descripción |
---|---|---|
avoid | String | un 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
Nombre | Tipo | Descripción |
---|---|---|
time | Date | la 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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | La latitud de la ubicación de finalización |
longitude | Number | la 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
Nombre | Tipo | Descripción |
---|---|---|
address | String | la 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
Nombre | Tipo | Descripción |
---|---|---|
language | String | un 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
Nombre | Tipo | Descripción |
---|---|---|
mode | String | un 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
Nombre | Tipo | Descripción |
---|---|---|
optimizeOrder | Boolean | true 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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | La latitud de la ubicación de inicio |
longitude | Number | la 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
Nombre | Tipo | Descripción |
---|---|---|
address | String | la 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
Nombre | Tipo | Descripción |
---|---|---|
region | String | el código de región que se usará |
Devolvedor
DirectionFinder
: Es el objeto DirectionFinder, que facilita el encadenamiento de llamadas.