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

ראה גם

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של ציון הדרך.
longitudeNumberקו האורך של ציון הדרך.

חזרה

DirectionFinder – האובייקט DirectionFinder שעוזר בשרשרת של קריאות.


addWaypoint(address)

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

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

פרמטרים

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

חזרה

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 שמכיל את קבוצת המסלולים להוראות, כפי שמתואר כאן

ראה גם


setAlternatives(useAlternatives)

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

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

פרמטרים

שםסוגתיאור
useAlternativesBooleantrue כדי להציג מסלולים חלופיים, 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);

פרמטרים

שםסוגתיאור
timeDateשעת ההגעה

חזרה

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

ראה גם


setAvoid(avoid)

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

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

פרמטרים

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

חזרה

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

ראה גם


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

פרמטרים

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

חזרה

DirectionFinder – האובייקט DirectionFinder שעוזר בשרשרת של קריאות.

ראה גם


setDestination(latitude, longitude)

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

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של מיקום הסיום
longitudeNumberקו האורך של מיקום הסיום

חזרה

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


setDestination(address)

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

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

פרמטרים

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

חזרה

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


setLanguage(language)

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

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

פרמטרים

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

חזרה

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

ראה גם


setMode(mode)

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

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

פרמטרים

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

חזרה

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

ראה גם


setOptimizeWaypoints(optimizeOrder)

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

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

פרמטרים

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

חזרה

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

ראה גם


setOrigin(latitude, longitude)

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

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של מיקום ההתחלה
longitudeNumberקו האורך של מיקום ההתחלה

חזרה

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


setOrigin(address)

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

ראה גם