Class DirectionFinder

DirectionFinder

Consente il recupero delle indicazioni stradali tra le località.
L'esempio seguente mostra come utilizzare questa classe per ottenere le indicazioni stradali da Times Square a Central Park, fermandosi prima al Lincoln Center, tracciando i luoghi e il percorso su una mappa e invia la mappa in un'email.

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

Vedi anche

Metodi

MetodoTipo restituitoBreve descrizione
addWaypoint(latitude, longitude)DirectionFinderAggiunge un waypoint che deve essere attraversato dal percorso utilizzando un punto (lat/lng).
addWaypoint(address)DirectionFinderAggiunge una tappa che il percorso deve attraversare, utilizzando un indirizzo.
clearWaypoints()DirectionFinderCancella l'insieme corrente di tappe.
getDirections()ObjectRecupera le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni impostate.
setAlternatives(useAlternatives)DirectionFinderConsente di stabilire se restituire o meno le route alternative, anziché solo quella con il ranking più alto. route (il valore predefinito è false).
setArrive(time)DirectionFinderImposta l'orario di arrivo desiderato (se applicabile).
setAvoid(avoid)DirectionFinderConsente di impostare se evitare determinati tipi di limitazioni.
setDepart(time)DirectionFinderImposta l'orario di partenza desiderato (se applicabile).
setDestination(latitude, longitude)DirectionFinderConsente di impostare la posizione finale per cui calcolare le indicazioni stradali, utilizzando un punto (lat/lng).
setDestination(address)DirectionFinderImposta la località finale per cui calcolare le indicazioni stradali, utilizzando un indirizzo.
setLanguage(language)DirectionFinderImposta la lingua da utilizzare per le indicazioni stradali.
setMode(mode)DirectionFinderConsente di impostare la modalità di viaggio (per impostazione predefinita è la modalità di guida).
setOptimizeWaypoints(optimizeOrder)DirectionFinderConsente di ottimizzare o meno il percorso fornito riorganizzando le tappe in un in ordine efficiente (il valore predefinito è false).
setOrigin(latitude, longitude)DirectionFinderConsente di impostare la località di partenza da cui calcolare le indicazioni stradali utilizzando un punto (lat/lng).
setOrigin(address)DirectionFinderImposta la località di partenza da cui calcolare le indicazioni stradali, utilizzando un indirizzo.
setRegion(region)DirectionFinderImposta una regione da utilizzare per l'interpretazione dei nomi delle località.

Documentazione dettagliata

addWaypoint(latitude, longitude)

Aggiunge un waypoint che deve essere attraversato dal percorso utilizzando un punto (lat/lng).

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

Parametri

NomeTipoDescrizione
latitudeNumberLatitudine della tappa.
longitudeNumberLongitudine del waypoint.

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.


addWaypoint(address)

Aggiunge una tappa che il percorso deve attraversare, utilizzando un indirizzo.

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

Parametri

NomeTipoDescrizione
addressStringUn indirizzo.

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.


clearWaypoints()

Cancella l'insieme corrente di tappe.

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

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate


getDirections()

Recupera le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni impostate.

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

Invio

Object: un oggetto JSON contenente l'insieme di route per le indicazioni stradali, come descritto qui

Vedi anche


setAlternatives(useAlternatives)

Consente di stabilire se restituire o meno le route alternative, anziché solo quella con il ranking più alto. route (il valore predefinito è false). Se true, l'array routes dell'oggetto risultante può contengono più voci.

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

Parametri

NomeTipoDescrizione
useAlternativesBooleantrue per restituire route alternative, false in caso contrario

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate


setArrive(time)

Imposta l'orario di arrivo desiderato (se applicabile).

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

Parametri

NomeTipoDescrizione
timeDatel'ora di arrivo

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche


setAvoid(avoid)

Consente di impostare se evitare determinati tipi di limitazioni.

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

Parametri

NomeTipoDescrizione
avoidStringun valore costante da Avoid

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche


setDepart(time)

Imposta l'orario di partenza desiderato (se applicabile).

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

Parametri

NomeTipoDescrizione
timeDatel'orario di partenza

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.

Vedi anche


setDestination(latitude, longitude)

Consente di impostare la posizione finale per cui calcolare le indicazioni stradali, utilizzando un punto (lat/lng).

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

Parametri

NomeTipoDescrizione
latitudeNumberla latitudine della località finale
longitudeNumberla longitudine della località finale

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate


setDestination(address)

Imposta la località finale per cui calcolare le indicazioni stradali, utilizzando un indirizzo.

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

Parametri

NomeTipoDescrizione
addressStringl'indirizzo finale

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate


setLanguage(language)

Imposta la lingua da utilizzare per le indicazioni stradali.

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

Parametri

NomeTipoDescrizione
languageStringUn identificatore lingua BCP-47

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche


setMode(mode)

Consente di impostare la modalità di viaggio (per impostazione predefinita è la modalità di guida).

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

Parametri

NomeTipoDescrizione
modeStringun valore costante da Mode

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche


setOptimizeWaypoints(optimizeOrder)

Consente di ottimizzare o meno il percorso fornito riorganizzando le tappe in un in ordine efficiente (il valore predefinito è false).

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

Parametri

NomeTipoDescrizione
optimizeOrderBooleantrue per ottimizzare l'ordine o false negli altri casi

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche


setOrigin(latitude, longitude)

Consente di impostare la località di partenza da cui calcolare le indicazioni stradali utilizzando un punto (lat/lng).

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

Parametri

NomeTipoDescrizione
latitudeNumberla latitudine della posizione di partenza
longitudeNumberla longitudine della località di partenza

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate


setOrigin(address)

Imposta la località di partenza da cui calcolare le indicazioni stradali, utilizzando un indirizzo.

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

Parametri

NomeTipoDescrizione
addressStringl'indirizzo di partenza

Invio

DirectionFinder: l'istanza di DirectionFinder per facilitare il concatenamento delle chiamate.


setRegion(region)

Imposta una regione da utilizzare per l'interpretazione dei nomi delle località. I codici regione supportati corrispondono i ccTLD supportati da Google Maps. Ad esempio, il codice regione "uk" corrisponde a "maps.google.it".

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

Parametri

NomeTipoDescrizione
regionStringil codice regione da utilizzare

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare il concatenamento delle chiamate

Vedi anche