Class DirectionFinder

DirectionFinder

Consente il recupero di indicazioni stradali tra 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 le posizioni e il percorso su una mappa e inviando la mappa via 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

• API Google Directions

Metodi

Metodo	Tipo restituito	Breve descrizione
addWaypoint(latitude, longitude)	DirectionFinder	Aggiunge un tappe che deve attraversare il percorso, utilizzando un punto (lat/lng).
addWaypoint(address)	DirectionFinder	Aggiunge un Waypoint che deve essere attraversato dal percorso, utilizzando un indirizzo.
clearWaypoints()	DirectionFinder	Consente di cancellare l'insieme di tappe corrente.
getDirections()	Object	Visualizza le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni che sono state impostate.
setAlternatives(useAlternatives)	DirectionFinder	Consente di stabilire se restituire o meno route alternative, anziché solo quella con il ranking più alto (il valore predefinito è false).
setArrive(time)	DirectionFinder	Consente di impostare l'ora di arrivo desiderata (se applicabile).
setAvoid(avoid)	DirectionFinder	Consente di stabilire se evitare determinati tipi di limitazioni.
setDepart(time)	DirectionFinder	Imposta l'orario di partenza desiderato (se applicabile).
setDestination(latitude, longitude)	DirectionFinder	Consente di impostare la località finale per la quale calcolare le indicazioni stradali utilizzando un punto (lat/lng).
setDestination(address)	DirectionFinder	Consente di impostare la località di arrivo per la quale calcolare le indicazioni stradali, utilizzando un indirizzo.
setLanguage(language)	DirectionFinder	Imposta la lingua da utilizzare per le indicazioni stradali.
setMode(mode)	DirectionFinder	Consente di impostare la modalità di viaggio (l'impostazione predefinita è Auto).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Consente di scegliere se ottimizzare o meno la rotta fornita riorganizzando i punti di tappa in un ordine più efficiente (l'impostazione predefinita è false).
setOrigin(latitude, longitude)	DirectionFinder	Consente di impostare la posizione di partenza da cui calcolare le indicazioni stradali, utilizzando un punto (lat/lng).
setOrigin(address)	DirectionFinder	Imposta la località di partenza da cui calcolare le indicazioni stradali, utilizzando un indirizzo.
setRegion(region)	DirectionFinder	Imposta una regione da utilizzare per l'interpretazione dei nomi delle località.

Documentazione dettagliata

addWaypoint(latitude, longitude)

Aggiunge un tappe che deve attraversare il 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

Nome	Tipo	Descrizione
latitude	Number	Latitudine del tappa.
longitude	Number	Longitudine del tappa.

Ritorni

DirectionFinder - L'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.

---

addWaypoint(address)

Aggiunge un Waypoint che deve essere attraversato dal percorso, utilizzando un indirizzo.

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

Parametri

Nome	Tipo	Descrizione
address	String	Un indirizzo.

Ritorni

DirectionFinder - L'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.

---

clearWaypoints()

Consente di cancellare l'insieme di tappe corrente.

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

Ritorni

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

---

getDirections()

Visualizza le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni che sono state 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);

Ritorni

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

Vedi anche

• API Google Directions

---

setAlternatives(useAlternatives)

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

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

Parametri

Nome	Tipo	Descrizione
useAlternatives	Boolean	true per restituire route alternative, false in caso contrario

Ritorni

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

---

setArrive(time)

Consente di impostare l'ora di arrivo desiderata (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

Nome	Tipo	Descrizione
time	Date	l'ora di arrivo

Ritorni

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

Vedi anche

• API Google Directions

---

setAvoid(avoid)

Consente di stabilire se evitare determinati tipi di limitazioni.

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

Parametri

Nome	Tipo	Descrizione
avoid	String	un valore costante da Avoid

Ritorni

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

Vedi anche

• API Google Directions

---

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

Nome	Tipo	Descrizione
time	Date	l'orario di partenza

Ritorni

DirectionFinder - L'oggetto DirectionFinder per facilitare il concatenamento delle chiamate.

Vedi anche

• API Google Directions

---

setDestination(latitude, longitude)

Consente di impostare la località finale per la quale 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

Nome	Tipo	Descrizione
latitude	Number	la latitudine della località finale
longitude	Number	la longitudine della località di arrivo

Ritorni

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

---

setDestination(address)

Consente di impostare la località di arrivo per la quale 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

Nome	Tipo	Descrizione
address	String	l'indirizzo finale

Ritorni

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

Nome	Tipo	Descrizione
language	String	un identificatore della lingua BCP-47

Ritorni

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

Vedi anche

• Supporto delle lingue nelle API di Google Maps

---

setMode(mode)

Consente di impostare la modalità di viaggio (l'impostazione predefinita è Auto).

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

Parametri

Nome	Tipo	Descrizione
mode	String	un valore costante da Mode

Ritorni

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

Vedi anche

• API Google Directions

---

setOptimizeWaypoints(optimizeOrder)

Consente di scegliere se ottimizzare o meno la rotta fornita riorganizzando i punti di tappa in un ordine più efficiente (l'impostazione predefinita è false).

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

Parametri

Nome	Tipo	Descrizione
optimizeOrder	Boolean	true per ottimizzare l'ordine o false in caso contrario

Ritorni

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

Vedi anche

• API Google Directions

---

setOrigin(latitude, longitude)

Consente di impostare la posizione 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

Nome	Tipo	Descrizione
latitude	Number	la latitudine della località di partenza
longitude	Number	la longitudine della posizione di partenza

Ritorni

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

Nome	Tipo	Descrizione
address	String	l'indirizzo di partenza

Ritorni

DirectionFinder: l'istanza 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 ai ccTLD supportati da Google Maps. Ad esempio, il codice regione "uk" corrisponde a "maps.google.co.uk".

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

Parametri

Nome	Tipo	Descrizione
region	String	il codice regione da utilizzare

Ritorni

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

Vedi anche

• API Google Directions