Directions

کلاس خدمات Directions

google.maps . DirectionsService کلاس google.maps . DirectionsService

سرویسی برای محاسبه مسیرهای بین دو یا چند مکان.

با فراخوانی const {DirectionsService} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

DirectionsService
DirectionsService()
پارامترها: ندارد
یک نمونه جدید از DirectionsService ایجاد می کند که جستجوهای مسیرها را به سرورهای Google ارسال می کند.
route
route(request[, callback])
مولفه های:
مقدار بازگشتی: Promise < DirectionsResult >
درخواست جستجوی مسیرها را صادر کنید.

رابط DirectionsRequest

google.maps . DirectionsRequest رابط google.maps . DirectionsRequest

یک جستار جهت ارسال به DirectionsService .

destination
نوع: string| LatLng | Place | LatLngLiteral
محل مقصد. این می تواند به عنوان یک رشته برای کدگذاری جغرافیایی، یا یک LatLng یا یک Place مشخص شود. ضروری.
origin
نوع: string| LatLng | Place | LatLngLiteral
محل مبدا. این می تواند به عنوان یک رشته برای کدگذاری جغرافیایی، یا یک LatLng یا یک Place مشخص شود. ضروری.
travelMode
نوع: TravelMode
نوع مسیریابی درخواستی ضروری.
avoidFerries optional
نوع: boolean optional
اگر true ، به خدمات دستورالعمل دستور می دهد تا در صورت امکان از کشتی اجتناب کند. اختیاری.
avoidHighways optional
نوع: boolean optional
اگر true ، به سرویس دستورالعمل دستور می دهد تا در صورت امکان از بزرگراه ها اجتناب کند. اختیاری.
avoidTolls optional
نوع: boolean optional
اگر true ، به خدمات دستورالعمل دستور می دهد تا در صورت امکان از جاده های عوارضی اجتناب کند. اختیاری.
drivingOptions optional
نوع: DrivingOptions optional
تنظیماتی که فقط برای درخواست‌هایی اعمال می‌شوند که در آن travelMode DRIVING است. این شی هیچ تاثیری برای سایر حالت های سفر نخواهد داشت.
language optional
نوع: string optional
شناسه زبان برای زبانی که نتایج باید در صورت امکان به آن بازگردانده شوند. لیست زبان های پشتیبانی شده را ببینید.
optimizeWaypoints optional
نوع: boolean optional
اگر روی true تنظیم شود، DirectionsService تلاش می کند تا ایستگاه های بین راهی ارائه شده را دوباره ترتیب دهد تا هزینه کلی مسیر را به حداقل برساند. اگر نقاط بین راه بهینه شده اند، DirectionsRoute.waypoint_order در پاسخ برای تعیین ترتیب جدید بررسی کنید.
provideRouteAlternatives optional
نوع: boolean optional
اینکه آیا مسیرهای جایگزین باید ارائه شود یا خیر. اختیاری.
region optional
نوع: string optional
کد منطقه به عنوان یک سوگیری برای درخواست های کدگذاری جغرافیایی استفاده می شود. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
transitOptions optional
نوع: TransitOptions optional
تنظیماتی که فقط برای درخواست‌هایی اعمال می‌شوند که در آن‌ها travelMode TRANSIT است. این شی هیچ تاثیری برای سایر حالت های سفر نخواهد داشت.
unitSystem optional
نوع: UnitSystem optional
پیش فرض: سیستم واحد مورد استفاده در کشور مبدا.
سیستم واحد ترجیحی برای استفاده هنگام نمایش فاصله.
waypoints optional
نوع: Array < DirectionsWaypoint > optional
آرایه ای از ایستگاه های بین راهی. مسیرها از مبدا تا مقصد از طریق هر نقطه راه در این آرایه محاسبه می شوند. برای حداکثر تعداد نقاط مجاز، به راهنمای توسعه‌دهنده مراجعه کنید. نقاط راه برای مسیرهای حمل و نقل پشتیبانی نمی شوند. اختیاری.

مسیرهای ثابت وضعیت

google.maps . DirectionsStatus وضعیت

وضعیتی که توسط DirectionsService پس از تکمیل یک فراخوانی به route() باز می گردد. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.DirectionsStatus.OK .

با فراخوانی const {DirectionsStatus} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

INVALID_REQUEST DirectionsRequest ارائه شده نامعتبر بود.
MAX_WAYPOINTS_EXCEEDED تعداد زیادی DirectionsWaypoint در DirectionsRequest ارائه شده است. برای حداکثر تعداد نقاط مجاز، به راهنمای توسعه‌دهنده مراجعه کنید.
NOT_FOUND حداقل یکی از مبدا، مقصد یا ایستگاه های بین راه نمی تواند جغرافیایی کدگذاری شود.
OK پاسخ حاوی DirectionsResult معتبری است.
OVER_QUERY_LIMIT صفحه وب در مدت زمان بسیار کوتاهی از محدودیت درخواست‌ها فراتر رفته است.
REQUEST_DENIED صفحه وب مجاز به استفاده از سرویس مسیرها نیست.
UNKNOWN_ERROR درخواست مسیرها به دلیل خطای سرور قابل پردازش نیست. اگر دوباره تلاش کنید ممکن است درخواست با موفقیت انجام شود.
ZERO_RESULTS هیچ مسیری بین مبدا و مقصد یافت نشد.

