امکان بازیابی جهت ها بین مکان ها را فراهم می کند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس برای دریافت مسیرها از میدان تایمز به سنترال پارک استفاده کنید، ابتدا در مرکز لینکلن توقف کنید، مکانها و مسیر را روی نقشه ترسیم کنید و نقشه را از طریق ایمیل ارسال کنید.
// 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);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
latitude | Number | عرض جغرافیایی نقطه بین راه. |
longitude | Number | طول نقطه راه. |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها.
addWaypoint(address)
با استفاده از یک آدرس، نقطهای را اضافه میکند که مسیر باید از آن عبور کند.
// Creates a DirectionFinder with a wapoint at Lincoln Center. var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
address | String | یک آدرس. |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها.
clearWaypoints()
مجموعه فعلی ایستگاه های بین راه را پاک می کند.
var 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. 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);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
useAlternatives | Boolean | برای بازگشت مسیرهای جایگزین صحیح است، در غیر این صورت نادرست است |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
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);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
time | Date | زمان ورود |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
همچنین ببینید
setAvoid(avoid)
تعیین می کند که آیا از انواع خاصی از محدودیت ها اجتناب شود.
// Creates a DirectionFinder that avoid highways. var 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. var now = new Date(); var depart = new Date(now.getTime() + (1 * 60 * 60 * 1000)); var directionFinder = Maps.newDirectionFinder().setDepart(depart);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
time | Date | زمان حرکت |
برگشت
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);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
latitude | Number | عرض جغرافیایی مکان پایانی |
longitude | Number | طول جغرافیایی مکان پایانی |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
setDestination(address)
با استفاده از یک آدرس، مکان پایانی را برای محاسبه مسیرها تعیین می کند.
// Creates a DirectionFinder with the destination set to Central Park. var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
address | String | آدرس پایانی |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
setLanguage(language)
زبان مورد استفاده برای جهت ها را تنظیم می کند.
// Creates a DirectionFinder with the language set to French. var directionFinder = Maps.newDirectionFinder().setLanguage('fr');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
language | String | یک شناسه زبان BCP-47 |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
همچنین ببینید
setMode(mode)
حالت سفر را تنظیم می کند (پیش فرض برای رانندگی).
// Creates a DirectionFinder with the mode set to walking. var directionFinder = Maps.newDirectionFinder().setMode(Maps.DirectionFinder.Mode.WALKING);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
mode | String | یک مقدار ثابت از Mode |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
همچنین ببینید
setOptimizeWaypoints(optimizeOrder)
تنظیم می کند که آیا مسیر ارائه شده را با مرتب کردن مجدد نقاط راه به ترتیب کارآمدتر (پیش فرض به غلط) بهینه می کند یا خیر.
// Creates a DirectionFinder with wapoint optimization enabled. var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
optimizeOrder | Boolean | درست برای بهینه سازی ترتیب، یا نادرست در غیر این صورت |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها
همچنین ببینید
setOrigin(latitude, longitude)
با استفاده از یک نقطه (lat/lng)، مکان شروعی را که از آن جهت محاسبه می شود، تنظیم می کند.
// Creates a DirectionFinder with the origin set to Times Square. var 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. var 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. var directionFinder = Maps.newDirectionFinder().setRegion('fr');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
region | String | کد منطقه برای استفاده |
برگشت
DirectionFinder
- شی DirectionFinder برای تسهیل زنجیره ای شدن تماس ها