امکان بازیابی مسیرها بین مکانها را فراهم میکند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس برای دریافت مسیر از میدان تایمز تا پارک مرکزی، با توقف اول در مرکز لینکلن، ترسیم مکانها و مسیر روی نقشه و ارسال نقشه از طریق ایمیل استفاده کنید.
// 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 برای تسهیل زنجیرهسازی فراخوانیها.