رابط DirectionsResult

google.maps . DirectionsResult رابط google.maps . DirectionsResult

پاسخ جهت ها از سرور جهت ها بازیابی شده است. شما می توانید این موارد را با استفاده از DirectionsRenderer رندر کنید یا این شی را تجزیه کنید و خودتان آن را رندر کنید. شما باید اخطارها و حق نسخه برداری را همانطور که در شرایط خدمات پلتفرم Google Maps ذکر شده است نمایش دهید. توجه داشته باشید که اگرچه این نتیجه "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا به طور غیرمستقیم شامل اشیاء LatLng است.

request
DirectionsRequest که این نتیجه را به همراه داشت.
routes
نوع: Array < DirectionsRoute >
آرایه ای از DirectionsRoute که هر کدام حاوی اطلاعاتی درباره پاها و مراحلی است که از آن تشکیل شده است. فقط یک مسیر وجود خواهد داشت مگر اینکه DirectionsRequest با provideRouteAlternatives روی true تنظیم شده باشد.
available_travel_modes optional
نوع: Array < TravelMode > optional
شامل مجموعه ای از حالت های سفر در دسترس است. این فیلد زمانی باز می گردد که یک درخواست حالت سفر را مشخص کند و نتیجه ای نداشته باشد. آرایه شامل حالت های سفر موجود در کشورهای مجموعه داده شده از ایستگاه های بین راه است. در صورتی که یک یا چند نقطه از ایستگاه های بین راه "از طریق ایستگاه های بین راه" باشند، این فیلد برگردانده نمی شود.
geocoded_waypoints optional
نوع: Array < DirectionsGeocodedWaypoint > optional
آرایه ای از DirectionsGeocodedWaypoint ها که هر کدام حاوی اطلاعاتی درباره ژئوکدگذاری مبدا، مقصد و ایستگاه های بین راهی است.

کلاس DirectionsRenderer

google.maps . DirectionsRenderer کلاس google.maps . DirectionsRenderer

دستورالعمل های به دست آمده از DirectionsService را ارائه می دهد.

این کلاس MVCObject را گسترش می دهد.

با فراخوانی const {DirectionsRenderer} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

DirectionsRenderer
DirectionsRenderer([opts])
مولفه های:
رندر را با گزینه های داده شده ایجاد می کند. جهت ها را می توان بر روی نقشه (به عنوان پوشش های بصری) یا علاوه بر این در پانل <div> (به عنوان دستورالعمل های متنی) ارائه کرد.
getDirections
getDirections()
پارامترها: ندارد
مقدار بازگشتی: DirectionsResult
مجموعه جهت‌های فعلی رندر را برمی‌گرداند.
getMap
getMap()
پارامترها: ندارد
مقدار بازگشتی: Map
نقشه ای را که DirectionsResult روی آن رندر شده است برمی گرداند.
getPanel
getPanel()
پارامترها: ندارد
مقدار بازگشتی: HTMLElement |null
پانل <div> را که در آن DirectionsResult ارائه می شود، برمی گرداند.
getRouteIndex
getRouteIndex()
پارامترها: ندارد
مقدار برگشتی: number
شاخص مسیر فعلی (مبتنی بر صفر) را که توسط این شی DirectionsRenderer استفاده می شود، برمی گرداند.
setDirections
setDirections(directions)
مولفه های:
ارزش بازگشتی: ندارد
رندر را طوری تنظیم کنید که از نتیجه DirectionsService استفاده کند. تنظیم یک مجموعه معتبر از جهت ها به این روش، جهت ها را در نقشه و پانل تعیین شده رندر نمایش می دهد.
setMap
setMap(map)
مولفه های:
ارزش بازگشتی: ندارد
این روش نقشه ای را مشخص می کند که در کدام جهت ها نمایش داده می شود. برای حذف مسیرها از نقشه، null پاس کنید.
setOptions
setOptions(options)
مولفه های:
ارزش بازگشتی: ندارد
تنظیمات گزینه های این DirectionsRenderer را پس از مقداردهی اولیه تغییر دهید.
setPanel
setPanel(panel)
مولفه های:
ارزش بازگشتی: ندارد
این روش جهت ها را در یک <div> رندر می کند. برای حذف محتوا از پنل، null پاس کنید.
setRouteIndex
setRouteIndex(routeIndex)
مولفه های:
  • routeIndex : number
ارزش بازگشتی: ندارد
شاخص (مبتنی بر صفر) مسیر را در شی DirectionsResult برای رندر تنظیم کنید. به طور پیش فرض، اولین مسیر در آرایه ارائه می شود.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll
directions_changed
function()
استدلال ها: هیچ
این رویداد زمانی که جهت‌های رندر شده تغییر می‌کنند، یا زمانی که DirectionsResult جدیدی تنظیم می‌شود یا زمانی که کاربر کشیدن تغییر به مسیر جهت‌ها را تمام می‌کند، اجرا می‌شود.

