این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class 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