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