رابط DirectionsRendererOptions

google.maps . DirectionsRendererOptions رابط google.maps . DirectionsRendererOptions

این آبجکت خصوصیاتی را تعریف می کند که می توان روی یک شی DirectionsRenderer تنظیم کرد.

directions optional
نوع: DirectionsResult optional
جهت نمایش روی نقشه و/یا در پانل <div> ، به عنوان یک شی DirectionsResult از DirectionsService بازیابی شده است.
draggable optional
نوع: boolean optional
اگر true ، به کاربر اجازه می دهد تا مسیرهای ارائه شده توسط این DirectionsRenderer را بکشد و تغییر دهد.
hideRouteList optional
نوع: boolean optional
پیش فرض: false
این ویژگی نشان می‌دهد که آیا رندر باید فهرستی از مسیرهای قابل انتخاب توسط کاربر ارائه دهد یا خیر.
infoWindow optional
نوع: InfoWindow optional
InfoWindow که در آن اطلاعات متنی هنگام کلیک روی یک نشانگر ارائه می شود. محتوای پنجره اطلاعات موجود بازنویسی می شود و موقعیت آن جابه جا می شود. اگر پنجره اطلاعاتی مشخص نشده باشد، DirectionsRenderer پنجره اطلاعات خود را ایجاد و استفاده می کند. اگر suppressInfoWindows روی true تنظیم شود، این ویژگی نادیده گرفته می شود.
map optional
نوع: Map optional
نقشه ای که روی آن جهت ها نمایش داده می شود.
markerOptions optional
نوع: MarkerOptions optional
گزینه هایی برای نشانگرها همه نشانگرهای ارائه شده توسط DirectionsRenderer از این گزینه ها استفاده خواهند کرد.
panel optional
نوع: HTMLElement optional
<div> که در آن مراحل جهت نمایش داده می شود.
polylineOptions optional
نوع: PolylineOptions optional
گزینه هایی برای پلی لاین ها همه چند خط ارائه شده توسط DirectionsRenderer از این گزینه ها استفاده خواهند کرد.
preserveViewport optional
نوع: boolean optional
پیش فرض: false
اگر این گزینه روی true تنظیم شده باشد یا مرکز و بزرگنمایی نقشه هرگز تنظیم نشده باشد، نقشه ورودی در مرکز قرار گرفته و به کادر محدود این مجموعه جهت ها بزرگنمایی می شود.
routeIndex optional
نوع: number optional
نمایه مسیر در شی DirectionsResult . مقدار پیش فرض 0 است.
suppressBicyclingLayer optional
نوع: boolean optional
هنگامی که جهت دوچرخه سواری درخواست می شود، رندر BicyclingLayer را متوقف کنید.
suppressInfoWindows optional
نوع: boolean optional
رندر کردن پنجره‌های اطلاعات را متوقف کنید.
suppressMarkers optional
نوع: boolean optional
نمایش نشانگرها را سرکوب کنید.
suppressPolylines optional
نوع: boolean optional
رندر چند خطوط را سرکوب کنید.

رابط DirectionsWaypoint

google.maps . DirectionsWaypoint رابط google.maps . DirectionsWaypoint

DirectionsWaypoint مکانی بین مبدا و مقصد را نشان می دهد که سفر باید از طریق آن انجام شود.

location optional
نوع: string| LatLng | LatLngLiteral | Place optional
موقعیت نقطه راه. می تواند یک رشته آدرس، یک LatLng یا یک Place باشد. اختیاری.
stopover optional
نوع: boolean optional
پیش فرض: true
اگر true ، نشان می دهد که این ایستگاه بین مبدا و مقصد است. این باعث می شود که مسیر به دو پایه تقسیم شود. اگر false ، نشان می دهد که مسیر برای عبور از این نقطه بین راهی باید جانبدارانه باشد، اما به دو پا تقسیم نشود. اگر بخواهید مسیری را در پاسخ به کشیدن نقاط بین راه توسط کاربر روی نقشه ایجاد کنید، مفید است.

رابط DirectionsGeocodedWaypoint

google.maps . DirectionsGeocodedWaypoint رابط google.maps . DirectionsGeocodedWaypoint

یک نقطه راه واحد ژئوکد شده.

partial_match optional
نوع: boolean optional
این که آیا geocoder تطابق دقیقی با نقطه اصلی اولیه نشان نداده است، اگرچه می‌توانست بخشی از آدرس درخواستی را مطابقت دهد.
place_id optional
نوع: string optional
شناسه مکان مرتبط با ایستگاه بین راه. شناسه‌های مکان به طور منحصربه‌فردی یک مکان را در پایگاه داده Google Places و در Google Maps شناسایی می‌کنند. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید.
types optional
نوع: Array <string> optional
آرایه ای از رشته ها که نوع عنصر جغرافیایی کدگذاری شده برگشتی را نشان می دهد. برای لیست رشته های احتمالی، به بخش Address Component Types در Developer's Guide مراجعه کنید.

