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, 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 Google Maps Directions

Metodi

Metodo	Tipo restituito	Breve descrizione
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Aggiunge un waypoint attraverso il quale deve passare il percorso, utilizzando un punto (lat/lng).
`addWaypoint(address)`	`DirectionFinder`	Aggiunge una fermata intermedia che il percorso deve attraversare utilizzando un indirizzo.
`clearWaypoints()`	`DirectionFinder`	Cancella l'insieme corrente di waypoint.
`getDirections()`	`Object`	Recupera le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni impostate.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Imposta se devono essere restituiti o meno percorsi alternativi, 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 località di destinazione per la quale calcolare le indicazioni stradali utilizzando un punto (lat/lng).
`setDestination(address)`	`DirectionFinder`	Imposta la località di destinazione 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`	Imposta la modalità di viaggio (il valore predefinito è Guida).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Imposta se ottimizzare o meno il percorso fornito riordinando 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 (lat/lng).
`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 dei luoghi.

Documentazione dettagliata

`addWaypoint(latitude, longitude)`

Aggiunge un waypoint attraverso il quale deve passare il percorso, utilizzando un punto (lat/lng).

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

Parametri

Nome	Tipo	Descrizione
`latitude`	`Number`	Latitudine del waypoint.
`longitude`	`Number`	Longitudine del waypoint.

Invio

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

`addWaypoint(address)`

Aggiunge una fermata intermedia che il percorso 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.

Invio

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

`clearWaypoints()`

Cancella l'insieme corrente di waypoint.

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

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento 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.
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);

Invio

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

Vedi anche

API Google Maps Directions

`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 percorsi alternativi, false in caso contrario

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento 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

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

API Google Maps Directions

`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 di `Avoid`

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

API Google Maps Directions

`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'orario di partenza

Invio

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

Vedi anche

API Google Maps Directions

`setDestination(latitude, longitude)`

Imposta la località di destinazione per la quale calcolare le indicazioni stradali utilizzando un punto (lat/lng).

// 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 località di arrivo
`longitude`	`Number`	la longitudine della località di arrivo

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

`setDestination(address)`

Imposta la località di destinazione per la quale 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 finale

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento 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

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

Supporto delle lingue nelle API di Google Maps

`setMode(mode)`

Imposta la modalità di viaggio (il valore predefinito è 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 di `Mode`

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

API Google Maps Directions

`setOptimizeWaypoints(optimizeOrder)`

Imposta se ottimizzare o meno il percorso fornito riordinando 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 in caso contrario

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

API Google Maps Directions

`setOrigin(latitude, longitude)`

Imposta 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.
const 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 località di partenza

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento 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

Invio

DirectionFinder: l'istanza di DirectionFinder per facilitare l'accodamento delle chiamate

`setRegion(region)`

Imposta una regione da utilizzare per interpretare i nomi dei luoghi. 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.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parametri

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

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento delle chiamate

Vedi anche

API Google Maps Directions