Class DirectionFinder

Ricerca di indicazioni

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

Metodi

MetodoTipo restituitoBreve descrizione
addWaypoint(latitude, longitude)DirectionFinderAggiunge un waypoint attraverso il quale deve passare il percorso, utilizzando un punto (lat/lng).
addWaypoint(address)DirectionFinderAggiunge una fermata intermedia che il percorso deve attraversare utilizzando un indirizzo.
clearWaypoints()DirectionFinderCancella l'insieme corrente di waypoint.
getDirections()ObjectRecupera le indicazioni stradali utilizzando l'origine, la destinazione e altre opzioni impostate.
setAlternatives(useAlternatives)DirectionFinderImposta se devono essere restituiti o meno percorsi alternativi, anziché solo il percorso con il ranking più alto (il valore predefinito è false).
setArrive(time)DirectionFinderImposta l'orario di arrivo desiderato (se applicabile).
setAvoid(avoid)DirectionFinderImposta se evitare determinati tipi di limitazioni.
setDepart(time)DirectionFinderImposta l'orario di partenza desiderato (se applicabile).
setDestination(latitude, longitude)DirectionFinderImposta la località di destinazione per la quale calcolare le indicazioni stradali utilizzando un punto (lat/lng).
setDestination(address)DirectionFinderImposta la località di destinazione per la quale calcolare le indicazioni stradali utilizzando un indirizzo.
setLanguage(language)DirectionFinderImposta la lingua da utilizzare per le indicazioni stradali.
setMode(mode)DirectionFinderImposta la modalità di viaggio (il valore predefinito è Guida).
setOptimizeWaypoints(optimizeOrder)DirectionFinderImposta se ottimizzare o meno il percorso fornito riordinando le tappe in un ordine più efficiente (il valore predefinito è false).
setOrigin(latitude, longitude)DirectionFinderImposta la posizione di partenza da cui calcolare le indicazioni stradali, utilizzando un punto (lat/lng).
setOrigin(address)DirectionFinderImposta la posizione 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 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

NomeTipoDescrizione
latitudeNumberLatitudine del waypoint.
longitudeNumberLongitudine 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

NomeTipoDescrizione
addressStringUn 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 la stazione di partenza, 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

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

NomeTipoDescrizione
useAlternativesBooleantrue 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

NomeTipoDescrizione
timeDatel'ora di arrivo

Invio

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

Vedi anche

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

NomeTipoDescrizione
avoidStringun valore costante di Avoid

Invio

DirectionFinder: l'oggetto DirectionFinder per facilitare l'accodamento 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.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

Parametri

NomeTipoDescrizione
timeDatel'orario di partenza

Invio

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

Vedi anche

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

NomeTipoDescrizione
latitudeNumberla latitudine della località di arrivo
longitudeNumberla 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

NomeTipoDescrizione
addressStringl'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

NomeTipoDescrizione
languageStringun identificatore di lingua BCP-47

Invio

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

Vedi anche

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

NomeTipoDescrizione
modeStringun valore costante di Mode

Invio

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

Vedi anche

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

NomeTipoDescrizione
optimizeOrderBooleantrue per ottimizzare l'ordine o false in caso contrario

Invio

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

Vedi anche

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

NomeTipoDescrizione
latitudeNumberla latitudine della località di partenza
longitudeNumberla 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

NomeTipoDescrizione
addressStringl'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

NomeTipoDescrizione
regionStringil codice regione da utilizzare

Invio

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

Vedi anche