رابط DirectionsRoute

google.maps . DirectionsRoute رابط google.maps . DirectionsRoute

یک مسیر واحد شامل مجموعه ای از پاها در یک DirectionsResult . توجه داشته باشید که اگرچه این شی "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا به طور مستقیم و غیرمستقیم شامل اشیاء LatLng می شود.

bounds
نوع: LatLngBounds
محدوده این مسیر
copyrights
نوع: string
متن حق چاپ برای این مسیر نمایش داده شود.
legs
نوع: Array < DirectionsLeg >
آرایه ای از DirectionsLeg که هر کدام حاوی اطلاعاتی در مورد مراحلی است که از آن تشکیل شده است. برای هر نقطه توقف یا مقصد مشخص شده یک پا وجود خواهد داشت. بنابراین مسیری که هیچ ایستگاه توقفی نداشته باشد دارای یک DirectionsLeg و مسیری با یک ایستگاه توقف شامل دو مسیر است.
overview_path
نوع: Array < LatLng >
آرایه ای از LatLng که کل مسیر این مسیر را نشان می دهد. مسیر به منظور مناسب ساختن آن در زمینه‌هایی که تعداد کمی از رئوس مورد نیاز است (مانند URLهای API Static Maps) ساده شده است.
overview_polyline
نوع: string
یک نمایش چند خطی کدگذاری شده از مسیر در overview_path. این چند خط یک مسیر تقریبی (هموار) جهت های حاصل است.
summary
نوع: string
حاوی توضیحات متنی کوتاهی برای مسیر است که برای نام‌گذاری و ابهام‌زدایی مسیر از گزینه‌های جایگزین مناسب است.
warnings
نوع: Array <string>
هشدارهایی که باید هنگام نمایش این جهت ها نمایش داده شوند.
waypoint_order
نوع: Array <number>
اگر optimizeWaypoints روی true تنظیم شده باشد، این فیلد حاوی جایگشت مجدد مرتب شده نقاط بین ورودی ورودی خواهد بود. به عنوان مثال، اگر ورودی این بود:
منبع: لس آنجلس
نقاط راه: دالاس، بانگور، فینیکس
مقصد: نیویورک
و خروجی بهینه شده به صورت زیر ترتیب داده شد:
منبع: لس آنجلس
نقاط راه: فینیکس، دالاس، بانگور
مقصد: نیویورک
سپس این فیلد یک Array حاوی مقادیر [2، 0، 1] خواهد بود. توجه داشته باشید که شماره گذاری نقاط بین راه بر اساس صفر است.
اگر هر یک از ایستگاه‌های ورودی، stopover روی false تنظیم کرده باشد، این فیلد خالی خواهد بود، زیرا بهینه‌سازی مسیر برای چنین پرسش‌هایی در دسترس نیست.
fare optional
نوع: TransitFare optional
کل کرایه کل سفر ترانزیت. فقط برای درخواست های حمل و نقل قابل اجرا است.

رابط DirectionsLeg

google.maps . DirectionsLeg رابط google.maps . DirectionsLeg

یک پایه متشکل از مجموعه ای از مراحل در یک DirectionsResult . ممکن است برخی از فیلدهای پا برای همه درخواست‌ها برگردانده نشوند. توجه داشته باشید که اگرچه این نتیجه "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا به طور مستقیم و غیرمستقیم شامل اشیاء LatLng می شود.

end_address
نوع: string
آدرس مقصد این پا. این محتوا باید همانطور که هست خوانده شود. آدرس فرمت شده را به صورت برنامه نویسی تجزیه نکنید.
end_location
نوع: LatLng
DirectionsService مسیرهای بین مکان ها را با استفاده از نزدیکترین گزینه حمل و نقل (معمولاً یک جاده) در مکان های شروع و پایان محاسبه می کند. end_location مقصد واقعی جغرافیایی کد شده را نشان می دهد، که ممکن است با end_location آخرین مرحله متفاوت باشد، برای مثال اگر جاده نزدیک به مقصد این پا نباشد.
start_address
نوع: string
آدرس مبدا این پا. این محتوا باید همانطور که هست خوانده شود. آدرس فرمت شده را به صورت برنامه نویسی تجزیه نکنید.
start_location
نوع: LatLng
DirectionsService مسیرهای بین مکان ها را با استفاده از نزدیکترین گزینه حمل و نقل (معمولاً یک جاده) در مکان های شروع و پایان محاسبه می کند. start_location مبدأ واقعی جغرافیایی کد شده را نشان می دهد، که ممکن است با start_location مرحله اول متفاوت باشد، برای مثال اگر جاده نزدیک مبدا این پا نباشد.
steps
نوع: Array < DirectionsStep >
آرایه ای از DirectionsStep s که هر کدام حاوی اطلاعاتی در مورد مراحل جداگانه در این پا هستند.
traffic_speed_entry
نوع: Array <?>
اطلاعات در مورد سرعت ترافیک در طول پا.
via_waypoints
نوع: Array < LatLng >
آرایه ای از ایستگاه های بین راه بدون توقف در امتداد این پا، که در درخواست اصلی مشخص شده اند.

