يسمح هذا الإذن باسترداد الاتجاهات بين المواقع الجغرافية.
يوضّح المثال أدناه كيفية استخدام هذه الفئة للحصول على الاتجاهات من ميدان تايمز سكوير إلى
سنترال بارك، مع التوقف أولاً في مركز لينكولن، ورسم المواقع الجغرافية والمسار على خريطة، وإرسال
الخريطة في رسالة إلكترونية.
// 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 | Direction | تضيف هذه السمة نقطة طريق يجب أن يمرّ بها المسار، وذلك باستخدام نقطة (خط العرض/خط الطول). |
add | Direction | تضيف هذه السمة نقطة مرور يجب أن يمرّ بها المسار، وذلك باستخدام عنوان. |
clear | Direction | يمحو مجموعة نقاط الطريق الحالية. |
get | Object | يحصل على الاتجاهات باستخدام نقطة البداية والوجهة والخيارات الأخرى التي تم ضبطها. |
set | Direction | تُحدّد ما إذا كان يجب عرض طرق بديلة بدلاً من الطريق الأعلى ترتيبًا فقط (القيمة التلقائية هي false). |
set | Direction | تضبط هذه السمة الوقت المطلوب للوصول (عند الاقتضاء). |
set | Direction | تحدّد هذه السمة ما إذا كان سيتم تجنُّب أنواع معيّنة من القيود. |
set | Direction | تضبط هذه السمة وقت المغادرة المطلوب (عند الاقتضاء). |
set | Direction | تضبط هذه السمة الموقع الجغرافي النهائي الذي سيتم حساب الاتجاهات إليه، وذلك باستخدام نقطة (خط العرض/خط الطول). |
set | Direction | تضبط هذه السمة الموقع الجغرافي النهائي الذي سيتم احتساب الاتجاهات إليه باستخدام عنوان. |
set | Direction | تضبط هذه السمة اللغة التي سيتم استخدامها في الاتجاهات. |
set | Direction | تُحدِّد هذه السمة وسيلة النقل (تكون القيادة هي الخيار التلقائي). |
set | Direction | تحدّد هذه السمة ما إذا كان سيتم تحسين المسار المقدَّم من خلال إعادة ترتيب نقاط الطريق بترتيب أكثر فعالية (القيمة التلقائية هي false). |
set | Direction | تضبط هذه السمة الموقع الجغرافي الذي سيتم منه حساب الاتجاهات، وذلك باستخدام نقطة (خط العرض/خط الطول). |
set | Direction | تضبط هذه السمة الموقع الجغرافي الذي سيتم منه احتساب الاتجاهات، وذلك باستخدام عنوان. |
set | Direction | تضبط هذه السمة منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية. |
مستندات تفصيلية
add Waypoint(latitude, longitude)
تضيف هذه السمة نقطة طريق يجب أن يمرّ بها المسار، وذلك باستخدام نقطة (خط العرض/خط الطول).
// Creates a DirectionFinder with a wapoint at Lincoln Center. const directionFinder = Maps.newDirectionFinder().addWaypoint( 40.772628, -73.984243, );
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط عرض نقطة الطريق. |
longitude | Number | تمثّل هذه السمة خط طول نقطة الطريق. |
الإرجاع
Direction: كائن 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: كائن DirectionFinder لتسهيل تسلسل المكالمات.
clear Waypoints()
يمحو مجموعة نقاط الطريق الحالية.
const directionFinder = Maps.newDirectionFinder(); // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
الإرجاع
Direction: كائن 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 | Boolean | true لعرض مسارات بديلة، أو false في حال عدم توفّرها. |
الإرجاع
Direction: كائن 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: كائن DirectionFinder لتسهيل تسلسل المكالمات.
انظر أيضًا
set Avoid(avoid)
تحدّد هذه السمة ما إذا كان سيتم تجنُّب أنواع معيّنة من القيود.
// Creates a DirectionFinder that avoid highways. const directionFinder = Maps.newDirectionFinder().setAvoid( Maps.DirectionFinder.Avoid.HIGHWAYS, );
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
avoid | String | قيمة ثابتة من Avoid |
الإرجاع
Direction: كائن 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: كائن DirectionFinder لتسهيل تسلسل المكالمات.
انظر أيضًا
set Destination(latitude, longitude)
تضبط هذه السمة الموقع الجغرافي النهائي الذي سيتم حساب الاتجاهات إليه، وذلك باستخدام نقطة (خط العرض/خط الطول).
// Creates a DirectionFinder with the destination set to Central Park. const directionFinder = Maps.newDirectionFinder().setDestination( 40.777052, -73.975464, );
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للموقع الجغرافي الذي تنتهي فيه الرحلة. |
longitude | Number | تمثّل هذه السمة خط الطول للموقع الجغرافي النهائي. |
الإرجاع
Direction: كائن 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: كائن DirectionFinder لتسهيل تسلسل المكالمات.
set Language(language)
تضبط هذه السمة اللغة التي سيتم استخدامها في الاتجاهات.
// Creates a DirectionFinder with the language set to French. const directionFinder = Maps.newDirectionFinder().setLanguage('fr');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
language | String | معرّف لغة BCP-47 |
الإرجاع
Direction: كائن 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: كائن DirectionFinder لتسهيل تسلسل المكالمات.
انظر أيضًا
set Optimize Waypoints(optimizeOrder)
تحدّد هذه السمة ما إذا كان سيتم تحسين المسار المقدَّم من خلال إعادة ترتيب نقاط الطريق بترتيب أكثر فعالية (القيمة التلقائية هي false).
// Creates a DirectionFinder with wapoint optimization enabled. const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
optimize | Boolean | true لتحسين الترتيب، أو false لأي سبب آخر |
الإرجاع
Direction: كائن DirectionFinder لتسهيل تسلسل المكالمات.
انظر أيضًا
set Origin(latitude, longitude)
تضبط هذه السمة الموقع الجغرافي الذي سيتم منه حساب الاتجاهات، وذلك باستخدام نقطة (خط العرض/خط الطول).
// Creates a DirectionFinder with the origin set to Times Square. const directionFinder = Maps.newDirectionFinder().setOrigin( 40.759011, -73.984472, );
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للموقع الجغرافي الذي تبدأ منه الرحلة. |
longitude | Number | تمثّل هذه السمة خط الطول للموقع الجغرافي الذي تبدأ منه الرحلة. |
الإرجاع
Direction: كائن 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: مثيل DirectionFinder لتسهيل ربط المكالمات.
set Region(region)
تضبط هذه السمة منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية. تتطابق رموز المناطق المتاحة مع أسماء نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد والمتاحة على "خرائط Google". على سبيل المثال، يتوافق رمز المنطقة "uk" مع "maps.google.co.uk".
// Creates a DirectionFinder with the region set to France. const directionFinder = Maps.newDirectionFinder().setRegion('fr');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
region | String | رمز المنطقة المطلوب استخدامه. |
الإرجاع
Direction: كائن DirectionFinder لتسهيل تسلسل المكالمات.