امکان بازیابی مسیرها بین مکانها را فراهم میکند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس برای دریافت مسیر از میدان تایمز تا پارک مرکزی، با توقف اول در مرکز لینکلن، ترسیم مکانها و مسیر روی نقشه و ارسال نقشه از طریق ایمیل استفاده کنید.
// 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 | منطقهای را برای استفاده هنگام تفسیر نام مکانها تنظیم میکند. |
مستندات دقیق
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 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 که شامل مجموعهای از مسیرها برای جهتها است، همانطور که در اینجا توضیح داده شده است.
همچنین ببینید
setAlternatives(useAlternatives)
تعیین میکند که آیا مسیرهای جایگزین، به جای فقط مسیر با بالاترین رتبه (پیشفرض false ) بازگردانده شوند یا خیر. اگر true ، آرایهی routes شیء حاصل ممکن است شامل چندین ورودی باشد.
// Creates a DirectionFinder with alternative routes enabled. const directionFinder = Maps.newDirectionFinder().setAlternatives(true);
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
use Alternatives | Boolean | برای برگرداندن مسیرهای جایگزین true و در غیر این صورت false . |
بازگشت
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 برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
setAvoid(avoid)
تنظیم میکند که آیا از انواع خاصی از محدودیتها اجتناب شود یا خیر.
// Creates a DirectionFinder that avoid highways. const directionFinder = Maps.newDirectionFinder().setAvoid( Maps.DirectionFinder.Avoid.HIGHWAYS, );
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
avoid | String | یک مقدار ثابت از Avoid . |
بازگشت
DirectionFinder — شیء DirectionFinder برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
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 برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
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 برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
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 برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
setOptimizeWaypoints(optimizeOrder)
تنظیم میکند که آیا مسیر ارائه شده با مرتبسازی مجدد نقاط مسیر به ترتیب کارآمدتر، بهینهسازی شود یا خیر (پیشفرض روی false ).
// Creates a DirectionFinder with wapoint optimization enabled. const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
optimize Order | Boolean | برای بهینهسازی ترتیب، true و در غیر این صورت false وارد کنید. |
بازگشت
DirectionFinder — شیء DirectionFinder برای تسهیل زنجیرهسازی فراخوانیها.
همچنین ببینید
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 Maps هستند. برای مثال، کد منطقه "uk" مطابق با "maps.google.co.uk" است.
// Creates a DirectionFinder with the region set to France. const directionFinder = Maps.newDirectionFinder().setRegion('fr');
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
region | String | کد منطقه مورد استفاده. |
بازگشت
DirectionFinder — شیء DirectionFinder برای تسهیل زنجیرهسازی فراخوانیها.