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

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

روش‌ها

روش نوع بازگشتی شرح مختصر
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 تعیین می‌کند که آیا مسیرهای جایگزین، به جای فقط مسیر با بالاترین رتبه، بازگردانده شوند یا خیر (پیش‌فرض false است).
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 تنظیم می‌کند که آیا مسیر ارائه شده با مرتب‌سازی مجدد نقاط مسیر به ترتیب کارآمدتر، بهینه‌سازی شود یا خیر (پیش‌فرض روی false ).
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 takes 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 Alternatives Boolean برای برگرداندن مسیرهای جایگزین true و در غیر این صورت false .

بازگشت

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 برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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


set Avoid(avoid)

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

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

پارامترها

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

بازگشت

Direction Finder - شیء 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 Finder - شیء DirectionFinder برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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


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 برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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


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 برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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


set Optimize Waypoints(optimizeOrder)

تنظیم می‌کند که آیا مسیر ارائه شده با مرتب‌سازی مجدد نقاط مسیر به ترتیب کارآمدتر، بهینه‌سازی شود یا خیر (پیش‌فرض روی false ).

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

پارامترها

نام نوع توضیحات
optimize Order Boolean برای بهینه‌سازی ترتیب، true و در غیر این صورت false وارد کنید.

بازگشت

Direction Finder - شیء DirectionFinder برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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


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 برای تسهیل زنجیره‌سازی فراخوانی‌ها.

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