در مسیرهای جایگزین منسوخ شده است . نسخه 3.27 آخرین نسخه API خواهد بود که via_waypoints اضافی را در مسیرهای جایگزین اضافه می کند.

هنگام استفاده از سرویس Directions برای اجرای مسیرهای قابل کشیدن، توصیه می شود کشیدن مسیرهای جایگزین را غیرفعال کنید. فقط مسیر اصلی باید قابل کشیدن باشد. کاربران می توانند مسیر اصلی را تا زمانی که با یک مسیر جایگزین مطابقت داشته باشد بکشند.

arrival_time optional
نوع: Time optional
زمان تخمینی رسیدن برای این پا. فقط برای درخواست های TRANSIT قابل اجرا است.
departure_time optional
نوع: Time optional
زمان تخمینی حرکت برای این پا. فقط برای درخواست های TRANSIT قابل اجرا است.
distance optional
نوع: Distance optional
کل مسافت طی شده توسط این پا. این ویژگی ممکن است تعریف نشده باشد زیرا ممکن است فاصله ناشناخته باشد.
duration optional
نوع: Duration optional
کل مدت این پا. این ویژگی ممکن است undefined باشد زیرا ممکن است مدت زمان آن ناشناخته باشد.
duration_in_traffic optional
نوع: Duration optional
مجموع مدت این مرحله، با در نظر گرفتن شرایط ترافیکی که توسط ویژگی trafficModel نشان داده شده است. این ویژگی ممکن است undefined باشد زیرا ممکن است مدت زمان آن ناشناخته باشد.

رابط DirectionsStep

google.maps . DirectionsStep رابط google.maps . DirectionsStep

یک DirectionsStep در یک DirectionsResult . ممکن است برخی از فیلدها undefined باشند. توجه داشته باشید که اگرچه این شی "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا مستقیماً شامل اشیاء LatLng است.

encoded_lat_lngs
نوع: string
یک نمایش چند خطی کدگذاری شده از مرحله. این یک مسیر تقریبی (هموار) پله است.
end_location
نوع: LatLng
محل پایان این مرحله.
end_point
نوع: LatLng
محل پایان این مرحله.
instructions
نوع: string
دستورالعمل این مرحله
lat_lngs
نوع: Array < LatLng >
دنباله ای از LatLng که سیر این مرحله را توصیف می کند. این یک مسیر تقریبی (هموار) پله است.
maneuver
نوع: string
شامل اقداماتی است که باید برای مرحله فعلی انجام دهید ( turn-left ، merge ، straight ، و غیره). مقادیر قابل تغییر هستند و ممکن است مقادیر جدید بدون اطلاع قبلی معرفی شوند.
path
نوع: Array < LatLng >
دنباله ای از LatLng که سیر این مرحله را توصیف می کند. این یک مسیر تقریبی (هموار) پله است.
start_location
نوع: LatLng
محل شروع این مرحله.
start_point
نوع: LatLng
محل شروع این مرحله.
travel_mode
نوع: TravelMode
حالت سفر مورد استفاده در این مرحله.
distance optional
نوع: Distance optional
مسافت طی شده توسط این مرحله. این ویژگی ممکن است undefined باشد زیرا ممکن است فاصله ناشناخته باشد.
duration optional
نوع: Duration optional
زمان معمولی مورد نیاز برای انجام این مرحله در ثانیه و به صورت متن. این ویژگی ممکن است undefined باشد زیرا ممکن است مدت زمان آن ناشناخته باشد.
polyline optional
نوع: DirectionsPolyline optional
شامل یک شی با یک ویژگی منفرد، 'نقاط' است که یک نمایش چندخطی کدگذاری شده از مرحله را در خود دارد. این چند خط یک مسیر تقریبی (هموار) پله است.
steps optional
نوع: Array < DirectionsStep > optional
مراحل فرعی این مرحله برای بخش های غیر ترانزیت مسیرهای ترانزیتی مشخص شده است.
transit optional
نوع: TransitDetails optional
جزئیات ویژه حمل و نقل در مورد این مرحله. این ویژگی تعریف نشده خواهد بود مگر اینکه حالت سفر این مرحله TRANSIT باشد.
transit_details optional
نوع: TransitDetails optional
جزئیات مربوط به این مرحله اگر حالت سفر TRANSIT باشد.

رابط DirectionsPolyline

google.maps . DirectionsPolyline رابط google.maps . DirectionsPolyline

یک شی حاوی یک ویژگی points برای توصیف چند خط یک DirectionsStep .

points
نوع: string
یک چند خط کدگذاری شده

رابط مکان

google.maps . Place رابط google.maps . Place

