דף זה תורגם על ידי Cloud Translation API.

Class 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