کلاس مسیر
google.maps.routes . Route
کلاس google.maps.routes . Route
شامل یک مسیر است که شامل یک سری از بخش های جاده متصل است که به ایستگاه های ابتدایی، انتهایی و میانی می پیوندند.
با فراخوانی const {Route} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
روش های استاتیک | |
---|---|
computeRoutes | computeRoutes(request) پارامترها:
مقدار بازگشتی: Promise <{ با توجه به مجموعه ای از ایستگاه های پایانه و میانی، مسیر اصلی را به همراه مسیرهای جایگزین اختیاری برمی گرداند. توجه: این روش مستلزم آن است که با تنظیم ویژگی ComputeRoutesRequest.fields ، یک ماسک فیلد پاسخ را در درخواست مشخص کنید. مقدار فهرستی از مسیرهای فیلد است.به عنوان مثال:
استفاده از fields: ['*'] ممنوع است زیرا:
|
خواص | |
---|---|
description | نوع: string optional شرح مسیر. |
distanceMeters | نوع: number optional مسافت طی مسیر، بر حسب متر. |
durationMillis | نوع: number optional مدت زمان لازم برای پیمایش مسیر بر حسب میلی ثانیه. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار همان Route.staticDurationMillis است. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است. |
legs | مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو ایستگاه غیر via است.به عنوان مثال:
origin تا intermediates تا destination مطابقت دارد. |
localizedValues | نوع: RouteLocalizedValues optional نمایش متنی ویژگی های Route . |
optimizedIntermediateWaypointIndices | نوع: Array <number> optional اگر ComputeRoutesRequest.optimizeWaypointOrder را روی true تنظیم کنید، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. شاخص با 0 برای اولین نقطه میانی ارائه شده در ورودی شروع می شود.به عنوان مثال، اگر یک ورودی از:
[2, 0, 1] خواهد بود. |
path | نوع: Array < LatLngAltitude > optional لیست LatLngAltitude s مسیر که می توان از آن برای رسم چند خط مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد. |
polylineDetails | نوع: PolylineDetails optional حاوی اطلاعاتی در مورد جزئیات در طول مسیر است. |
routeLabels | نوع: Array < RouteLabel > optional برچسبهایی برای مسیر که برای شناسایی ویژگیهای خاص برای مقایسه با دیگران مفید هستند. |
routeToken | نوع: string optional یک نشانه مات که می تواند به Navigation SDK منتقل شود تا مسیر را در حین ناوبری بازسازی کند و در صورت تغییر مسیر، به هدف اصلی هنگام ایجاد مسیر احترام بگذارد. با این نشانه به عنوان یک لکه مات رفتار کنید. مقدار آن را در بین درخواستها مقایسه نکنید زیرا ممکن است ارزش آن تغییر کند حتی اگر سرویس دقیقاً همان مسیر را برگرداند. توجه: routeToken فقط برای درخواست هایی در دسترس است که ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده اند. برای درخواست هایی که via ایستگاه های بین راه هستند پشتیبانی نمی شود. |
speedPaths | گروه بندی بخش های مسیر با سرعت خوانی متناظر آنها. برای پر شدن این فیلد، ComputeRoutesRequest.routingPreference باید روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL و ComputeRoutesRequest.extraComputations باید شامل TRAFFIC_ON_POLYLINE باشد. |
staticDurationMillis | نوع: number optional مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی. توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است. |
travelAdvisory | نوع: RouteTravelAdvisory optional اطلاعات تکمیلی در مورد مسیر. |
viewport | نوع: LatLngBounds optional کادر محدود کننده نما در مسیر. |
warnings | نوع: Array <string> optional مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر. |
روش ها | |
---|---|
createPolylines | createPolylines([options]) پارامترها:
بر اساس داده های موجود چند خط برای مسیر ایجاد می کند. چند خط چند وجهی:
چند خط ترافیک:
چند خط کلی:
|
createWaypointAdvancedMarkers | createWaypointAdvancedMarkers([options]) پارامترها:
مقدار بازگشتی: Promise < Array < AdvancedMarkerElement >> نشانگرهایی را برای مسیر با برچسب "A"، "B"، "C" و غیره برای هر نقطه راه ایجاد می کند. نشانگرها استایل پیشفرض اعمال شدهاند. گزینه ها را می توان برای تغییر سبک نشانگر بر اساس شاخص نشانگر یا ویژگی های RouteLeg مربوطه ارسال کرد. اگر مسیر فاقد پا باشد، پارامتر WaypointMarkerDetails.leg تعریف نشده است.فیلد "legs" باید در ComputeRoutesRequest.fields درخواست شود تا نقاط بین راه درج شود. |
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
رابط ComputeRoutesRequest
google.maps.routes . ComputeRoutesRequest
رابط google.maps.routes . ComputeRoutesRequest
درخواست مسیرها
خواص | |
---|---|
destination | نوع: string| LatLng | LatLngLiteral | LatLngAltitudeLiteral | DirectionalLocationLiteral | Place | Waypoint مقصد مسیر. مقداری که به عنوان رشته ارسال می شود ممکن است آدرس، کد به اضافه یا نام منبع مکان باشد. مقادیر ارتفاع برای مسیرهای محاسباتی در نظر گرفته نمی شود. |
fields | نوع: Iterable <string> مجموعه فیلدهایی که باید واکشی شوند. برای همه فیلدها ["*"] را مشخص کنید. |
origin | نوع: string| LatLng | LatLngLiteral | LatLngAltitudeLiteral | DirectionalLocationLiteral | Place | Waypoint مبدا مسیر. مقداری که به عنوان رشته ارسال می شود ممکن است یک آدرس، کد به اضافه یا نام منبع مکان باشد. مقادیر ارتفاع برای مسیرهای محاسباتی در نظر گرفته نمی شود. |
arrivalTime optional | نوع: Date optional زمان رسیدن. توجه: فقط زمانی قابل تنظیم است که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. می توانید ComputeRoutesRequest.departureTime یا ComputeRoutesRequest.arrivalTime را مشخص کنید، اما نه هر دو را. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند. |
computeAlternativeRoutes optional | نوع: boolean optional تعیین می کند که آیا مسیرهای جایگزین علاوه بر مسیر محاسبه شود یا خیر. هیچ مسیر جایگزینی برای درخواست هایی که دارای ایستگاه های بین راهی هستند بازگردانده نمی شود. |
departureTime optional | نوع: Date optional زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیشفرض روی زمانی است که درخواست را انجام دادهاید. توجه: شما فقط می توانید زمانی را در گذشته مشخص کنید که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند. |
extraComputations optional | نوع: Iterable < ComputeRoutesExtraComputation > optional فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند. این فیلدهای اضافی نیز باید در ComputeRoutesRequest.fields مشخص شوند تا در پاسخ بازگردانده شوند. |
intermediates optional | مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود. |
language optional | نوع: string optional کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، زبان از محل مبدأ استنباط می شود. |
optimizeWaypointOrder optional | نوع: boolean optional اگر روی true تنظیم شود، سرویس تلاش می کند تا هزینه کلی مسیر را با مرتب کردن مجدد ایستگاه های بین راهی مشخص شده به حداقل برساند. در صورتی که هر یک از ایستگاه های بین راهی یک ایستگاه بین راهی باشد، درخواست با شکست مواجه می شود. از Route.optimizedIntermediateWaypointIndices در پاسخ برای یافتن سفارش جدید استفاده کنید. اگر "optimizedIntermediateWaypointIndices" در ComputeRoutesRequest.fields درخواست نشود، درخواست با شکست مواجه می شود. اگر روی false تنظیم شود، Route.optimizedIntermediateWaypointIndices در پاسخ خالی خواهد بود. |
polylineQuality optional | نوع: PolylineQuality optional اولویت را برای کیفیت پلی لاین مشخص می کند. |
region optional | نوع: string optional کد منطقه که به عنوان یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، منطقه از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، منطقه از محل مبدا استنباط می شود. |
requestedReferenceRoutes optional | نوع: Iterable < ReferenceRoute > optional مشخص می کند چه مسیرهای مرجعی علاوه بر مسیر پیش فرض به عنوان بخشی از درخواست محاسبه شود. مسیر مرجع مسیری با هدف محاسبه مسیر متفاوت از مسیر پیشفرض است. برای مثال یک محاسبه مسیر مرجع FUEL_EFFICIENT پارامترهای مختلفی را در نظر می گیرد که یک مسیر کارآمد سوخت بهینه ایجاد می کند. هنگام استفاده از این ویژگی، به دنبال Route.routeLabels در مسیرهای حاصل بگردید. |
routeModifiers optional | نوع: RouteModifiers optional مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد. برای مثال میتوانید ویژگیهایی را برای اجتناب از آنها مشخص کنید، مانند جادههای عوارضی یا بزرگراهها. |
routingPreference optional | نوع: RoutingPreference optional نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که ComputeRoutesRequest.travelMode DRIVING یا TWO_WHEELER باشد، در غیر این صورت درخواست با شکست مواجه می شود. |
trafficModel optional | نوع: TrafficModel optional مفروضاتی را برای محاسبه زمان در ترافیک مشخص می کند. این تنظیم بر مقدار Route.durationMillis و RouteLeg.durationMillis تأثیر میگذارد که بر اساس میانگینهای تاریخی، زمان پیشبینیشده در ترافیک را شامل میشوند. ComputeRoutesRequest.trafficModel فقط برای درخواست هایی در دسترس است که ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE_OPTIMAL و ComputeRoutesRequest.travelMode را روی DRIVING تنظیم کرده اند. پیشفرض BEST_GUESS است. |
transitPreference optional | نوع: TransitPreference optional تنظیمات برگزیده را مشخص می کند که بر مسیر برگشتی برای مسیرهای TRANSIT تأثیر می گذارد.توجه: فقط زمانی می توان آن را مشخص کرد که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. |
travelMode optional | نوع: TravelMode optional نحوه حمل و نقل را مشخص می کند. |
units optional | نوع: UnitSystem optional واحدهای اندازه گیری را برای فیلدهای نمایشی، مانند دستورالعمل های پیمایش، مشخص می کند. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل مبدا استنتاج می شوند. |
ثابت های ComputeRoutesExtraComputation
google.maps.routes . ComputeRoutesExtraComputation
ثابت های google.maps.routes . ComputeRoutesExtraComputation
محاسبات اضافی برای انجام درخواست Route.computeRoutes
.
با فراخوانی const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
FLYOVER_INFO_ON_POLYLINE | اطلاعات پرواز برای مسیر(های) قسمت "polylineDetails" باید در ComputeRoutesRequest.fields مشخص شود تا این اطلاعات برگردد. این داده ها در حال حاضر فقط برای متروهای خاصی در هند پر می شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند. |
FUEL_CONSUMPTION | مصرف سوخت تخمینی برای مسیر(های) |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS | دستورالعمل های پیمایش به عنوان یک رشته متن فرمت شده HTML ارائه شده است. این محتوا باید همانطور که هست خوانده شود و فقط برای نمایش است. به صورت برنامه نویسی آن را تجزیه نکنید. |
NARROW_ROAD_INFO_ON_POLYLINE | اطلاعات جاده باریک برای مسیر(ها). قسمت "polylineDetails" باید در ComputeRoutesRequest.fields مشخص شود تا این اطلاعات برگردد. این داده ها در حال حاضر فقط برای متروهای خاصی در هند پر می شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند. |
TOLLS | اطلاعات عوارض برای مسیر(های) |
TRAFFIC_ON_POLYLINE | چند خط آگاه از ترافیک برای مسیر(های) |
رابط DirectionalLocationLiteral
google.maps.routes . DirectionalLocationLiteral
رابط google.maps.routes . DirectionalLocationLiteral
بهعنوان سهولت، لفظهای شی به جای نمونههای DirectionalLocation
پذیرفته میشوند. هنگامی که Maps JS API با آنها برخورد می کند، به DirectionalLocation
تبدیل می شوند.
این رابط LatLngAltitudeLiteral
را گسترش می دهد.
خواص | |
---|---|
heading optional | نوع: number optional عنوان قطب نما با جهت جریان ترافیک مرتبط است. مقادیر سرفصل می توانند اعدادی از 0 تا 360 باشند، که در آن 0 سرفصل شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این فیلد فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode استفاده کنید. |
موروثی: altitude ، lat ، lng |
کلاس DirectionalLocation
google.maps.routes . DirectionalLocation
کلاس google.maps.routes . DirectionalLocation
یک نقطه جغرافیایی و یک عنوان اختیاری را در بر می گیرد.
این کلاس LatLngAltitude
را گسترش می دهد.
این کلاس DirectionalLocationLiteral
را پیاده سازی می کند.
با فراخوانی const {DirectionalLocation} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
سازنده | |
---|---|
ارثی: LatLngAltitude |
خواص | |
---|---|
heading | نوع: number optional عنوان قطب نما با جهت جریان ترافیک مرتبط است. مقادیر سرفصل می توانند اعدادی از 0 تا 360 باشند، که در آن 0 سرفصل شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این فیلد فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode استفاده کنید. |
موروثی: altitude ، lat ، lng |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار برگشتی: DirectionalLocationLiteral به یک شی تبدیل می شود. |
موروثی: equals |
کلاس FallbackInfo
google.maps.routes . FallbackInfo
کلاس google.maps.routes . FallbackInfo
اطلاعات مربوط به چگونگی و چرایی استفاده از یک نتیجه بازگشتی در پاسخ Route.computeRoutes
. اگر این فیلد تنظیم شده باشد، به این معنی است که سرور از یک حالت مسیریابی متفاوت از حالت دلخواه شما به عنوان بازگشت استفاده کرده است.
با فراخوانی const {FallbackInfo} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
reason | نوع: FallbackReason optional دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود. |
routingMode | نوع: FallbackRoutingMode optional حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد. |
ثابت های FallbackReason
google.maps.routes . FallbackReason
ثابت های google.maps.routes . FallbackReason
دلیل اینکه یک پاسخ بازگشتی در یک پاسخ Route.computeRoutes
برگردانده شد.
با فراخوانی const {FallbackReason} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
LATENCY_EXCEEDED | ما نتوانستیم محاسبه را با حالت مسیریابی دلخواه شما به موقع به پایان برسانیم، اما توانستیم یک نتیجه محاسبه شده توسط یک حالت جایگزین را برگردانیم. |
SERVER_ERROR | هنگام محاسبه مسیرها با حالت مسیریابی دلخواه شما، یک خطای سرور رخ داد، اما ما توانستیم نتیجه محاسبهشده با حالت جایگزین را برگردانیم. |
ثابت های FallbackRoutingMode
google.maps.routes . FallbackRoutingMode
ثابت های google.maps.routes . FallbackRoutingMode
حالت مسیریابی واقعی که وقتی یک پاسخ بازگشتی در یک پاسخ Route.computeRoutes
برگردانده می شود استفاده می شود.
با فراخوانی const {FallbackRoutingMode} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
TRAFFIC_AWARE | نشان می دهد که TRAFFIC_AWARE RoutingPreference برای محاسبه پاسخ استفاده شده است. |
TRAFFIC_UNAWARE | نشان می دهد که از TRAFFIC_UNAWARE RoutingPreference برای محاسبه پاسخ استفاده شده است. |
کلاس GeocodedWaypoint
google.maps.routes . GeocodedWaypoint
کلاس google.maps.routes . GeocodedWaypoint
کدگذاری جغرافیایی در مورد مکان های مورد استفاده به عنوان ایستگاه های بین راه. فقط برای نقاط راه آدرس پر شده است. شامل جزئیاتی در مورد نتایج کدگذاری جغرافیایی به منظور تعیین اینکه آدرس به چه مکانی کدگذاری شده است.
با فراخوانی const {GeocodedWaypoint} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
geocoderStatus | نوع: RPCStatus optional کد وضعیت حاصل از عملیات کدگذاری جغرافیایی را نشان می دهد. |
intermediateWaypointRequestIndex | نوع: number optional شاخص نقطه میانی مربوطه در درخواست. فقط در صورتی پر می شود که نقطه بین راه مربوطه یک ایستگاه بین راهی باشد. |
partialMatch | نوع: boolean نشان می دهد که geocoder مطابقت دقیقی با درخواست اصلی برنگردانده است، اگرچه می تواند بخشی از آدرس درخواستی را مطابقت دهد. ممکن است بخواهید درخواست اصلی برای غلط املایی و/یا آدرس ناقص را بررسی کنید. |
placeId | نوع: string شناسه مکان برای این نتیجه. |
types | نوع: Array <string> نوع (های) نتیجه، به صورت تگ های صفر یا بیشتر. برای انواع پشتیبانی شده به https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types مراجعه کنید. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس نتایج جغرافیایی
google.maps.routes . GeocodingResults
کلاس google.maps.routes . GeocodingResults
شامل GeocodedWaypoint
برای مبدا، مقصد، و ایستگاه های بین راهی. فقط برای نقاط راه آدرس پر شده است.
با فراخوانی const {GeocodingResults} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
destination | نوع: GeocodedWaypoint optional نقطه گذر جغرافیایی برای مقصد. |
intermediates | نوع: Array < GeocodedWaypoint > optional فهرستی از نقاط بین راهی با کدهای جغرافیایی میانی که هر کدام حاوی یک فیلد شاخص است که به ترتیبی که در درخواست مشخص شده است، با موقعیت صفر نقطه راه مطابقت دارد. |
origin | نوع: GeocodedWaypoint optional نقطه گذر جغرافیایی برای مبدا. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس MultiModalSegment
google.maps.routes . MultiModalSegment
کلاس google.maps.routes . MultiModalSegment
اطلاعات خلاصه ای را در مورد یک بخش چندوجهی از RouteLeg.steps
یک مسیر ارائه می دهد. یک بخش چند وجهی به عنوان یک یا چند RouteLegStep
به هم پیوسته تعریف می شود که دارای یک TravelMode
هستند.
با فراخوانی const {MultiModalSegment} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
instructions | نوع: string optional دستورالعمل برای پیمایش این بخش چند وجهی. |
maneuver | نوع: string optional مانور ناوبری برای انجام در این مرحله. برای لیستی از مقادیر ممکن به مانور مراجعه کنید. |
stepEndIndex | نوع: number شاخص RouteLegStep مربوطه که انتهای یک بخش چند وجهی است. |
stepStartIndex | نوع: number شاخص RouteLegStep مربوطه که شروع یک بخش چند وجهی است. |
travelMode | نوع: TravelMode optional حالت سفر مورد استفاده برای این بخش چند وجهی. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس PolylineDetailInfo
google.maps.routes . PolylineDetailInfo
کلاس google.maps.routes . PolylineDetailInfo
اطلاعات مربوط به یک جاده را در امتداد یک خط چند خطی در بر می گیرد.
با فراخوانی const {PolylineDetailInfo} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
endIndex | نوع: number optional شاخص پایانی این جاده در چند خط است. |
presence | نوع: RoadFeatureState optional نشان می دهد که آیا ویژگی جاده در طول چند خط وجود دارد یا خیر. |
startIndex | نوع: number optional شاخص شروع این جاده در چند خط. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس PolylineDetails
google.maps.routes . PolylineDetails
کلاس google.maps.routes . PolylineDetails
جزئیات مربوط به یک شاخص داده شده یا بخش پیوسته از یک چند خط. با توجه به چند خطی با نقاط P_0، P_1، ...، P_N (شاخص مبتنی بر صفر)، PolylineDetails
یک ویژگی جاده را برای یک بازه معین توصیف می کند.
با فراخوانی const {PolylineDetails} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
flyoverInfo | نوع: Array < PolylineDetailInfo > جزئیات پرواز در امتداد چند خط. |
narrowRoadInfo | نوع: Array < PolylineDetailInfo > جزئیات جاده باریک در امتداد چند خط. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
ثابت های کیفیت Polyline
google.maps.routes . PolylineQuality
ثابت های google.maps.routes . PolylineQuality
کیفیت پلی لاین را مشخص می کند.
با فراخوانی const {PolylineQuality} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
HIGH_QUALITY | یک چند خط با کیفیت بالا را مشخص می کند که با استفاده از نقاط بیشتری نسبت به OVERVIEW به قیمت افزایش اندازه پاسخ تشکیل شده است. زمانی که به دقت بیشتری نیاز دارید از این مقدار استفاده کنید. |
OVERVIEW | یک چند خط نمای کلی را مشخص می کند که با استفاده از تعداد کمی از نقاط تشکیل شده است. استفاده از این گزینه در مقایسه با HIGH_QUALITY تاخیر درخواست کمتری دارد. هنگام نمایش یک نمای کلی از مسیر از این مقدار استفاده کنید. |
ثابت های ReferenceRoute
google.maps.routes . ReferenceRoute
ثابت های google.maps.routes . ReferenceRoute
یک مسیر مرجع پشتیبانی شده در یک ComputeRoutesRequest
.
با فراخوانی const {ReferenceRoute} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
FUEL_EFFICIENT | مسیر مصرف سوخت |
SHORTER_DISTANCE | مسیری با مسافت سفر کمتر. |
ثابت های RoadFeatureState
google.maps.routes . RoadFeatureState
ثابت های google.maps.routes . RoadFeatureState
حالت های ویژگی های جاده را در امتداد یک خط چند خطی در بر می گیرد.
با فراخوانی const {RoadFeatureState} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
DOES_NOT_EXIST | ویژگی جاده وجود ندارد. |
EXISTS | ویژگی جاده وجود دارد. |
ثابت های RouteLabel
google.maps.routes . RouteLabel
ثابت های google.maps.routes . RouteLabel
برچسبهایی برای مسیر که برای شناسایی ویژگیهای خاص برای مقایسه با دیگران مفید هستند.
با فراخوانی const {RouteLabel} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
DEFAULT_ROUTE | مسیر پیشفرض "بهترین" برای محاسبه مسیر برگردانده شد. |
DEFAULT_ROUTE_ALTERNATE | جایگزینی برای مسیر پیشفرض "بهترین" زمانی که ComputeRoutesRequest.computeAlternativeRoutes مشخص شده باشد، مسیرهایی مانند این برگردانده می شوند. |
FUEL_EFFICIENT | مسیر مصرف سوخت مسیرهایی که با این مقدار برچسب گذاری شده اند برای پارامترهای اکو مانند مصرف سوخت بهینه شده اند. |
SHORTER_DISTANCE | مسافت سفر کوتاه تر. این یک ویژگی آزمایشی است. |
کلاس RouteLeg
google.maps.routes . RouteLeg
کلاس google.maps.routes . RouteLeg
شامل یک بخش بین ایستگاه های غیر via
.
با فراخوانی const {RouteLeg} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
distanceMeters | نوع: number مسافت طی مسیر، بر حسب متر. |
durationMillis | نوع: number optional مدت زمان لازم برای پیمایش در مسیر به میلی ثانیه. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار همان staticDurationMillis است. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است. |
endLocation | نوع: DirectionalLocation optional محل انتهایی این پا. این مکان ممکن است متفاوت از ComputeRoutesRequest.destination باشد. به عنوان مثال، زمانی که ComputeRoutesRequest.destination نزدیک جاده ای نیست، این نقطه ای در جاده است. |
localizedValues | نوع: RouteLegLocalizedValues optional نمایش متنی ویژگی های RouteLeg . |
path | نوع: Array < LatLngAltitude > لیست LatLngAltitude s پای مسیر که می توان از آن برای رسم چند خط پای مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد. |
speedPaths | گروهبندی بخشهای مسیر انتهایی مسیر با سرعت خوانی متناظر آنها. برای پر شدن این فیلد، ComputeRoutesRequest.routingPreference باید روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL و ComputeRoutesRequest.extraComputations باید شامل TRAFFIC_ON_POLYLINE باشد. |
startLocation | نوع: DirectionalLocation optional محل شروع این پا. این مکان ممکن است متفاوت از ComputeRoutesRequest.origin باشد. به عنوان مثال، زمانی که ComputeRoutesRequest.origin نزدیک یک جاده نیست، این یک نقطه در جاده است. |
staticDurationMillis | نوع: number optional مدت زمان سفر از طریق پا بدون در نظر گرفتن شرایط ترافیکی. توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است. |
steps | نوع: Array < RouteLegStep > مجموعهای از مراحل که بخشهای درون این پا را نشان میدهد. هر مرحله نشان دهنده یک دستورالعمل ناوبری است. |
stepsOverview | نوع: StepsOverview optional اطلاعات کلی در مورد مراحل این RouteLeg . این قسمت فقط برای مسیرهای TRANSIT پر شده است. |
travelAdvisory | نوع: RouteLegTravelAdvisory optional حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک مسیر. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس RouteLegLocalizedValues
google.maps.routes . RouteLegLocalizedValues
کلاس google.maps.routes . RouteLegLocalizedValues
نمایش متنی RouteLeg
.
با فراخوانی const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
distance | نوع: string optional مسافت پیموده شده پای مسیر به صورت متنی. |
distanceLanguage | نوع: string optional کد زبان BCP-47 متن از راه دور، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
duration | نوع: string optional مدت زمان، به صورت متن نمایش داده شده و به منطقه پرس و جو بومی سازی شده است. شرایط ترافیکی را در نظر می گیرد. |
durationLanguage | نوع: string optional کد زبان BCP-47 متن مدت، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
staticDuration | نوع: string optional مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است. |
staticDurationLanguage | نوع: string optional کد زبان BCP-47 متن مدت زمان ثابت، مانند "en-US" یا "sr-Latn". |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس RouteLegStep
google.maps.routes . RouteLegStep
کلاس google.maps.routes . RouteLegStep
شامل بخشی از RouteLeg
است. یک مرحله مربوط به یک دستورالعمل ناوبری است. پایه های مسیر از پله ها تشکیل شده است.
با فراخوانی const {RouteLegStep} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
distanceMeters | نوع: number مسافت طی این مرحله، بر حسب متر است. |
endLocation | نوع: DirectionalLocation optional محل پایان این مرحله. |
instructions | نوع: string optional دستورالعمل پیمایش در این مرحله |
localizedValues | نوع: RouteLegStepLocalizedValues optional نمایش متنی خصوصیات RouteLegStep . |
maneuver | نوع: string optional مانور ناوبری برای انجام در این مرحله. برای لیستی از مقادیر ممکن به مانور مراجعه کنید. |
path | نوع: Array < LatLngAltitude > لیست LatLngAltitude s پله پای مسیر که می توان از آن برای رسم چندخط پله پای مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد. فیلد "path" باید در ComputeRoutesRequest.fields درخواست شود تا این فیلد پر شود. |
startLocation | نوع: DirectionalLocation optional محل شروع این مرحله. |
staticDurationMillis | نوع: number optional مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی. توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است. |
transitDetails | نوع: TransitDetails optional جزئیات مربوط به این مرحله اگر حالت سفر TRANSIT باشد. |
travelMode | نوع: TravelMode optional حالت سفر استفاده شده برای این مرحله. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس RouteLegStepLocalizedValues
google.maps.routes . RouteLegStepLocalizedValues
کلاس google.maps.routes . RouteLegStepLocalizedValues
نمایش متنی خصوصیات RouteLegStep
.
با فراخوانی const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
distance | نوع: string optional مسافت پیموده شده مرحله پای مسیر به صورت متنی. |
distanceLanguage | نوع: string optional کد زبان BCP-47 متن از راه دور، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
staticDuration | نوع: string optional مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است. |
staticDurationLanguage | نوع: string optional کد زبان BCP-47 متن مدت زمان ثابت، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس RouteLegTravelAdvisory
google.maps.routes . RouteLegTravelAdvisory
کلاس google.maps.routes . RouteLegTravelAdvisory
حاوی اطلاعات اضافی است که کاربر باید در RouteLeg
از آنها مطلع شود.
با فراخوانی const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
speedReadingIntervals | نوع: Array < SpeedReadingInterval > optional فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در مورد TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference . فواصل، کل چند خط RouteLeg را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است.مثال: |
tollInfo | نوع: TollInfo optional حاوی اطلاعاتی درباره عوارض در RouteLeg خاص است. این فیلد فقط در صورتی پر می شود که در RouteLeg عوارضی وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما TollInfo.estimatedPrices پر نشده باشد، قسمت مسیر شامل عوارض است اما قیمت تخمینی ناشناخته است. اگر این فیلد خالی باشد، هیچ عوارضی در RouteLeg وجود ندارد. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
کلاس RouteLocalizedValues
google.maps.routes . RouteLocalizedValues
کلاس google.maps.routes . RouteLocalizedValues
نمایش متنی ویژگی های Route
.
با فراخوانی const {RouteLocalizedValues} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
distance | نوع: string optional مسافت طی مسیر به صورت متنی نشان داده شده است. |
distanceLanguage | نوع: string optional کد زبان BCP-47 متن از راه دور، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
duration | نوع: string optional مدت زمان، به صورت متن نمایش داده شده و به منطقه پرس و جو بومی سازی شده است. شرایط ترافیکی را در نظر می گیرد. توجه: اگر اطلاعات ترافیک را درخواست نکردهاید، این مقدار همان مقدار staticDuration است. |
durationLanguage | نوع: string optional کد زبان BCP-47 متن مدت، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. |
staticDuration | نوع: string optional مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است. |
staticDurationLanguage | نوع: string optional کد زبان BCP-47 متن مدت زمان ثابت، مانند "en-US" یا "sr-Latn". |
transitFare | نوع: string optional کرایه حمل و نقل به صورت متنی نشان داده شده است. |
transitFareLanguage | نوع: string optional کد زبان BCP-47 متن کرایه حملونقل، مانند «en-US» یا «sr-Latn». |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: Object به یک شی تبدیل می شود. |
رابط RouteModifiers
google.maps.routes . RouteModifiers
رابط google.maps.routes . RouteModifiers
مجموعه ای از شرایط اختیاری را در بر می گیرد تا هنگام محاسبه مسیرها برآورده شود.
خواص | |
---|---|
avoidFerries optional | نوع: boolean optional وقتی روی true تنظیم شود، در صورت معقول بودن، از کشتیها اجتناب میکند و به مسیرهایی که شامل کشتی نیستند ترجیح میدهد. فقط برای DRIVING یا TWO_WHEELER TravelMode اعمال می شود. |
avoidHighways optional | نوع: boolean optional هنگامی که روی true تنظیم شده است ، از بزرگراه ها در صورت معقول جلوگیری می کند و ترجیح می دهد مسیرهایی که حاوی بزرگراه ها نیستند. فقط مربوط به DRIVING یا TravelMode یا TWO_WHEELER است. |
avoidIndoor optional | نوع: boolean optional هنگامی که به true تنظیم شده اید ، از پیمایش در داخل خانه ها در جایی که معقول است ، جلوگیری می کند و ترجیح می دهد مسیرهایی که حاوی ناوبری داخلی نیستند. فقط مربوط به WALKING TravelMode است. |
avoidTolls optional | نوع: boolean optional هنگامی که به true تنظیم شده اید ، از جاده های عوارض که در آن معقول است ، جلوگیری می کند و ترجیح می دهد مسیرهایی که حاوی جاده های عوارض نیستند. فقط مربوط به DRIVING یا TravelMode یا TWO_WHEELER است. |
tollPasses optional | نوع: Iterable <string> optional اطلاعات مربوط به گذرگاه های عوارض را محاصره می کند. در صورت ارائه عوارض ، API سعی می کند قیمت پاس را بازگرداند. در صورت عدم ارائه عوارض ، API با عبور عوارض به عنوان ناشناخته رفتار می کند و سعی می کند قیمت نقدی را برگرداند. فقط مربوط به DRIVING یا TravelMode یا TWO_WHEELER است. برای لیستی از مقادیر معتبر به Tollpass مراجعه کنید. |
vehicleInfo optional | نوع: VehicleInfo optional اطلاعات وسیله نقلیه را مشخص می کند. |
رابط Routepolylinedetails
google.maps.routes . RoutePolylineDetails
رابط google.maps.routes . RoutePolylineDetails
جزئیات مربوط به بخشی از مسیری که مربوط به یک پلی خط است که می تواند برای سفارشی سازی سبک پلی خط استفاده شود.
خواص | |
---|---|
speed optional | نوع: Speed optional سرعت خواندن بخش مسیر مربوط به این پلی خط. فقط برای مسیرهایی که دارای اطلاعات ترافیکی هستند ، جمع شده اند. |
transitDetails optional | نوع: TransitDetails optional جزئیات ترانزیت بخش مسیر مربوط به این پلی خط. فقط برای مسیرهایی با اطلاعات حمل و نقل جمع شده است. |
travelMode optional | نوع: TravelMode optional حالت سفر بخش مسیر مربوط به این پلی خط. خالی برای پولیلین های ترافیکی. |
رابط RoutepolylineOptions
google.maps.routes . RoutePolylineOptions
رابط google.maps.routes . RoutePolylineOptions
گزینه هایی برای ایجاد polylines مسیر.
خواص | |
---|---|
colorScheme optional | نوع: ColorScheme optional طرح رنگی برای استفاده برای polyline. هنگامی که به عنوان FOLLOW_SYSTEM مشخص می شود در حالی که Map colorScheme نیز FOLLOW_SYSTEM ، polylines در همان حالت تاریک/نور به عنوان نقشه ترسیم می شود. هنگامی که مشخص نشده است ، Route.createPolylines سعی می کند از colorScheme نقشه استفاده کند یا به پیش فرض سیستم برگردد. |
polylineOptions optional | نوع: PolylineOptions |(function( PolylineOptions , RoutePolylineDetails ): PolylineOptions ) optional گزینه هایی برای شخصی سازی سبک یک پلی خط. می تواند یا یک شیء PolylineOptions باشد که برای همه پولیلین ها برای مسیر اعمال می شود یا عملکردی که به طور پیش فرض PolylineOptions و RoutePolylineDetails را انجام می دهد و PolylineOptions باز می گرداند که برای آن پلی خط اعمال می شود. |
کلاس RoutetravelAdvisory
google.maps.routes . RouteTravelAdvisory
کلاس google.maps.routes . RouteTravelAdvisory
حاوی اطلاعات اضافی است که کاربر باید در یک Route
از آن مطلع شود.
دسترسی با فراخوانی const {RouteTravelAdvisory} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
fuelConsumptionMicroliters | نوع: number optional پیش بینی مصرف سوخت در میکرولیترها. توجه: اگر مصرف سوخت بیش از 2^53 میکرولیتر باشد ، این مقدار Number.POSITIVE_INFINITY است. positive_infinity. |
routeRestrictionsPartiallyIgnored | نوع: boolean optional این Route ممکن است محدودیت هایی داشته باشد که برای حالت سفر درخواست شده یا اصلاح کننده مسیر مناسب نباشد. |
speedReadingIntervals | نوع: Array < SpeedReadingInterval > optional فواصل خواندن سرعت در مورد تراکم ترافیک. در مورد TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference قابل اجرا است. فواصل کل پلی خط Route را بدون همپوشانی پوشش می دهد. نقطه شروع یک بازه مشخص همان نقطه پایان فاصله قبل است.مثال: |
tollInfo | نوع: TollInfo optional حاوی اطلاعاتی در مورد عوارض در Route است. این زمینه فقط در صورتی که انتظار می رود در Route باشد ، جمع می شود. اگر این قسمت تنظیم شده باشد اما TollInfo.estimatedPrices پر نشده است ، مسیر حاوی عوارض است اما قیمت تخمینی ناشناخته است. اگر این قسمت خالی باشد ، هیچ عوارضی در Route وجود ندارد. |
transitFare | نوع: Money optional در صورت وجود ، شامل کل کرایه یا هزینه بلیط این Route است. این ویژگی فقط برای TRANSIT ComputeRoutesRequest.travelMode و فقط برای مسیرهایی که اطلاعات کرایه برای کلیه مراحل ترانزیت در دسترس است ، بازگردانده می شود. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
ConstingPreenference Constants
google.maps.routes . RoutingPreference
Constants
عواملی که باید هنگام محاسبه مسیر مورد توجه قرار گیرند.
دسترسی با فراخوانی const {RoutingPreference} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
TRAFFIC_AWARE | مسیرهایی را که شرایط ترافیک زنده را در نظر می گیرد محاسبه می کند. بر خلاف TRAFFIC_AWARE_OPTIMAL ، برخی از بهینه سازی ها برای کاهش قابل توجهی در تأخیر اعمال می شود. |
TRAFFIC_AWARE_OPTIMAL | مسیرهایی را که شرایط ترافیک زنده را در نظر گرفته می شود ، بدون استفاده از بیشتر بهینه سازی های عملکرد محاسبه می کند. استفاده از این مقدار بالاترین تأخیر را ایجاد می کند. |
TRAFFIC_UNAWARE | مسیرها را بدون توجه به شرایط ترافیک زنده محاسبه می کند. مناسب وقتی شرایط ترافیک اهمیتی ندارد یا کاربردی نیست. استفاده از این مقدار کمترین تأخیر را ایجاد می کند. |
ثابت
google.maps.routes . Speed
طبقه بندی سرعت پلیین بر اساس داده های ترافیکی.
با فراخوانی const {Speed} = await google.maps.importLibrary("routes")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
NORMAL | سرعت عادی ، بدون تاخیر در ترافیک. |
SLOW | کاهش سرعت ، مقدار متوسط ترافیک. |
TRAFFIC_JAM | تاخیر در ترافیک |
رابط کاربری سرعت
google.maps.routes . SpeedPath
رابط google.maps.routes . SpeedPath
گروه های LatLngAltitude
از یک فاصله مسیر با سرعت خواندن برای فاصله را با هم گروه ها گروه می کنند.
خواص | |
---|---|
path | نوع: Array < LatLngAltitude > مسیر تحت پوشش این مسیر سرعت. |
speed optional | نوع: Speed optional سرعت خواندن مسیر. |
کلاس SpeedReadingInterval
google.maps.routes . SpeedReadingInterval
کلاس google.maps.routes . SpeedReadingInterval
نشانگر چگالی ترافیک در یک بخش متناوب از یک پلی خط یا مسیر. با توجه به مسیری با امتیاز P_0 ، P_1 ، ... ، P_N (شاخص مبتنی بر صفر) ، SpeedReadingInterval
چگالی ترافیک یک بازه را توصیف می کند.
دسترسی با فراخوانی const {SpeedReadingInterval} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
endPolylinePointIndex | نوع: number optional شاخص پایان این بازه در پلی خط. |
speed | نوع: Speed optional سرعت ترافیک در این بازه. |
startPolylinePointIndex | نوع: number optional شاخص شروع این بازه در پلی خط. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: هیچکدام تبدیل به یک شی. |
کلاس StepsOverview
google.maps.routes . StepsOverview
کلاس google.maps.routes . StepsOverview
اطلاعات کلی در مورد لیستی از RouteLeg.steps
را ارائه می دهد.
دسترسی با فراخوانی const {StepsOverview} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
multiModalSegments | نوع: Array < MultiModalSegment > اطلاعات خلاصه شده در مورد بخش های مختلف چند منظوره از RouteLeg.steps . |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
کلاس TollInfo
google.maps.routes . TollInfo
کلاس google.maps.routes . TollInfo
اطلاعات عوارض را در یک Route
یا RouteLeg
محاصره می کند.
دسترسی به تماس با const {TollInfo} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
estimatedPrices | مبلغ پولی عوارض برای Route یا RouteLeg مربوطه. این لیست حاوی مبلغی برای هر ارز است که انتظار می رود توسط ایستگاه های عوارض شارژ شود. به طور معمول این لیست فقط یک مورد برای مسیرهایی با عوارض در یک ارز دارد. برای سفرهای بین المللی ، این لیست ممکن است حاوی موارد مختلفی باشد تا عوارض ارزهای مختلف را منعکس کند. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
کلاس ترانزیراژنی
google.maps.routes . TransitAgency
کلاس google.maps.routes . TransitAgency
اطلاعات مربوط به آژانس ترانزیت.
دسترسی با فراخوانی const {TransitAgency} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
name | نوع: string optional نام این آژانس ترانزیت. |
phoneNumber | نوع: string optional شماره تلفن با فرمت اختصاصی آژانس ترانزیت. |
url | نوع: URL optional URL آژانس ترانزیت. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
کلاس TransitDetails
google.maps.routes . TransitDetails
کلاس google.maps.routes . TransitDetails
اطلاعات اضافی در مورد یک مرحله ترانزیت در یک مسیر.
دسترسی با فراخوانی const {TransitDetails} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
arrivalStop | نوع: TransitStop optional اطلاعات مربوط به توقف ورود برای مرحله. |
arrivalTime | نوع: Date optional زمان تخمینی ورود برای مرحله. |
departureStop | نوع: TransitStop optional اطلاعات مربوط به خروج برای مرحله متوقف می شود. |
departureTime | نوع: Date optional زمان تخمینی عزیمت برای مرحله. |
headsign | نوع: string optional جهت سفر به این خط را که در وسیله نقلیه یا در ایستگاه عزیمت مشخص شده است ، مشخص می کند. جهت اغلب ایستگاه پایانه است. |
headwayMillis | نوع: number optional زمان پیش بینی شده در میلی ثانیه بین عزیمت از همان توقف در این زمان را مشخص می کند. به عنوان مثال ، با ارزش پیشروی 600000 ، انتظار دارید که اگر اتوبوس خود را از دست بدهید ، ده دقیقه منتظر بمانید. توجه: اگر پیشروی بیش از 2^53 میلی ثانیه باشد ، این مقدار Number.POSITIVE_INFINITY است. positive_infinity. |
stopCount | نوع: number تعداد توقف از عزیمت به توقف ورود. این شمارش شامل توقف ورود است ، اما توقف عزیمت را مستثنی می کند. به عنوان مثال ، اگر مسیر شما از توقف A خارج شود ، از توقف B و C عبور می کند و به Stop D می رسد ، stopCount 3 خواهد بود. |
transitLine | نوع: TransitLine optional اطلاعات مربوط به خط ترانزیت مورد استفاده در مرحله. |
tripShortText | نوع: string optional متنی که در برنامه ها ظاهر می شود و تابلوها را امضا می کند تا یک سفر ترانزیت به مسافران را شناسایی کند. متن منحصر به فرد سفر را در یک روز خدمات مشخص می کند. به عنوان مثال ، "538" tripShortText از قطار Amtrak است که سان خوزه ، کالیفرنیا را در ساعت 15:10 در روزهای هفته به ساکرامنتو ، کالیفرنیا ترک می کند. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
کلاس TransitLine
google.maps.routes . TransitLine
کلاس google.maps.routes . TransitLine
اطلاعات مربوط به یک خط ترانزیت.
دسترسی با فراخوانی const {TransitLine} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
agencies | نوع: Array < TransitAgency > آژانس ترانزیت (یا آژانس ها) که این خط ترانزیت را اداره می کند. |
color | نوع: string optional رنگی که معمولاً در این علائم در علائم استفاده می شود. در hexadecimal نماینده است. |
iconURL | نوع: URL optional URL برای نماد مرتبط با این خط. |
name | نوع: string optional به عنوان مثال ، نام کامل این خط ترانزیت ، "8 خیابان محلی". |
shortName | نوع: string optional نام کوتاه این خط ترانزیت. این نام معمولاً یک شماره خط مانند "M7" یا "355" خواهد بود. |
textColor | نوع: string optional رنگی که معمولاً در متن روی علائم برای این خط استفاده می شود. در hexadecimal نماینده است. |
url | نوع: URL optional URL برای این خط ترانزیت همانطور که توسط آژانس ترانزیت ارائه شده است. |
vehicle | نوع: TransitVehicle optional نوع وسیله نقلیه ای که در این خط ترانزیت کار می کند. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
رابط TransitPreference
google.maps.routes . TransitPreference
رابط google.maps.routes . TransitPreference
ترجیحات مربوط به مسیرهای مبتنی بر TRANSIT
که بر مسیری که بازگردانده می شود تأثیر می گذارد.
خواص | |
---|---|
allowedTransitModes optional | نوع: Iterable < TransitMode > optional مجموعه ای از حالت های مسافرتی برای استفاده در هنگام دریافت مسیر TRANSIT . پیش فرض برای همه شیوه های پشتیبانی شده سفر. |
routingPreference optional | نوع: TransitRoutePreference optional اولویت مسیریابی که ، در صورت مشخص شدن ، بر مسیر TRANSIT تأثیر می گذارد. |
کلاس ترانزیت
google.maps.routes . TransitStop
کلاس google.maps.routes . TransitStop
اطلاعات مربوط به توقف حمل و نقل.
دسترسی با فراخوانی const {TransitStop} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
location | نوع: DirectionalLocation optional محل توقف بیان شده در مختصات عرض جغرافیایی/طول جغرافیایی و عنوان اختیاری. |
name | نوع: string optional نام ترانزیت توقف. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
کلاس ترانزیت
google.maps.routes . TransitVehicle
کلاس google.maps.routes . TransitVehicle
اطلاعات مربوط به وسیله نقلیه مورد استفاده در مسیرهای ترانزیت.
دسترسی با فراخوانی const {TransitVehicle} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
iconURL | نوع: URL optional URL برای یک نماد مرتبط با این نوع وسیله نقلیه. |
localIconURL | نوع: URL optional URL برای نماد مرتبط با این نوع وسیله نقلیه ، بر اساس علائم حمل و نقل محلی. |
name | نوع: string optional نام این وسیله نقلیه ، سرمایه گذاری شده است. |
nameLanguage | نوع: string optional کد زبان BCP-47 متن نام وسیله نقلیه مانند "en-us" یا "sr-latn". برای اطلاعات بیشتر به: https://www.unicode.org/reports/tr35/#unicode_locale_identifier مراجعه کنید. |
vehicleType | نوع: string optional نوع وسیله نقلیه مورد استفاده به https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype برای لیستی از مقادیر ممکن مراجعه کنید. |
روش ها | |
---|---|
toJSON | toJSON() پارامترها: هیچ مقدار بازگشت: Object تبدیل به یک شی. |
ثابت VehicleMissionType
google.maps.routes . VehicleEmissionType
ثابت google.maps.routes . VehicleEmissionType
مجموعه ای از مقادیر توصیف نوع انتشار وسیله نقلیه. فقط مربوط به حالت سفر DRIVING
است.
دسترسی با تماس با const {VehicleEmissionType} = await google.maps.importLibrary("routes")
.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
DIESEL | وسیله نقلیه سوخت دیزل. |
ELECTRIC | وسیله نقلیه برق. |
GASOLINE | وسیله نقلیه بنزین/بنزین سوخت. |
HYBRID | سوخت ترکیبی (مانند بنزین + برقی). |
رابط VehicleInfo
google.maps.routes . VehicleInfo
رابط google.maps.routes . VehicleInfo
حاوی اطلاعات وسیله نقلیه مانند نوع انتشار وسیله نقلیه است.
خواص | |
---|---|
emissionType optional | نوع: VehicleEmissionType optional نوع انتشار وسیله نقلیه را توصیف می کند. فقط مربوط به حالت سفر DRIVING است. |
رابط نقطه راه
google.maps.routes . Waypoint
رابط google.maps.routes . Waypoint
نمایانگر یک نقطه راه در یک مسیر است.
خواص | |
---|---|
location | نوع: string| LatLng | LatLngLiteral | LatLngAltitudeLiteral | DirectionalLocationLiteral | Place محل ایستگاه Waypoint. یک رشته ممکن است یک آدرس ، یک کد به علاوه یا نام منبع مکان باشد. |
sideOfRoad optional | نوع: boolean optional نشان می دهد که مکان این نقطه راه به معنای اولویت برای متوقف کردن وسیله نقلیه در یک طرف خاص از جاده است. هنگامی که این مقدار را تعیین کردید ، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده متوقف شود که مکان از مرکز جاده مغرضانه باشد. این گزینه فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode کار می کند |
vehicleStopover optional | نوع: boolean optional نشان می دهد که ایستگاه راه برای متوقف کردن وسایل نقلیه در آن قرار دارد ، جایی که قصد وانت یا کشویی است. هنگامی که این مقدار را تعیین می کنید ، مسیر محاسبه شده شامل غیر via ایستگاه های راه در جاده هایی نیست که برای وانت و رها کردن نامناسب هستند. این گزینه فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode کار می کند و وقتی Waypoint.location یک string یا Place نیست. |
via optional | نوع: boolean optional این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف نشان می دهد. برای هر غیر via ایستگاه در ComputeRoutesRequest ، Route.computeRoutes ورود به Route.legs LEGS را ضمیمه می کند تا جزئیات مربوط به توقف در آن پای سفر را ارائه دهد.وقتی می خواهید مسیر از این نقطه عبور کند بدون اینکه متوقف شود ، این مقدار را true تنظیم کنید. از طریق ایستگاه های راه باعث نمی شود که ورود به Route.legs لژها اضافه شود ، اما آنها سفر را از طریق ایستگاه راه طی می کنند.یادداشت ها:
|
رابط WaypointmarkerDetails
google.maps.routes . WaypointMarkerDetails
رابط google.maps.routes . WaypointMarkerDetails
جزئیات مربوط به یک ایستگاه راه که می تواند برای سفارشی کردن سبک نشانگر استفاده شود.
خواص | |
---|---|
index | نوع: number شاخص نشانگر. |
totalMarkers | نوع: number تعداد کل نشانگرها در مسیر. |
leg optional | نوع: RouteLeg optional پا که نشانگر متعلق به آن است. اگر مسیر هیچ پا نداشته باشد خالی است. |