تمت ترجمة هذه الصفحة بواسطة 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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`addWaypoint(latitude, longitude)`	`DirectionFinder`	يضيف نقطة طريق يجب أن يمر بها المسار، باستخدام نقطة (خطوط الطول/العرض).
`addWaypoint(address)`	`DirectionFinder`	يضيف نقطة وسيطة يجب أن يمر بها المسار، باستخدام عنوان.
`clearWaypoints()`	`DirectionFinder`	يؤدي هذا الإجراء إلى محو المجموعة الحالية من نقاط الطريق.
`getDirections()`	`Object`	الحصول على الاتجاهات باستخدام نقطة الانطلاق والوجهة والخيارات الأخرى التي تم ضبطها
`setAlternatives(useAlternatives)`	`DirectionFinder`	تحدّد ما إذا كان يجب إعادة المسارات البديلة أم لا، بدلاً من الاكتفاء بالمسارات الأعلى ترتيبًا المسار (القيمة الافتراضية هي false).
`setArrive(time)`	`DirectionFinder`	تُحدّد وقت الوصول المطلوب (إن أمكن).
`setAvoid(avoid)`	`DirectionFinder`	تحدِّد هذه السياسة ما إذا كان يجب تجنُّب أنواع معيّنة من القيود.
`setDepart(time)`	`DirectionFinder`	تحدِّد هذه السياسة وقت المغادرة المطلوب (حيثما كان ذلك منطبقًا).
`setDestination(latitude, longitude)`	`DirectionFinder`	لتعيين موقع النهاية الذي يجب حساب الاتجاهات إليه، باستخدام نقطة (خط الطول/العرض).
`setDestination(address)`	`DirectionFinder`	لتعيين موقع النهاية الذي يجب حساب الاتجاهات إليه، باستخدام عنوان.
`setLanguage(language)`	`DirectionFinder`	لضبط اللغة التي سيتم استخدامها في التوجيهات.
`setMode(mode)`	`DirectionFinder`	لضبط وضع السفر (الوضع التلقائي على القيادة).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	لتعيين ما إذا كان سيتم تحسين المسار المقدم أم لا عن طريق إعادة ترتيب نقاط الطريق في ترتيب فعال (القيم الافتراضية هي false).
`setOrigin(latitude, longitude)`	`DirectionFinder`	لتعيين موقع البداية الذي يجب حساب الاتجاهات منه، باستخدام نقطة (خط العرض/Lng).
`setOrigin(address)`	`DirectionFinder`	لضبط موقع البداية الذي يتم حساب الاتجاهات منه، باستخدام عنوان.
`setRegion(region)`	`DirectionFinder`	لضبط منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية.

الوثائق التفصيلية

`addWaypoint(latitude, longitude)`

يضيف نقطة طريق يجب أن يمر بها المسار، باستخدام نقطة (خطوط الطول/العرض).

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

`setAlternatives(useAlternatives)`

تحدّد ما إذا كان يجب إعادة المسارات البديلة أم لا، بدلاً من الاكتفاء بالمسارات الأعلى ترتيبًا المسار (القيمة الافتراضية هي false). إذا كانت القيمة هي true، قد لا تتوفر مصفوفة routes للكائن الناتج تحتوي على إدخالات متعددة.

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

المعلمات

الاسم	النوع	الوصف
`useAlternatives`	`Boolean`	true لعرض مسارات بديلة، أو false في الحالات الأخرى

الإرجاع

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

`setAvoid(avoid)`

تحدِّد هذه السياسة ما إذا كان يجب تجنُّب أنواع معيّنة من القيود.

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

المعلمات

الاسم	النوع	الوصف
`avoid`	`String`	قيمة ثابتة من `Avoid`

الإرجاع

DirectionFinder - كائن DirectionFinder لتسهيل تسلسل المكالمات.

انظر أيضًا

واجهة برمجة تطبيقات Google Directions

`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

`setDestination(latitude, longitude)`

لتعيين موقع النهاية الذي يجب حساب الاتجاهات إليه، باستخدام نقطة (خط الطول/العرض).

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

`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

`setOptimizeWaypoints(optimizeOrder)`

لتعيين ما إذا كان سيتم تحسين المسار المقدم أم لا عن طريق إعادة ترتيب نقاط الطريق في ترتيب فعال (القيم الافتراضية هي false).

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

المعلمات

الاسم	النوع	الوصف
`optimizeOrder`	`Boolean`	صحيح لتحسين الترتيب، أو false بخلاف ذلك

الإرجاع

DirectionFinder - كائن DirectionFinder لتسهيل تسلسل المكالمات.

انظر أيضًا

واجهة برمجة تطبيقات Google Directions

`setOrigin(latitude, longitude)`

لتعيين موقع البداية الذي يجب حساب الاتجاهات منه، باستخدام نقطة (خط العرض/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 — مثيل DirectFinder لتسهيل تسلسل المكالمات

`setRegion(region)`

لضبط منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية. تتوافق رموز المناطق المتوافقة مع نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD) المعتمدة في خرائط Google. على سبيل المثال، يجب استخدام رمز المنطقة "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