Class DirectionFinder

DirectionFinder

امکان بازیابی جهت ها بین مکان ها را فراهم می کند.
مثال زیر نشان می‌دهد که چگونه می‌توانید از این کلاس برای دریافت مسیرها از میدان تایمز به سنترال پارک استفاده کنید، ابتدا در مرکز لینکلن توقف کنید، مکان‌ها و مسیر را روی نقشه ترسیم کنید و نقشه را از طریق ایمیل ارسال کنید.

// 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	تعیین می کند که آیا مسیرهای جایگزین باید به جای بالاترین رتبه (پیش فرض به نادرست) بازگردانده شوند یا نه.
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	تنظیم می کند که آیا مسیر ارائه شده را با مرتب کردن مجدد نقاط راه به ترتیب کارآمدتر (پیش فرض به غلط) بهینه می کند یا خیر.
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)

تعیین می کند که آیا مسیرهای جایگزین باید به جای بالاترین رتبه (پیش فرض به نادرست) بازگردانده شوند یا نه. اگر درست باشد، آرایه routes شی حاصل ممکن است حاوی چندین ورودی باشد.

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

مولفه های

نام	تایپ کنید	شرح
useAlternatives	Boolean	برای بازگشت مسیرهای جایگزین صحیح است، در غیر این صورت نادرست است

برگشت

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)

تنظیم می کند که آیا مسیر ارائه شده را با مرتب کردن مجدد نقاط راه به ترتیب کارآمدتر (پیش فرض به غلط) بهینه می کند یا خیر.

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

مولفه های

نام	تایپ کنید	شرح
optimizeOrder	Boolean	درست برای بهینه سازی ترتیب، یا نادرست در غیر این صورت

برگشت

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 Maps مطابقت دارد. برای مثال، کد منطقه "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