מאפשרת אחזור מסלולים בין מיקומים.
בדוגמה הבאה מוסבר איך אפשר להשתמש בכיתה הזו כדי לקבל מסלול מ-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
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
add | Direction | הוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות נקודה (קו הרוחב/קו האורך). |
add | Direction | הוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות כתובת. |
clear | Direction | ניקוי הקבוצה הנוכחית של נקודות הדרך. |
get | Object | הפונקציה מקבלת את המסלול לפי נקודת המוצא, היעד והאפשרויות האחרות שהוגדרו. |
set | Direction | מגדיר אם להחזיר נתיבים חלופיים במקום רק את המסלול בעל הדירוג הגבוה ביותר (ברירת המחדל היא false). |
set | Direction | מגדירים את שעת ההגעה הרצויה (אם רלוונטי). |
set | Direction | מגדיר אם להימנע מסוגים מסוימים של הגבלות. |
set | Direction | מגדירים את שעת היציאה הרצויה (אם רלוונטי). |
set | Direction | הגדרת מיקום הסיום שעבורו רוצים לחשב מסלול, באמצעות נקודה (קואורדינטות צפון/דרום). |
set | Direction | הגדרת המיקום הסופי שעבורו רוצים לחשב מסלול, באמצעות כתובת. |
set | Direction | הגדרת השפה שבה יושמעו ההנחיות. |
set | Direction | הגדרת אמצעי התחבורה (ברירת המחדל היא 'רכב'). |
set | Direction | קובע אם לבצע אופטימיזציה של המסלול שסופק על ידי סידור מחדש של נקודות העצירה בסדר יעיל יותר (ברירת המחדל היא false). |
set | Direction | הגדרת מיקום ההתחלה שממנו יחושבו המסלולים, באמצעות נקודה (קו הרוחב/קו האורך). |
set | Direction | הגדרת מיקום ההתחלה שממנו יחושבו המסלולים, באמצעות כתובת. |
set | Direction | הגדרת אזור לשימוש בזמן הפענוח של שמות המיקומים. |
מסמכים מפורטים
add Waypoint(latitude, longitude)
הוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות נקודה (קו הרוחב/קו האורך).
// Creates a DirectionFinder with a wapoint at Lincoln Center. const directionFinder = Maps.newDirectionFinder().addWaypoint( 40.772628, -73.984243, );
פרמטרים
שם | סוג | תיאור |
---|---|---|
latitude | Number | קו הרוחב של ציון הדרך. |
longitude | Number | קו האורך של ציון הדרך. |
חזרה
Direction
– האובייקט DirectionFinder שעוזר בשרשרת של קריאות.
add Waypoint(address)
הוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות כתובת.
// Creates a DirectionFinder with a wapoint at Lincoln Center. const directionFinder = Maps.newDirectionFinder().addWaypoint( 'Lincoln Center, New York, NY', );
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | כתובת. |
חזרה
Direction
– האובייקט DirectionFinder שעוזר בשרשרת של קריאות.
clear Waypoints()
ניקוי הקבוצה הנוכחית של נקודות הדרך.
const directionFinder = Maps.newDirectionFinder(); // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
get Directions()
הפונקציה מקבלת את המסלול לפי נקודת המוצא, היעד והאפשרויות האחרות שהוגדרו.
// 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 שמכיל את קבוצת המסלולים להוראות, כפי שמתואר כאן
ראה גם
set Alternatives(useAlternatives)
מגדיר אם להחזיר נתיבים חלופיים במקום רק את המסלול בעל הדירוג הגבוה ביותר (ברירת המחדל היא false). אם הערך הוא True, מערך routes
של האובייקט שנוצר עשוי להכיל כמה רשומות.
// Creates a DirectionFinder with alternative routes enabled. const directionFinder = Maps.newDirectionFinder().setAlternatives(true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
use | Boolean | true כדי להציג מסלולים חלופיים, false אחרת |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
set Arrive(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 | שעת ההגעה |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
ראה גם
set Avoid(avoid)
מגדיר אם להימנע מסוגים מסוימים של הגבלות.
// Creates a DirectionFinder that avoid highways. const directionFinder = Maps.newDirectionFinder().setAvoid( Maps.DirectionFinder.Avoid.HIGHWAYS, );
פרמטרים
שם | סוג | תיאור |
---|---|---|
avoid | String | ערך קבוע מ-Avoid |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
ראה גם
set Depart(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 | שעת היציאה |
חזרה
Direction
– האובייקט DirectionFinder שעוזר בשרשרת של קריאות.
ראה גם
set Destination(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 | קו האורך של מיקום הסיום |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
set Destination(address)
מגדיר את מיקום הסיום שעבורו רוצים לחשב מסלול, באמצעות כתובת.
// Creates a DirectionFinder with the destination set to Central Park. const directionFinder = Maps.newDirectionFinder().setDestination( 'Central Park, New York, NY', );
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | הכתובת הסופית |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
set Language(language)
הגדרת השפה שבה יושמעו ההנחיות.
// Creates a DirectionFinder with the language set to French. const directionFinder = Maps.newDirectionFinder().setLanguage('fr');
פרמטרים
שם | סוג | תיאור |
---|---|---|
language | String | מזהה שפה לפי BCP-47 |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
ראה גם
set Mode(mode)
הגדרת אמצעי התחבורה (ברירת המחדל היא 'רכב').
// Creates a DirectionFinder with the mode set to walking. const directionFinder = Maps.newDirectionFinder().setMode( Maps.DirectionFinder.Mode.WALKING, );
פרמטרים
שם | סוג | תיאור |
---|---|---|
mode | String | ערך קבוע מ-Mode |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
ראה גם
set Optimize Waypoints(optimizeOrder)
קובע אם לבצע אופטימיזציה של המסלול שסופק על ידי סידור מחדש של נקודות העצירה בסדר יעיל יותר (ברירת המחדל היא false).
// Creates a DirectionFinder with wapoint optimization enabled. const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
optimize | Boolean | true כדי לבצע אופטימיזציה של הסדר, או false אחרת |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
ראה גם
set Origin(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 | קו האורך של מיקום ההתחלה |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות
set Origin(address)
הגדרת מיקום ההתחלה שממנו יחושבו המסלולים, באמצעות כתובת.
// Creates a DirectionFinder with the origin set to Times Square. const directionFinder = Maps.newDirectionFinder().setOrigin( 'Times Square, New York, NY', );
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | כתובת ההתחלה |
חזרה
Direction
– מופע של DirectionFinder כדי לאפשר שרשור של קריאות
set Region(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 | קוד האזור שבו רוצים להשתמש |
חזרה
Direction
– האובייקט DirectionFinder כדי לאפשר שרשור של קריאות