Class DirectionFinder

DirectionFinder

יש אפשרות לאחזר מסלול בין מיקומים.
הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו כדי לקבל את המסלול מטיימס סקוור אל סנטרל פארק, עוצרים קודם בלינקולן Center, משרטטים את המיקומים והנתיב במפה, ושולחים את המפה באימייל.

// 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')
    }
  }
);

ראה גם

• Google Directions API

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
addWaypoint(latitude, longitude)	DirectionFinder	הוספת ציון דרך שהמסלול חייב לעבור בו, באמצעות נקודה (lat/lng).
addWaypoint(address)	DirectionFinder	הוספת ציון דרך שהמסלול חייב לעבור בו, באמצעות כתובת.
clearWaypoints()	DirectionFinder	ניקוי הקבוצה הנוכחית של ציוני הדרך.
getDirections()	Object	קבלת המסלול באמצעות המוצא, היעד ואפשרויות אחרות שהוגדרו.
setAlternatives(useAlternatives)	DirectionFinder	מגדיר אם להחזיר מסלולים חלופיים, במקום רק את הדירוג הגבוה ביותר נתיב (ברירת המחדל היא False).
setArrive(time)	DirectionFinder	מגדיר את שעת ההגעה הרצויה (במקרים רלוונטיים).
setAvoid(avoid)	DirectionFinder	ההגדרה קובעת אם להימנע מסוגים מסוימים של הגבלות.
setDepart(time)	DirectionFinder	מגדיר את שעת היציאה הרצויה (במקרים רלוונטיים).
setDestination(latitude, longitude)	DirectionFinder	מגדיר את מיקום הסיום שעבורו יש לחשב את המסלול, באמצעות נקודה (lat/lng).
setDestination(address)	DirectionFinder	מגדיר את מיקום הסיום שעבורו תחושב המסלול באמצעות כתובת.
setLanguage(language)	DirectionFinder	הגדרת השפה עבור המסלול.
setMode(mode)	DirectionFinder	מגדיר את אמצעי הנסיעה (ברירת המחדל היא נהיגה).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	קובע אם לבצע אופטימיזציה של המסלול הנתון על ידי סידור מחדש של נקודות העצירה סדר יעיל (ברירת המחדל היא False).
setOrigin(latitude, longitude)	DirectionFinder	מגדיר את מיקום ההתחלה שממנו יש לחשב את המסלול, באמצעות נקודה (lat/lng).
setOrigin(address)	DirectionFinder	מגדיר את מיקום ההתחלה שממנו יש לחשב את המסלול באמצעות כתובת.
setRegion(region)	DirectionFinder	מגדיר את האזור שישמש לפירוש שמות המיקומים.

מסמכי תיעוד מפורטים

addWaypoint(latitude, longitude)

הוספת ציון דרך שהמסלול חייב לעבור בו, באמצעות נקודה (lat/lng).

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

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של ציון הדרך.
longitude	Number	קו האורך של ציון הדרך.

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות.

---

addWaypoint(address)

הוספת ציון דרך שהמסלול חייב לעבור בו, באמצעות כתובת.

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

פרמטרים

שם	סוג	תיאור
address	String	כתובת.

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות.

---

clearWaypoints()

ניקוי הקבוצה הנוכחית של ציוני הדרך.

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

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

---

getDirections()

קבלת המסלול באמצעות המוצא, היעד ואפשרויות אחרות שהוגדרו.

// 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);

חזרה

Object - אובייקט JSON שמכיל את קבוצת המסלולים של המסלול, כפי שמתואר כאן

ראה גם

• Google Directions API

---

setAlternatives(useAlternatives)

מגדיר אם להחזיר מסלולים חלופיים, במקום רק את הדירוג הגבוה ביותר נתיב (ברירת המחדל היא False). אם True, מערך ה-routes של האובייקט שמתקבל עשוי להכיל מספר ערכים.

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

פרמטרים

שם	סוג	תיאור
useAlternatives	Boolean	true כדי להחזיר מסלולים חלופיים, false כדי להחזיר מסלולים חלופיים.

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

---

setArrive(time)

מגדיר את שעת ההגעה הרצויה (במקרים רלוונטיים).

// 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);

פרמטרים

שם	סוג	תיאור
time	Date	שעת ההגעה

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• Google Directions API

---

setAvoid(avoid)

ההגדרה קובעת אם להימנע מסוגים מסוימים של הגבלות.

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

פרמטרים

שם	סוג	תיאור
avoid	String	ערך קבוע מ-Avoid

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• Google Directions API

---

setDepart(time)

מגדיר את שעת היציאה הרצויה (במקרים רלוונטיים).

// 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);

פרמטרים

שם	סוג	תיאור
time	Date	שעת היציאה

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות.

ראה גם

• Google Directions API

---

setDestination(latitude, longitude)

מגדיר את מיקום הסיום שעבורו יש לחשב את המסלול, באמצעות נקודה (lat/lng).

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

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של מיקום הסיום
longitude	Number	קו האורך של מיקום הסיום

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

---

setDestination(address)

מגדיר את מיקום הסיום שעבורו תחושב המסלול באמצעות כתובת.

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

פרמטרים

שם	סוג	תיאור
address	String	הכתובת הסופית

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

---

setLanguage(language)

הגדרת השפה עבור המסלול.

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

פרמטרים

שם	סוג	תיאור
language	String	מזהה שפה מסוג BCP-47

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• שפות תמיכה בממשקי Google Maps API

---

setMode(mode)

מגדיר את אמצעי הנסיעה (ברירת המחדל היא נהיגה).

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

פרמטרים

שם	סוג	תיאור
mode	String	ערך קבוע מ-Mode

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

קובע אם לבצע אופטימיזציה של המסלול הנתון על ידי סידור מחדש של נקודות העצירה סדר יעיל (ברירת המחדל היא False).

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

פרמטרים

שם	סוג	תיאור
optimizeOrder	Boolean	או false כדי לבצע אופטימיזציה של הסדר, או false כדי לבצע אופטימיזציה של הסדר

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• Google Directions API

---

setOrigin(latitude, longitude)

מגדיר את מיקום ההתחלה שממנו יש לחשב את המסלול, באמצעות נקודה (lat/lng).

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin(40.759011, -73.984472);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של מיקום ההתחלה
longitude	Number	קו האורך של מיקום ההתחלה

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

---

setOrigin(address)

מגדיר את מיקום ההתחלה שממנו יש לחשב את המסלול באמצעות כתובת.

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

פרמטרים

שם	סוג	תיאור
address	String	הכתובת להתחלה

חזרה

DirectionFinder – המכונה DirectionFinder שמאפשרת ליצור שרשור של שיחות

---

setRegion(region)

מגדיר את האזור שישמש בעת פירוש שמות המיקומים. קודי האזור הנתמכים תואמים שמות הדומיינים מסוג ccTLD שנתמכים על ידי מפות Google. לדוגמה, קוד האזור "uk" תואם ל- 'maps.google.co.uk'.

// Creates a DirectionFinder with the region set to France.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

פרמטרים

שם	סוג	תיאור
region	String	קוד האזור שבו צריך להשתמש

חזרה

DirectionFinder – האובייקט DirectionFinder שמאפשר ליצור שרשור של שיחות

ראה גם

• Google Directions API