حاوی اطلاعات مورد نیاز برای مکان یابی، شناسایی یا توصیف مکانی برای DirectionsRequest یا DistanceMatrixRequest است. در این زمینه، "مکان" به معنای یک تجارت، نقطه مورد علاقه یا موقعیت جغرافیایی است. برای واکشی اطلاعات درباره یک مکان، PlacesService را ببینید.

location optional
نوع: LatLng | LatLngLiteral optional
LatLng موجودیت توصیف شده توسط این مکان.
placeId optional
نوع: string optional
شناسه مکان مکان (مانند کسب و کار یا نقطه مورد علاقه). شناسه مکان یک شناسه منحصر به فرد یک مکان در پایگاه داده Google Maps است. توجه داشته باشید که placeId دقیق ترین راه برای شناسایی مکان است. در صورت امکان، باید placeId به جای query مشخص کنید. شناسه مکان را می توان از هر درخواستی به Places API بازیابی کرد، مانند TextSearch . شناسه‌های مکان همچنین می‌توانند از درخواست‌های API Geocoding بازیابی شوند. برای اطلاعات بیشتر، به نمای کلی شناسه‌های مکان مراجعه کنید.
query optional
نوع: string optional
عبارت جستجویی که مکان را توصیف می کند (مانند یک تجارت یا نقطه مورد علاقه). یک پرس و جو به عنوان مثال «اسکله، سطح بالا، ترمینال مسافربری خارج از کشور 5 جاده هیکسون، راکس NSW» است. در صورت امکان، باید placeId به جای query مشخص کنید. API دقت حل رشته پرس و جو را در یک مکان تضمین نمی کند. اگر هم placeId و هم query ارائه شود، خطایی رخ می دهد.

ثابت های TravelMode

google.maps . TravelMode ثابت های google.maps . TravelMode

حالت‌های سفر معتبری که می‌توانند در DirectionsRequest مشخص شوند و همچنین حالت‌های سفر بازگردانده شده در DirectionsStep . اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. به عنوان مثال، 'BICYCLING' یا google.maps.TravelMode.BICYCLING .

با فراخوانی const {TravelMode} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

BICYCLING یک درخواست جهت دوچرخه سواری را مشخص می کند.
DRIVING یک درخواست مسیرهای رانندگی را مشخص می کند.
TRANSIT یک درخواست مسیرهای حمل و نقل را مشخص می کند.
WALKING یک درخواست مسیرهای پیاده روی را مشخص می کند.

رابط DrivingOptions

google.maps . DrivingOptions رابط google.maps . DrivingOptions

هنگام تنظیم حالت سفر روی DRIVING DirectionsRequest را پیکربندی می کند.

departureTime
نوع: Date
زمان حرکت مورد نظر برای مسیر که به عنوان شیء Date مشخص شده است. شیء Date زمان را از 1 ژانویه 1970 بر حسب میلی ثانیه اندازه گیری می کند. این باید برای معتبر بودن DrivingOptions مشخص شود. زمان حرکت باید روی زمان فعلی یا زمانی در آینده تنظیم شود. نمی تواند در گذشته باشد.
trafficModel optional
نوع: TrafficModel optional
فرض ترجیحی برای پیش‌بینی مدت زمان در ترافیک. پیش فرض BEST_GUESS است.

ثابت های TrafficModel

google.maps . TrafficModel ثابت های google.maps . TrafficModel

مفروضاتی که هنگام پیش بینی مدت زمان در ترافیک استفاده می شود. به عنوان بخشی از DirectionsRequest یا DistanceMatrixRequest مشخص شده است. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'bestguess' یا google.maps.TrafficModel.BEST_GUESS .

با فراخوانی const {TrafficModel} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

BEST_GUESS از داده های ترافیک تاریخی برای تخمین بهتر زمان صرف شده در ترافیک استفاده کنید.
OPTIMISTIC از داده های ترافیکی تاریخی برای تخمین خوش بینانه از مدت زمان در ترافیک استفاده کنید.
PESSIMISTIC از داده های ترافیکی تاریخی برای تخمین بدبینانه از مدت زمان در ترافیک استفاده کنید.

رابط TransitOptions

google.maps . TransitOptions رابط google.maps . TransitOptions

هنگامی که حالت سفر روی TRANSIT تنظیم می شود، شی TransitOptions در یک DirectionsRequest گنجانده می شود.

arrivalTime optional
نوع: Date optional
زمان رسیدن دلخواه برای مسیر که به عنوان شیء Date مشخص شده است. شی Date از 1 ژانویه 1970 زمان را بر حسب میلی ثانیه اندازه گیری می کند. اگر زمان رسیدن مشخص شده باشد، زمان خروج نادیده گرفته می شود.
departureTime optional
نوع: Date optional
زمان حرکت مورد نظر برای مسیر که به عنوان شیء Date مشخص شده است. شی Date زمان را از 1 ژانویه 1970 بر حسب میلی ثانیه اندازه گیری می کند. اگر نه زمان حرکت و نه زمان رسیدن مشخص نشده باشد، زمان "اکنون" در نظر گرفته می شود.
modes optional
نوع: Array < TransitMode > optional
یک یا چند حالت ترجیحی ترانزیت، مانند اتوبوس یا قطار. اگر هیچ اولویتی داده نشود، API بهترین مسیر پیش‌فرض را برمی‌گرداند.
routingPreference optional
نوع: TransitRoutePreference optional
ترجیحی که می تواند در انتخاب مسیر حمل و نقل مانند پیاده روی کمتر تعصب داشته باشد. اگر هیچ اولویتی داده نشود، API بهترین مسیر پیش‌فرض را برمی‌گرداند.

