Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

API Google Directions

Metodi

Metodo	Tipo restituito	Breve descrizione
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Aggiunge un waypoint che deve essere attraversato dal percorso utilizzando un punto (lat/lng).
`addWaypoint(address)`	`DirectionFinder`	Aggiunge una tappa che il percorso deve attraversare, utilizzando un indirizzo.
`clearWaypoints()`	`DirectionFinder`	Cancella l'insieme corrente di tappe.
`getDirections()`	`Object`	Recupera le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni impostate.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Consente di stabilire se restituire o meno le route alternative, anziché solo quella con il ranking più alto. route (il valore predefinito è false).
`setArrive(time)`	`DirectionFinder`	Imposta l'orario di arrivo desiderato (se applicabile).
`setAvoid(avoid)`	`DirectionFinder`	Consente di impostare 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 posizione finale per cui calcolare le indicazioni stradali, utilizzando un punto (lat/lng).
`setDestination(address)`	`DirectionFinder`	Imposta la località finale per cui 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 (per impostazione predefinita è la modalità di guida).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Consente di ottimizzare o meno il percorso fornito riorganizzando le tappe in un in ordine efficiente (il valore predefinito è false).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Consente di impostare la località 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 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

Nome	Tipo	Descrizione
`latitude`	`Number`	Latitudine della tappa.
`longitude`	`Number`	Longitudine 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

Nome	Tipo	Descrizione
`address`	`String`	Un 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

API Google Directions

`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

Nome	Tipo	Descrizione
`useAlternatives`	`Boolean`	true 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

Nome	Tipo	Descrizione
`time`	`Date`	l'ora di arrivo

Invio

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

Vedi anche

API Google Directions

`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

Nome	Tipo	Descrizione
`avoid`	`String`	un valore costante da `Avoid`

Invio

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

Invio

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

Vedi anche

API Google Directions

`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

Nome	Tipo	Descrizione
`latitude`	`Number`	la latitudine della località finale
`longitude`	`Number`	la 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

Nome	Tipo	Descrizione
`address`	`String`	l'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

Nome	Tipo	Descrizione
`language`	`String`	Un identificatore lingua BCP-47

Invio

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

Nome	Tipo	Descrizione
`mode`	`String`	un valore costante da `Mode`

Invio

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

Vedi anche

API Google Directions

`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

Nome	Tipo	Descrizione
`optimizeOrder`	`Boolean`	true per ottimizzare l'ordine o false negli altri casi

Invio

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

Vedi anche

API Google Directions

`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

Nome	Tipo	Descrizione
`latitude`	`Number`	la latitudine della posizione di partenza
`longitude`	`Number`	la 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

Nome	Tipo	Descrizione
`address`	`String`	l'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

Nome	Tipo	Descrizione
`region`	`String`	il codice regione da utilizzare

Invio

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

Vedi anche

API Google Directions