تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DirectionFinder

السماح باسترداد الاتجاهات بين المواقع الجغرافية
يوضّح المثال أدناه كيفية استخدام هذه الفئة للحصول على الاتجاهات من Times Square إلى Central Park، مع التوقف أولاً في Lincoln Center، وتخطيط المواقع الجغرافية والمسار على خريطة، وإرسال الخريطة في رسالة إلكترونية.

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

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`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.
const 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.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

المعلَمات

الاسم	النوع	الوصف
`address`	`String`	عنوان

الإرجاع

‫DirectionFinder - عنصر DirectionFinder لتسهيل تسلسل المكالمات

`clearWaypoints()`

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

const 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.
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

`setAlternatives(useAlternatives)`

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

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

المعلَمات

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

الإرجاع

DirectionFinder - عنصر DirectionFinder لتسهيل تسلسل المكالمات

`setArrive(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`	وقت الوصول

الإرجاع

DirectionFinder - عنصر DirectionFinder لتسهيل تسلسل المكالمات

انظر أيضًا

Google Directions API

`setAvoid(avoid)`

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

// Creates a DirectionFinder that avoid highways.
const 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.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const 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.
const 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.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

المعلَمات

الاسم	النوع	الوصف
`address`	`String`	العنوان النهائي

الإرجاع

DirectionFinder - عنصر DirectionFinder لتسهيل تسلسل المكالمات

`setLanguage(language)`

لضبط اللغة المستخدَمة للاتّجاهات

// Creates a DirectionFinder with the language set to French.
const 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.
const 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.
const 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.
const 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.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    'Times Square, New York, NY',
);

المعلَمات

الاسم	النوع	الوصف
`address`	`String`	عنوان البدء

الإرجاع

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

`setRegion(region)`

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

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

المعلَمات

الاسم	النوع	الوصف
`region`	`String`	رمز المنطقة المراد استخدامها

الإرجاع

DirectionFinder - عنصر DirectionFinder لتسهيل تسلسل المكالمات

انظر أيضًا

Google Directions API