ثابت های TransitMode

google.maps . TransitMode ثابت های google.maps . TransitMode

حالت حمل و نقل معتبر به عنوان مثال اتوبوسی که می تواند در یک TransitOptions مشخص شود. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'BUS' یا google.maps.TransitMode.BUS .

با فراخوانی const {TransitMode} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

BUS اتوبوس را به عنوان حالت ترجیحی ترانزیت مشخص می کند.
RAIL راه آهن را به عنوان روش ترجیحی ترانزیت مشخص می کند.
SUBWAY مترو را به عنوان حالت ترجیحی ترانزیت مشخص می کند.
TRAIN قطار را به عنوان حالت ترجیحی ترانزیت مشخص می کند.
TRAM تراموا را به عنوان حالت ترجیحی ترانزیت مشخص می کند.

ثابت های TransitRoutePreference

google.maps . TransitRoutePreference ثابت های google.maps . TransitRoutePreference

نوع مسیر حمل و نقل معتبری که می تواند در یک TransitOptions مشخص شود. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'LESS_WALKING' یا google.maps.TransitRoutePreference.LESS_WALKING .

با فراخوانی const {TransitRoutePreference} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

FEWER_TRANSFERS مشخص می کند که مسیر محاسبه شده باید تعداد محدودی انتقال را ترجیح دهد.
LESS_WALKING مشخص می کند که مسیر محاسبه شده باید مقادیر محدودی از پیاده روی را ترجیح دهد.

رابط TransitFare

google.maps . TransitFare رابط google.maps . TransitFare

کرایه یک DirectionsRoute متشکل از ارزش و ارز.

currency
نوع: string
کد ارز ISO 4217 که نشان دهنده ارزی است که کرایه با آن بیان می شود.
value
نوع: number
ارزش عددی کرایه، بیان شده در currency داده شده.

رابط TransitDetails

google.maps . TransitDetails رابط google.maps . TransitDetails

جزئیات مربوط به خروج، ورود و نحوه حمل و نقل مورد استفاده در این مرحله.

arrival_stop
نوع: TransitStop
توقف ورود این مرحله ترانزیت.
arrival_time
نوع: Time
زمان رسیدن این مرحله، به عنوان یک شی Time مشخص شده است.
departure_stop
نوع: TransitStop
توقف حرکت این مرحله ترانزیت.
departure_time
نوع: Time
زمان خروج از این مرحله، به عنوان یک شی Time مشخص شده است.
headsign
نوع: string
جهت حرکت در این خط، همانطور که روی وسیله نقلیه یا در ایستگاه خروج مشخص شده است.
headway
نوع: number
تعداد ثانیه های مورد انتظار بین وسایل نقلیه معادل در این توقف.
line
نوع: TransitLine
جزئیات در مورد خط حمل و نقل مورد استفاده در این مرحله.
num_stops
نوع: number
تعداد توقف در این مرحله. شامل توقف ورود، اما نه توقف خروج.
trip_short_name
نوع: string
متنی که در برنامه ها و تابلوهای علامت برای شناسایی یک سفر ترانزیت به مسافران ظاهر می شود، به عنوان مثال، برای شناسایی شماره قطار برای سفرهای ریلی شهری. متن به طور منحصربه‌فرد یک سفر را در یک روز خدماتی مشخص می‌کند.

رابط TransitStop

google.maps . TransitStop رابط google.maps . TransitStop

جزئیات در مورد یک ایستگاه حمل و نقل یا ایستگاه.

location
نوع: LatLng
محل این توقف.
name
نوع: string
نام این ایستگاه ترانزیت.

رابط TransitLine

google.maps . TransitLine رابط google.maps . TransitLine

اطلاعات مربوط به خط ترانزیت که این مرحله حمل و نقل را اجرا می کند.

agencies
نوع: Array < TransitAgency >
آژانس ترانزیت که این خط ترانزیتی را اداره می کند.
color
نوع: string
رنگی که معمولاً در تابلوهای این خط ترانزیت استفاده می‌شود، که به صورت یک رشته شش گوش نشان داده می‌شود.
icon
نوع: string
نشانی اینترنتی نماد مرتبط با این خط.
name
نوع: string
نام کامل این خط ترانزیت، به عنوان مثال "8 Avenue Local".
short_name
نوع: string
نام کوتاه این خط ترانزیت، به عنوان مثال "E".
text_color
نوع: string
رنگ متنی که معمولاً در تابلوهای این خط ترانزیت استفاده می‌شود، که به صورت یک رشته هگزا نشان داده می‌شود.
url
نوع: string
نشانی اینترنتی آژانس که مختص این خط حمل و نقل است.
vehicle
نوع وسیله نقلیه مورد استفاده، به عنوان مثال قطار یا اتوبوس.

