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