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

راجع أيضًا

الطُرق

الطريقةنوع الإرجاعوصف قصير
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);

المعلّمات

الاسمالنوعالوصف
latitudeNumberخط العرض للنقطة القصيرة على الطريق.
longitudeNumberخط الطول للمسار

تذكرة ذهاب وعودة

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


addWaypoint(address)

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

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');

المعلّمات

الاسمالنوعالوصف
addressStringعنوان.

تذكرة ذهاب وعودة

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


clearWaypoints()

يؤدي إلى محو المجموعة الحالية من نقاط المسار.

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

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات


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 يحتوي على مجموعة من الاتجاهات، كما هو موضّح هنا

راجع أيضًا


setAlternatives(useAlternatives)

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

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

المعلّمات

الاسمالنوعالوصف
useAlternativesBooleanصحيح لعرض مسارات بديلة، خطأ بخلاف ذلك

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات


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);

المعلّمات

الاسمالنوعالوصف
timeDateوقت الوصول

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا


setAvoid(avoid)

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

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

المعلّمات

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

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا


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);

المعلّمات

الاسمالنوعالوصف
timeDateوقت المغادرة

تذكرة ذهاب وعودة

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

راجع أيضًا


setDestination(latitude, longitude)

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

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

المعلّمات

الاسمالنوعالوصف
latitudeNumberخط العرض للموقع النهائي
longitudeNumberخط الطول للموقع النهائي

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات


setDestination(address)

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

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');

المعلّمات

الاسمالنوعالوصف
addressStringعنوان الانتهاء

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات


setLanguage(language)

إعداد اللغة التي سيتم استخدامها للاتجاهات

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

المعلّمات

الاسمالنوعالوصف
languageStringمعرّف اللغة BCP-47

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا


setMode(mode)

تضبط هذه السياسة وضع التنقّل (الإعداد التلقائي هو "القيادة").

// Creates a DirectionFinder with the mode set to walking.
var directionFinder = Maps.newDirectionFinder().setMode(Maps.DirectionFinder.Mode.WALKING);

المعلّمات

الاسمالنوعالوصف
modeStringقيمة ثابتة من Mode

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا


setOptimizeWaypoints(optimizeOrder)

لتحديد ما إذا كان سيتم تحسين المسار المقدَّم أم لا من خلال إعادة ترتيب نقاط المسار بترتيب أكثر فعالية (الإعداد التلقائي على "خطأ").

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

المعلّمات

الاسمالنوعالوصف
optimizeOrderBooleanصحيح لتحسين الترتيب أو خطأ في الحالات الأخرى

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا


setOrigin(latitude, longitude)

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

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

المعلّمات

الاسمالنوعالوصف
latitudeNumberخط العرض لموقع البداية
longitudeNumberخط الطول للموقع الجغرافي للبدء

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات


setOrigin(address)

تتيح هذه السياسة ضبط موقع البدء الذي يمكن من خلاله حساب الاتجاهات، وذلك باستخدام عنوان.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');

المعلّمات

الاسمالنوعالوصف
addressStringعنوان البدء

تذكرة ذهاب وعودة

DirectionFinder - مثيل DirectionFinder لتسهيل تسلسل المكالمات


setRegion(region)

تعمل هذه السياسة على ضبط منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية. تتوافق رموز المناطق المتوافقة مع نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD) المتوافقة مع "خرائط Google". على سبيل المثال، يتطابق رمز المنطقة "uk"quot; مع "maps;google.co.uk".

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

المعلّمات

الاسمالنوعالوصف
regionStringرمز المنطقة المطلوب استخدامه

تذكرة ذهاب وعودة

DirectionFinder: كائن Direction Finderer لتسهيل تسلسل المكالمات

راجع أيضًا