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

Class DirectionFinder

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

// 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

روش ها

روش	نوع برگشت	شرح مختصر
`add Waypoint(latitude, longitude)`	`Direction Finder`	با استفاده از یک نقطه (lat/lng)، نقطه‌ای را اضافه می‌کند که مسیر باید از آن عبور کند.
`add Waypoint(address)`	`Direction Finder`	با استفاده از یک آدرس، نقطه‌ای را اضافه می‌کند که مسیر باید از آن عبور کند.
`clear Waypoints()`	`Direction Finder`	مجموعه فعلی ایستگاه های بین راه را پاک می کند.
`get Directions()`	`Object`	مسیرها را با استفاده از مبدا، مقصد و سایر گزینه‌های تنظیم شده دریافت می‌کند.
`set Alternatives(useAlternatives)`	`Direction Finder`	تعیین می کند که آیا مسیرهای جایگزین باید به جای بالاترین رتبه (پیش فرض به نادرست) بازگردانده شوند یا نه.
`set Arrive(time)`	`Direction Finder`	زمان مورد نظر رسیدن (در صورت لزوم) را تنظیم می کند.
`set Avoid(avoid)`	`Direction Finder`	تعیین می کند که آیا از انواع خاصی از محدودیت ها اجتناب شود.
`set Depart(time)`	`Direction Finder`	زمان حرکت مورد نظر را تنظیم می کند (در صورت لزوم).
`set Destination(latitude, longitude)`	`Direction Finder`	با استفاده از یک نقطه (lat/lng) مکان پایانی را برای محاسبه جهت تعیین می کند.
`set Destination(address)`	`Direction Finder`	با استفاده از یک آدرس، مکان پایانی را برای محاسبه مسیرها تعیین می کند.
`set Language(language)`	`Direction Finder`	زبان مورد استفاده برای جهت ها را تنظیم می کند.
`set Mode(mode)`	`Direction Finder`	حالت سفر را تنظیم می کند (به طور پیش فرض رانندگی).
`set Optimize Waypoints(optimizeOrder)`	`Direction Finder`	تنظیم می کند که آیا مسیر ارائه شده را با مرتب کردن مجدد نقاط راه به ترتیب کارآمدتر (پیش فرض به غلط) بهینه می کند یا خیر.
`set Origin(latitude, longitude)`	`Direction Finder`	با استفاده از یک نقطه (lat/lng)، مکان شروعی را که از آن جهت محاسبه می شود، تنظیم می کند.
`set Origin(address)`	`Direction Finder`	با استفاده از یک آدرس، مکان شروع را برای محاسبه مسیرها تنظیم می کند.
`set Region(region)`	`Direction Finder`	منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند.

مستندات دقیق

`add Waypoint(latitude, longitude)`

با استفاده از یک نقطه (lat/lng)، نقطه‌ای را اضافه می‌کند که مسیر باید از آن عبور کند.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    40.772628,
    -73.984243,
);

پارامترها

نام	تایپ کنید	توضیحات
`latitude`	`Number`	عرض جغرافیایی نقطه بین راه.
`longitude`	`Number`	طول نقطه راه.

بازگشت

Direction Finder - شی 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 Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها.

`clear Waypoints()`

مجموعه فعلی ایستگاه های بین راه را پاک می کند.

const directionFinder = Maps.newDirectionFinder();
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

بازگشت

Direction Finder - شی 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 حاوی مجموعه مسیرها برای مسیرها، همانطور که در اینجا توضیح داده شده است

همچنین ببینید

Google Directions API

`set Alternatives(useAlternatives)`

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

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

پارامترها

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

بازگشت

Direction Finder - شی 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 Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

Google Directions API

`set Avoid(avoid)`

تعیین می کند که آیا از انواع خاصی از محدودیت ها اجتناب شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`avoid`	`String`	یک مقدار ثابت از `Avoid`

بازگشت

Direction Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

Google Directions API

`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 Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها.

همچنین ببینید

Google Directions API

`set Destination(latitude, longitude)`

با استفاده از یک نقطه (lat/lng) مکان پایانی را برای محاسبه جهت تعیین می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`latitude`	`Number`	عرض جغرافیایی مکان پایانی
`longitude`	`Number`	طول جغرافیایی مکان پایانی

بازگشت

Direction Finder - شی 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 Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

`set Language(language)`

زبان مورد استفاده برای جهت ها را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`language`	`String`	یک شناسه زبان BCP-47

بازگشت

Direction Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

پشتیبانی زبان در Google Maps API

`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 Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

Google Directions API

`set Optimize Waypoints(optimizeOrder)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`optimize Order`	`Boolean`	درست برای بهینه سازی ترتیب، یا نادرست است

بازگشت

Direction Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

Google Directions API

`set Origin(latitude, longitude)`

با استفاده از یک نقطه (lat/lng)، مکان شروعی را که از آن جهت محاسبه می شود، تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`latitude`	`Number`	عرض جغرافیایی محل شروع
`longitude`	`Number`	طول جغرافیایی محل شروع

بازگشت

Direction Finder - شی 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 Finder - نمونه DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

`set Region(region)`

منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند. کدهای منطقه پشتیبانی شده با ccTLD های پشتیبانی شده توسط Google Maps مطابقت دارد. برای مثال، کد منطقه "uk" با "maps.google.co.uk" مطابقت دارد.

// Creates a DirectionFinder with the region set to France.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

پارامترها

نام	تایپ کنید	توضیحات
`region`	`String`	کد منطقه برای استفاده

بازگشت

Direction Finder - شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها

همچنین ببینید

Google Directions API