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, fermarsi prima al Lincoln Center, tracciare le posizioni e il percorso su una mappa e inviare la mappa in un'email.

// Get the directions.
const 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();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      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.
const 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 Directions di Google

Metodi

Metodo	Tipo restituito	Breve descrizione
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Aggiunge un waypoint che l'itinerario deve attraversare, utilizzando un punto (latitudine/longitudine).
`addWaypoint(address)`	`DirectionFinder`	Aggiunge una tappa che l'itinerario deve attraversare, utilizzando un indirizzo.
`clearWaypoints()`	`DirectionFinder`	Cancella l'attuale insieme di waypoint.
`getDirections()`	`Object`	Recupera le indicazioni stradali utilizzando l'origine, la destinazione e le altre opzioni impostate.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Imposta se devono essere restituite o meno le alternative di percorso, anziché solo il percorso con il ranking più alto (il valore predefinito è `false`).
`setArrive(time)`	`DirectionFinder`	Imposta l'orario di arrivo desiderato (se applicabile).
`setAvoid(avoid)`	`DirectionFinder`	Imposta se evitare determinati tipi di limitazioni.
`setDepart(time)`	`DirectionFinder`	Imposta l'orario di partenza desiderato (se applicabile).
`setDestination(latitude, longitude)`	`DirectionFinder`	Imposta la posizione di arrivo per cui calcolare le indicazioni stradali, utilizzando un punto (latitudine/longitudine).
`setDestination(address)`	`DirectionFinder`	Imposta la località di destinazione per cui calcolare le indicazioni stradali utilizzando un indirizzo.
`setLanguage(language)`	`DirectionFinder`	Imposta la lingua da utilizzare per le indicazioni stradali.
`setMode(mode)`	`DirectionFinder`	Imposta la modalità di viaggio (impostata per impostazione predefinita sulla guida).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Imposta se ottimizzare o meno l'itinerario fornito riorganizzando le tappe in un ordine più efficiente (il valore predefinito è `false`).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Imposta la posizione di partenza da cui calcolare le indicazioni stradali, utilizzando un punto (latitudine/longitudine).
`setOrigin(address)`	`DirectionFinder`	Imposta la posizione di partenza da cui calcolare le indicazioni stradali utilizzando un indirizzo.
`setRegion(region)`	`DirectionFinder`	Imposta una regione da utilizzare per interpretare i nomi delle località.

Documentazione dettagliata

`addWaypoint(latitude, longitude)`

Aggiunge un waypoint che l'itinerario deve attraversare, utilizzando un punto (latitudine/longitudine).

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

Parametri

Nome	Tipo	Descrizione
`latitude`	`Number`	La latitudine del waypoint.
`longitude`	`Number`	La longitudine del waypoint.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

`addWaypoint(address)`

Aggiunge una tappa che l'itinerario deve attraversare, utilizzando un indirizzo.

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

Parametri

Nome	Tipo	Descrizione
`address`	`String`	Un indirizzo.

Indietro

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

`clearWaypoints()`

Cancella l'attuale insieme di waypoint.

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

Indietro

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

`getDirections()`

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

// Logs how long it takes to walk from Times Square to Central Park.
const 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);

Indietro

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

Vedi anche

API Directions di Google

`setAlternatives(useAlternatives)`

Imposta se devono essere restituiti o meno percorsi alternativi, anziché solo il percorso con il ranking più alto (il valore predefinito è false). Se true, l'array routes dell'oggetto risultante può contenere più voci.

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

Parametri

Nome	Tipo	Descrizione
`useAlternatives`	`Boolean`	`true` per restituire itinerari alternativi, `false` altrimenti.

Indietro

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.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Parametri

Nome	Tipo	Descrizione
`time`	`Date`	L'ora di arrivo.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

Vedi anche

API Directions di Google

`setAvoid(avoid)`

Imposta se evitare determinati tipi di limitazioni.

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

Parametri

Nome	Tipo	Descrizione
`avoid`	`String`	Un valore costante da `Avoid`.

Indietro

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

Vedi anche

API Directions di Google

`setDepart(time)`

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

// Creates a DirectionFinder with a departure time of 1 hour from now.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

Parametri