رابط TransitAgency

google.maps . TransitAgency رابط google.maps . TransitAgency

اطلاعات در مورد آژانسی که یک خط ترانزیت را اداره می کند.

name
نوع: string
نام این آژانس حمل و نقل.
phone
نوع: string
شماره تلفن آژانس حمل و نقل
url
نوع: string
نشانی اینترنتی آژانس حمل و نقل.

رابط TransitVehicle

google.maps . TransitVehicle رابط google.maps . TransitVehicle

اطلاعات در مورد وسیله نقلیه ای که در یک خط حمل و نقل کار می کند.

icon
نوع: string
URL برای نمادی که با نوع وسیله نقلیه استفاده شده در این خط مطابقت دارد.
local_icon
نوع: string
نشانی وب برای نمادی که به جای نماد عمومی تر، با نوع وسیله نقلیه استفاده شده در این منطقه مطابقت دارد.
name
نوع: string
نامی برای این نوع از وسایل نقلیه ترانزیت، به عنوان مثال "قطار" یا "اتوبوس".
type
نوع: VehicleType
نوع وسیله نقلیه مورد استفاده، به عنوان مثال قطار، اتوبوس یا کشتی.

ثابت های نوع وسیله نقلیه

google.maps . VehicleType ثابت های google.maps . VehicleType

مقادیر ممکن برای انواع خودرو

با فراخوانی const {VehicleType} = await google.maps.importLibrary("routes") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

BUS اتوبوس.
CABLE_CAR وسیله نقلیه ای که روی کابل، معمولاً روی زمین کار می کند. تله کابین های هوایی ممکن است از نوع GONDOLA_LIFT باشند.
COMMUTER_TRAIN راه آهن شهری.
FERRY فری
FUNICULAR وسیله نقلیه ای که توسط کابل از شیب تند بالا کشیده می شود.
GONDOLA_LIFT یک تله کابین هوایی.
HEAVY_RAIL ریل سنگین
HIGH_SPEED_TRAIN قطار سریع السیر.
INTERCITY_BUS اتوبوس بین شهری.
METRO_RAIL راه آهن سبک.
MONORAIL مونوریل.
OTHER سایر وسایل نقلیه
RAIL ریل.
SHARE_TAXI تاکسی اشتراکی نوعی حمل‌ونقل اتوبوسی با قابلیت پیاده‌کردن و سوار کردن مسافران در هر نقطه از مسیر است. به طور کلی تاکسی مشترک از وسایل نقلیه مینی بوس استفاده می کند.
SUBWAY راه آهن زیرزمینی.
TRAM ریل نوری روی زمین.
TROLLEYBUS واگن برقی.

ثابت های سیستم واحد

google.maps . UnitSystem ثابت های google.maps . UnitSystem

سیستم های واحد معتبری که می توانند در DirectionsRequest مشخص شوند.

با فراخوانی const {UnitSystem} = await google.maps.importLibrary("core") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

IMPERIAL مشخص می کند که فواصل در DirectionsResult باید در واحدهای امپراتوری بیان شود.
METRIC مشخص می کند که فواصل در DirectionsResult باید در واحدهای متریک بیان شود.

رابط فاصله

google.maps . Distance رابط google.maps . Distance

نمایش فاصله به عنوان یک مقدار عددی و یک رشته نمایشگر.

text
نوع: string
نمایش رشته ای از مقدار فاصله، با استفاده از UnitSystem مشخص شده در درخواست.
value
نوع: number
فاصله بر حسب متر

رابط مدت زمان

google.maps . Duration رابط google.maps . Duration

نمایش مدت زمان به عنوان یک مقدار عددی و یک رشته نمایشگر.

text
نوع: string
نمایش رشته ای از مقدار مدت زمان.
value
نوع: number
مدت زمان بر حسب ثانیه

رابط زمان

google.maps . Time رابط google.maps . Time

نمایش زمان به عنوان یک شیء Date، یک رشته محلی، و یک منطقه زمانی.

text
نوع: string
رشته ای که نشان دهنده مقدار زمان است. زمان در منطقه زمانی ایستگاه حمل و نقل نمایش داده می شود.
time_zone
نوع: string
منطقه زمانی که این توقف در آن قرار دارد. مقدار، نام منطقه زمانی است که در پایگاه داده منطقه زمانی IANA تعریف شده است، به عنوان مثال "America/New_York".
value
نوع: Date
زمان این خروج یا ورود، به عنوان یک شیء تاریخ جاوا اسکریپت مشخص شده است.

ثابت های DirectionsTravelMode

google.maps . DirectionsTravelMode ثابت های google.maps . DirectionsTravelMode

DirectionsUnit ثابتهای سیستم

google.maps . DirectionsUnitSystem ثابتهای سیستم