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

Class DirectionFinder

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

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

ראה גם

Google Directions API

Methods

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

מסמכים מפורטים

`addWaypoint(latitude, longitude)`

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

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const 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.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

פרמטרים

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

חזרה

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

`clearWaypoints()`

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

const 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.
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);

חזרה

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

ראה גם

Google Directions API

`setAlternatives(useAlternatives)`

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

// Creates a DirectionFinder with alternative routes enabled.
const 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.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder כדי לאפשר שרשור של קריאות

ראה גם

Google Directions API

`setAvoid(avoid)`

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

// Creates a DirectionFinder that avoid highways.
const 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.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

פרמטרים

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

חזרה

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

ראה גם

Google Directions API

`setDestination(latitude, longitude)`

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

// Creates a DirectionFinder with the destination set to Central Park.
const 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.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder כדי לאפשר שרשור של קריאות

`setLanguage(language)`

הגדרת השפה שבה יושמעו ההנחיות.

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

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder כדי לאפשר שרשור של קריאות

ראה גם

תמיכה בשפות ב-Google Maps APIs

`setMode(mode)`

הגדרת אמצעי התחבורה (ברירת המחדל היא 'רכב').

// Creates a DirectionFinder with the mode set to walking.
const 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.
const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder כדי לאפשר שרשור של קריאות

ראה גם

Google Directions API

`setOrigin(latitude, longitude)`

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

// Creates a DirectionFinder with the origin set to Times Square.
const 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.
const 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.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder כדי לאפשר שרשור של קריאות

ראה גם

Google Directions API