Nome	Tipo	Descrizione
`time`	`Date`	L'ora di partenza.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

Vedi anche

API Directions di Google

`setDestination(latitude, longitude)`

Imposta la posizione di arrivo per cui calcolare le indicazioni stradali, utilizzando un punto (latitudine/longitudine).

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

Parametri

Nome	Tipo	Descrizione
`latitude`	`Number`	La latitudine della posizione di destinazione.
`longitude`	`Number`	La longitudine della località di destinazione.

Indietro

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

`setDestination(address)`

Imposta la località di destinazione per cui calcolare le indicazioni stradali utilizzando un indirizzo.

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

Parametri

Nome	Tipo	Descrizione
`address`	`String`	L'indirizzo di destinazione.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

`setLanguage(language)`

Imposta la lingua da utilizzare per le indicazioni stradali.

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

Parametri

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

Indietro

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

Vedi anche

Supporto delle lingue nelle API di Google Maps

`setMode(mode)`

Imposta la modalità di viaggio (impostata per impostazione predefinita sulla guida).

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

Parametri

Nome	Tipo	Descrizione
`mode`	`String`	Un valore costante da `Mode`.

Indietro

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

Vedi anche

API Directions di Google

`setOptimizeWaypoints(optimizeOrder)`

Imposta se ottimizzare o meno l'itinerario fornito riorganizzando le tappe in un ordine più efficiente (il valore predefinito è false).

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

Parametri

Nome	Tipo	Descrizione
`optimizeOrder`	`Boolean`	`true` per ottimizzare l'ordine o `false` altrimenti.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

Vedi anche

API Directions di Google

`setOrigin(latitude, longitude)`

Imposta la posizione di partenza da cui calcolare le indicazioni stradali, utilizzando un punto (latitudine/longitudine).

// Creates a DirectionFinder with the origin set to Times Square.
const 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 posizione di partenza.

Indietro

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

`setOrigin(address)`

Imposta la posizione di partenza da cui calcolare le indicazioni stradali utilizzando un indirizzo.

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

Parametri

Nome	Tipo	Descrizione
`address`	`String`	L'indirizzo di partenza.

Indietro

DirectionFinder: l'istanza di DirectionFinder per facilitare l'incatenamento delle chiamate.

`setRegion(region)`

Imposta una regione da utilizzare per interpretare i nomi delle località. I codici regione supportati corrispondono ai TLD con codice paese 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.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parametri

Nome	Tipo	Descrizione
`region`	`String`	Il codice regione da utilizzare.

Indietro

DirectionFinder: l'oggetto DirectionFinder per facilitare l'incatenamento delle chiamate.

Vedi anche

API Directions di Google

Class DirectionFinder Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Vedi anche

Metodi

Documentazione dettagliata

addWaypoint(latitude, longitude)

Parametri

Indietro

addWaypoint(address)

Parametri

Indietro

clearWaypoints()

Indietro

getDirections()

Indietro

Vedi anche

setAlternatives(useAlternatives)

Parametri

Indietro

setArrive(time)

Parametri

Indietro

Vedi anche

setAvoid(avoid)

Parametri

Indietro

Vedi anche

setDepart(time)

Parametri

Indietro

Vedi anche

setDestination(latitude, longitude)

Parametri

Indietro

setDestination(address)

Parametri

Indietro

setLanguage(language)

Parametri

Indietro

Vedi anche

setMode(mode)

Parametri

Indietro

Vedi anche

setOptimizeWaypoints(optimizeOrder)

Parametri

Indietro

Vedi anche

setOrigin(latitude, longitude)

Parametri

Indietro

setOrigin(address)

Parametri

Indietro

setRegion(region)

Parametri

Indietro

Vedi anche

Class DirectionFinder

`addWaypoint(latitude, longitude)`

`addWaypoint(address)`

`clearWaypoints()`

`getDirections()`

`setAlternatives(useAlternatives)`

`setArrive(time)`

`setAvoid(avoid)`

`setDepart(time)`

`setDestination(latitude, longitude)`

`setDestination(address)`

`setLanguage(language)`

`setMode(mode)`

`setOptimizeWaypoints(optimizeOrder)`

`setOrigin(latitude, longitude)`

`setOrigin(address)`

`setRegion(region)`