Route

فئة Route

صف واحد (google.maps.routes.Route)

يحتوي على مسار يتألف من سلسلة من أجزاء الطرق المتصلة التي تربط بين نقاط المسار في البداية والنهاية والوسط.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {Route} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الطرق الثابتة

computeRoutes

computeRoutes(request) المَعلمات:  request:  ComputeRoutesRequest القيمة المعروضة:  Promise<{   routes:Array<Route> optional,   fallbackInfo:FallbackInfo optional,   geocodingResults:GeocodingResults optional }> تعرض هذه الدالة المسار الأساسي مع مسارات بديلة اختيارية، استنادًا إلى مجموعة من نقاط المسار النهائية والمتوسطة. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الاستجابة في الطلب من خلال ضبط السمة ComputeRoutesRequest.fields. القيمة هي قائمة بمسارات الحقول. على سبيل المثال: قناع الحقل لجميع الحقول المتاحة: fields: ['*'] قناع حقل المدة والمسافة والمسار على مستوى المسار: fields: ['durationMillis', 'distanceMeters', 'path'] لا يُنصح باستخدام قناع حقل الاستجابة الشامل 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	النوع:  Array<RouteLeg> optional مجموعة من المراحل (أجزاء المسار بين النقاط على المسار) التي تشكّل المسار يتوافق كل جزء مع الرحلة بين نقطتَين على المسار غير via. على سبيل المثال: يتضمّن المسار الذي لا يحتوي على نقاط وسيطة على المسار مرحلة واحدة فقط. يتضمّن المسار الذي يشمل نقطة على المسار وسيطة واحدة غير via جزأين. يتضمّن المسار الذي يحتوي على نقطة واحدة على المسار via جزءًا واحدًا. يتطابق ترتيب المراحل مع ترتيب النقاط على المسار من origin إلى intermediates إلى destination.
localizedValues	النوع:  RouteLocalizedValues optional تمثيلات نصية لسمات Route
optimizedIntermediateWaypointIndices	النوع:  Array<number> optional إذا ضبطت ComputeRoutesRequest.optimizeWaypointOrder على true، يحتوي هذا الحقل على الترتيب المحسّن للنقاط على المسار المتوسطة. وإلا، سيكون هذا الحقل فارغًا. يبدأ الفهرس بالرقم 0 للنقطة الوسيطة الأولى المقدَّمة في الإدخال. على سبيل المثال، إذا أدخلت ما يلي: المصدر: لوس أنجلوس النقاط الوسيطة على المسار: دالاس، بانغور، فينيكس الوجهة: نيويورك وكان ترتيب النقاط الوسيطة المحسّن على المسار هو فينيكس ودالاس وبانغور، سيكون هذا الحقل [2, 0, 1].
path	النوع:  Array<LatLngAltitude> optional قائمة LatLngAltitude للمسار، والتي يمكن استخدامها لرسم خطوط متعدّدة للمسار يمكن التحكّم في دقة المسار من خلال ضبط ComputeRoutesRequest.polylineQuality.
polylineDetails	النوع:  PolylineDetails optional تحتوي على معلومات حول التفاصيل على طول المسار.
routeLabels	النوع:  Array<RouteLabel> optional تصنيفات المسار التي تكون مفيدة لتحديد سمات معيّنة أو للمقارنة مع سمات أخرى
routeToken	النوع:  string optional هو رمز مميّز غير شفاف يمكن تمريره إلى حزمة تطوير البرامج (SDK) للتنقّل لإعادة إنشاء المسار أثناء التنقّل، وفي حال إعادة التوجيه، يتم الالتزام بالهدف الأصلي عند إنشاء المسار. يجب التعامل مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم. لا تقارِن قيمتها في الطلبات المختلفة لأنّ قيمتها قد تتغيّر حتى إذا عرضت الخدمة المسار نفسه بالضبط. ملاحظة: لا يتوفّر routeToken إلا للطلبات التي تم ضبط ComputeRoutesRequest.routingPreference فيها على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. ولا تتوفّر للطلبات التي تحتوي على via نقطة على المسار.
speedPaths	النوع:  Array<SpeedPath> optional مجموعات من أقسام مسار الرحلة مع قراءة السرعة المقابلة لها لتعبئة هذا الحقل، يجب ضبط 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]) المَعلمات:  options:  RoutePolylineOptions optional القيمة المعروضة:  Array<Polyline> تنشئ خطوطًا متعدّدة للمسار استنادًا إلى البيانات المتاحة. خطوط متعدّدة لوسائل نقل متعددة: المتطلبات: يجب طلب الحقلَين "path" و"legs" في ComputeRoutesRequest.fields يجب ضبط السمة ComputeRoutesRequest.travelMode على TRANSIT. تنشئ هذه السمة خطوطًا متعدّدة لكل جزء من المسار المتعدّد الوسائط. يتم تصميم الخطوط المتعدّدة وفقًا لوضع السفر في الجزء وبيانات خط النقل العام عند توفّرها. يمكن تمرير الخيارات لتغيير نمط الخطوط المتعدّدة استنادًا إلى وضع السفر وخط النقل العام. الخطوط المتعدّدة لحركة المرور: المتطلبات: يجب طلب الحقلَين "path" و"travelAdvisory" (أو "speedPaths" فقط كاختصار) في ComputeRoutesRequest.fields. يجب ضبط السمة ComputeRoutesRequest.routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. يجب أن يتضمّن الحقل ComputeRoutesRequest.extraComputations القيمة TRAFFIC_ON_POLYLINE. يتم إنشاء خطوط متعدّدة لكل فاصل زمني في المسار عندما تختلف قراءة السرعة عن الفاصل الزمني السابق. يتم تطبيق النمط التلقائي المستند إلى السرعة على الخطوط المتعدّدة. يمكن تمرير الخيارات لتغيير نمط الخطوط المتعدّدة استنادًا إلى السرعة. الخط المتعدّد العام: المتطلبات: يجب طلب الحقل "path" أو "legs" في ComputeRoutesRequest.fields. تنشئ هذه السمة خطًا متعدّدًا واحدًا للمسار بأكمله مع تطبيق النمط التلقائي. يمكن تمرير الخيارات لتغيير نمط الخطوط المتعدّدة استنادًا إلى وضع التنقّل في المسار. لمزيد من التخصيص، يمكنك إنشاء خطوط متعدّدة مباشرةً باستخدام Route.path أو RouteLeg.path.
createWaypointAdvancedMarkers	createWaypointAdvancedMarkers([options]) المَعلمات:  options:  AdvancedMarkerElementOptions|(function(AdvancedMarkerElementOptions, WaypointMarkerDetails): AdvancedMarkerElementOptions) optional القيمة المعروضة:  Promise<Array<AdvancedMarkerElement>> يتم إنشاء علامات للمسار تحمل التصنيف "أ" و"ب" و"ج" وما إلى ذلك لكل نقطة على المسار. يتم تطبيق النمط التلقائي على العلامات. يمكن تمرير الخيارات لتغيير نمط العلامة استنادًا إلى فهرس العلامة أو خصائص RouteLeg المقابلة. ستكون المَعلمة WaypointMarkerDetails.leg غير محدّدة إذا لم يتضمّن المسار أي أقسام. يجب طلب الحقل "legs" في ComputeRoutesRequest.fields لتضمين النقاط على المسار المتوسطة.
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

واجهة ComputeRoutesRequest

واجهة google.maps.routes.ComputeRoutesRequest

طلب المسارات

الخصائص
destination	النوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint وجهة المسار قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Codes أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار عند احتساب المسارات.
fields	النوع:  Iterable<string> مجموعة من الحقول المطلوب جلبها حدِّد ["*"] لجميع الحقول.
origin	النوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint نقطة انطلاق المسار قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Codes أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار عند احتساب المسارات.
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	النوع:  Iterable<Waypoint> optional مجموعة من النقاط على طول المسار (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها. يمكن استخدام ما يصل إلى 25 نقطة على المسار.
language optional	النوع:  string optional رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتوافقة. في حال عدم تقديم هذه القيمة، يتم استنتاج اللغة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج اللغة من الموقع الجغرافي للمصدر.
optimizeWaypointOrder optional	النوع:  boolean optional في حال ضبط هذه السياسة على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب النقاط الوسيطة المحدّدة على المسار. يتعذّر تنفيذ الطلب إذا كانت أي من النقاط على المسار المتوسطة هي نقطة عبور. استخدِم Route.optimizedIntermediateWaypointIndices في الردّ للعثور على الترتيب الجديد. إذا لم يتم طلب "optimizedIntermediateWaypointIndices" في ComputeRoutesRequest.fields، سيتعذّر تنفيذ الطلب. في حال ضبطها على "خطأ"، ستكون قيمة Route.optimizedIntermediateWaypointIndices في الردّ فارغة.
polylineQuality optional	النوع:  PolylineQuality optional يحدّد هذا الإعداد جودة الخطوط المتعدّدة المفضّلة.
region optional	النوع:  string optional رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. في حال عدم تقديم هذه القيمة، يتم استنتاج المنطقة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج المنطقة من الموقع الجغرافي للمصدر.
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

عمليات حسابية إضافية يجب إجراؤها لطلب Route.computeRoutes.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
FLYOVER_INFO_ON_POLYLINE	معلومات عن الجسور للمسارات يجب تحديد حقل "polylineDetails" في ComputeRoutesRequest.fields لعرض هذه المعلومات. سيتم حاليًا تعبئة هذه البيانات لبعض المناطق المركزية في الهند فقط. هذه الميزة تجريبية، وتخضع وحدة تخزين الأسهم/الرسوم للتغيير.
FUEL_CONSUMPTION	استهلاك الوقود المقدَّر للمسارات
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	تعليمات التنقّل التي يتم عرضها كسلسلة نصية بتنسيق HTML هذا المحتوى مخصّص للقراءة كما هو وللعرض فقط. ولا تحلّلها آليًا.
NARROW_ROAD_INFO_ON_POLYLINE	معلومات عن الطرق الضيقة في المسارات يجب تحديد حقل "polylineDetails" في ComputeRoutesRequest.fields لعرض هذه المعلومات. لن تتم تعبئة هذه البيانات حاليًا إلا لبعض المناطق المركزية في الهند. هذه الميزة تجريبية، وقد يتغيّر رمز التخزين التعريفي أو الرسوم.
TOLLS	معلومات رسوم المرور للمسارات
TRAFFIC_ON_POLYLINE	خطوط متعدّدة تراعي حركة المرور للمسارات

DirectionalLocationLiteral interface

واجهة google.maps.routes.DirectionalLocationLiteral

يتم قبول الكائنات الحرفية بدلاً من مثيلات DirectionalLocation لتسهيل الاستخدام. ويتم تحويلها إلى DirectionalLocation عندما تواجهها Maps JS API.

توسّع هذه الواجهة LatLngAltitudeLiteral.

الخصائص
heading optional	النوع:  number optional تمثّل هذه السمة اتجاه البوصلة المرتبط باتجاه تدفق حركة المرور. يمكن أن تكون قيم الاتجاه أرقامًا من 0 إلى 360، حيث يحدّد الرقم 0 اتجاه الشمال، ويحدّد الرقم 90 اتجاه الشرق، وهكذا. يمكنك استخدام هذا الحقل فقط لـ DRIVING وTWO_WHEELER ComputeRoutesRequest.travelMode.
السمات المكتسَبة: altitude، lat، lng

فئة 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)

معلومات حول كيفية استخدام نتيجة احتياطية في ردّ من Route.computeRoutes وسبب استخدامها إذا تم ضبط هذا الحقل، يعني ذلك أنّ الخادم استخدم وضع توجيه مختلفًا عن الوضع المفضّل لديك كحل احتياطي.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {FallbackInfo} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
reason	النوع:  FallbackReason optional سبب استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي لا تتم تعبئة هذا الحقل إلا عند تفعيل وضع "الرد الاحتياطي" وعرض الرد الاحتياطي.
routingMode	النوع:  FallbackRoutingMode optional وضع التوجيه المستخدَم للردّ إذا تم تفعيل الإجراء الاحتياطي، قد يختلف الوضع عن الإعداد المفضّل للمسار المحدّد في طلب العميل الأصلي.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

ثوابت 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

وضع المسار الفعلي المستخدَم عند عرض ردّ احتياطي في ردّ 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)

الترميز الجغرافي للمواقع الجغرافية المستخدَمة كنقاط على المسار تتم تعبئة هذا الحقل فقط للنقاط على المسار التي تمثّل عناوين. تتضمّن تفاصيل حول نتائج الترميز الجغرافي لأغراض تحديد العنوان الذي تم ترميزه جغرافيًا.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {GeocodedWaypoint} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
geocoderStatus	النوع:  RPCStatus optional يشير إلى رمز الحالة الناتج عن عملية الترميز الجغرافي.
intermediateWaypointRequestIndex	النوع:  number optional فهرس النقطة الوسيطة المقابلة على المسار في الطلب لا تتم تعبئة هذا الحقل إلا إذا كانت النقطة المقابلة على المسار هي نقطة وسيطة.
partialMatch	النوع:  boolean يشير إلى أنّ أداة الترميز الجغرافي لم تعرض مطابقة تامة للطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. ننصحك بمراجعة الطلب الأصلي بحثًا عن أخطاء إملائية و/أو عنوان غير مكتمل.
placeId	النوع:  string رقم تعريف المكان لهذه النتيجة
types	النوع:  Array<string> أنواع النتيجة، على شكل صفر أو أكثر من علامات الأنواع. يُرجى الاطّلاع على https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types لمعرفة الأنواع المتوافقة.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

فئة 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)

يوفّر معلومات ملخّصة عن جزء متعدد الوسائط من 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)

تتضمّن معلومات عن ميزة طريق على طول امتداد خطوط متعدّدة.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎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)

التفاصيل المقابلة لفهرس معيّن أو جزء متجاور من خطوط متعدّدة بالنظر إلى خطوط متعدّدة تتضمّن النقاط 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 يتم تحويله إلى كائن.

ثوابت PolylineQuality

ذكرياتك الثابتة في شهر google.maps.routes.PolylineQuality

تحدّد هذه السمة جودة الخطوط المتعدّدة.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {PolylineQuality} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
HIGH_QUALITY	تحدّد هذه السمة خطوطًا متعدّدة عالية الجودة تتكوّن من نقاط أكثر من OVERVIEW على حساب زيادة حجم الردّ. استخدِم هذه القيمة عندما تحتاج إلى مزيد من الدقة.
OVERVIEW	تحدّد هذه السمة خطوطًا متعدّدة لنظرة عامة يتم إنشاؤها باستخدام عدد صغير من النقاط. يؤدي استخدام هذا الخيار إلى تقليل وقت استجابة الطلب مقارنةً بـ HIGH_QUALITY. استخدِم هذه القيمة عند عرض نظرة عامة على المسار.

ReferenceRoute 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

تتضمّن حالات ميزات الطريق على طول امتداد الخطوط المتعدّدة.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RoadFeatureState} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
DOES_NOT_EXIST	الطريق غير موجودة.
EXISTS	الطريق موجودة.

ثوابت 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)

يحتوي على جزء بين نقاط على المسار غير تابعة لـ "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 لمرحلة المسار، والتي يمكن استخدامها لرسم خطوط متعدّدة لمرحلة المسار يمكن التحكّم في دقة المسار من خلال ضبط ComputeRoutesRequest.polylineQuality.
speedPaths	النوع:  Array<SpeedPath> مجموعات من أقسام مسار المرحلة مع قراءة السرعة المقابلة لها لتعبئة هذا الحقل، يجب ضبط 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)

تمثيلات نصية لـ 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)

يحتوي على جزء من 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> قائمة LatLngAltitudes لخطوة جزء المسار، والتي يمكن استخدامها لرسم خطوط متعدّدة لخطوة جزء المسار. يمكن التحكّم في دقة المسار من خلال ضبط 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)

تمثيلات نصية لسمات 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)

يحتوي على معلومات إضافية يجب إبلاغ المستخدم بها على RouteLeg.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
speedReadingIntervals	النوع:  Array<SpeedReadingInterval> optional فترات قراءة السرعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال استخدام TRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. تغطي الفواصل الزمنية الخطوط المتعدّدة بالكامل لـ RouteLeg بدون تداخل. تكون نقطة البداية لفاصل زمني محدّد هي نفسها نقطة النهاية للفاصل الزمني السابق. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo	النوع:  TollInfo optional يحتوي على معلومات عن رسوم العبور على RouteLeg المحدّد. لا تتم تعبئة هذا الحقل إلا إذا كان من المتوقّع فرض رسوم عبور على RouteLeg. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة TollInfo.estimatedPrices، يحتوي جزء المسار على رسوم عبور ولكن السعر المقدَّر غير معروف. إذا كان هذا الحقل فارغًا، يعني ذلك أنّه ما مِن رسوم عبور على RouteLeg.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

فئة 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

تتضمّن مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب المسارات.

الخصائص
avoidFerries optional	النوع:  boolean optional عند ضبط هذه السياسة على true، يتم تجنُّب العبّارات حيثما أمكن، مع إعطاء الأفضلية للمسارات التي لا تتضمّن عبّارات. ينطبق ذلك على DRIVING أو TWO_WHEELER TravelMode فقط.
avoidHighways optional	النوع:  boolean optional عند ضبط السياسة على true، يتم تجنُّب الطرق السريعة قدر الإمكان، مع تفضيل المسارات التي لا تحتوي على طرق سريعة. ينطبق ذلك على DRIVING أو TWO_WHEELER TravelMode فقط.
avoidIndoor optional	النوع:  boolean optional عند ضبط هذه السياسة على true، يتم تجنُّب التنقّل داخل المباني حيثما أمكن، مع إعطاء الأفضلية للمسارات التي لا تتضمّن التنقّل داخل المباني. ينطبق ذلك على WALKING TravelMode فقط.
avoidTolls optional	النوع:  boolean optional عند ضبط هذه المَعلمة على true، يتم تجنُّب الطرق برسوم عبور حيثما أمكن، مع إعطاء الأفضلية للمسارات التي لا تحتوي على طرق برسوم عبور. ينطبق ذلك على DRIVING أو TWO_WHEELER TravelMode فقط.
tollPasses optional	النوع:  Iterable<string> optional تتضمّن معلومات حول بطاقات رسوم العبور. إذا تم توفير بطاقات لرسوم العبور، تحاول واجهة برمجة التطبيقات عرض سعر البطاقة. إذا لم يتم توفير بطاقات لرسوم العبور، ستتعامل واجهة برمجة التطبيقات مع بطاقة رسوم العبور على أنّها غير معروفة وستحاول عرض السعر النقدي. ينطبق ذلك على DRIVING أو TWO_WHEELER TravelMode فقط. يُرجى الاطّلاع على TollPass للحصول على قائمة بالقيم الصالحة.
vehicleInfo optional	النوع:  VehicleInfo optional تحدّد هذه السمة معلومات المركبة.

واجهة RoutePolylineDetails

واجهة google.maps.routes.RoutePolylineDetails

تفاصيل حول قسم من مسار يتوافق مع خطوط متعدّدة يمكن استخدامها لتخصيص نمط الخطوط المتعدّدة.

الخصائص
speed optional	النوع:  Speed optional قراءة السرعة لجزء المسار المقابل لهذا الخط المتعدّد لا تتم تعبئة هذا الحقل إلا للمسارات التي تتضمّن معلومات عن حركة المرور.
transitDetails optional	النوع:  TransitDetails optional تفاصيل النقل العام لقسم المسار المقابل لهذا الخط المتعدّد لا تتم تعبئة هذا الحقل إلا للمسارات التي تتضمّن معلومات عن النقل العام.
travelMode optional	النوع:  TravelMode optional وسيلة النقل في جزء المسار المقابل لهذا الخط المتعدّد يكون هذا الحقل فارغًا في حال استخدام خطوط متعدّدة لحركة المرور.

واجهة RoutePolylineOptions

واجهة google.maps.routes.RoutePolylineOptions

خيارات إنشاء خطوط متعدّدة للمسار

الخصائص
colorScheme optional	النوع:  ColorScheme optional نظام الألوان الذي سيتم استخدامه للخطوط المتعدّدة عند ضبط هذه السمة على FOLLOW_SYSTEM وضبط سمة الخريطة colorScheme على FOLLOW_SYSTEM أيضًا، سيتم رسم الخطوط المتعدّدة في الوضع الداكن أو الفاتح نفسه المستخدَم في الخريطة. في حال عدم تحديدها، يحاول Route.createPolylines استخدام colorScheme الخريطة أو يعود إلى الإعدادات التلقائية للنظام.
polylineOptions optional	النوع:  PolylineOptions|(function(PolylineOptions, RoutePolylineDetails): PolylineOptions) optional خيارات لتخصيص نمط شكل متعدّد الخطوط يمكن أن يكون عنصر PolylineOptions يتم تطبيقه على جميع الخطوط المتعدّدة للمسار أو دالة تأخذ القيمة التلقائية PolylineOptions وRoutePolylineDetails وتعرض PolylineOptions ليتم تطبيقه على هذا الخط المتعدّد.

فئة RouteTravelAdvisory

صف واحد (google.maps.routes.RouteTravelAdvisory)

يحتوي على معلومات إضافية يجب إبلاغ المستخدم بها على Route.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteTravelAdvisory} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
fuelConsumptionMicroliters	النوع:  number optional استهلاك الوقود المتوقّع بالميكرولتر ملاحظة: إذا تجاوز استهلاك الوقود 2^53 ميكرولتر، تكون هذه القيمة Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored	النوع:  boolean optional قد يكون لدى Route قيود غير مناسبة لوضع السفر المطلوب أو معدِّلات المسار.
speedReadingIntervals	النوع:  Array<SpeedReadingInterval> optional فترات قراءة السرعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال استخدام TRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. تغطي الفواصل الزمنية الخطوط المتعدّدة بالكامل لـ Route بدون تداخل. تكون نقطة البداية لفاصل زمني محدّد هي نفسها نقطة النهاية للفاصل الزمني السابق. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo	النوع:  TollInfo optional تحتوي على معلومات حول رسوم العبور على Route. لا تتم تعبئة هذا الحقل إلا إذا كان من المتوقّع فرض رسوم عبور على Route. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة TollInfo.estimatedPrices، يحتوي المسار على رسوم عبور ولكن السعر المقدَّر غير معروف. إذا كان هذا الحقل فارغًا، يعني ذلك أنّه ما مِن رسوم عبور على Route.
transitFare	النوع:  Money optional إذا كان هذا الحقل متوفّرًا، فهو يحتوي على إجمالي تكاليف الأجرة أو التذاكر لـ Route. لا يتم عرض هذه السمة إلا لـ TRANSIT ComputeRoutesRequest.travelMode وللمسارات التي تتوفّر فيها معلومات الأجرة لجميع خطوات النقل العام.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

ثوابت RoutingPreference

ذكرياتك الثابتة في شهر google.maps.routes.RoutingPreference

العوامل التي يجب أخذها في الاعتبار عند حساب المسار

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎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	تأخيرات في حركة المرور

واجهة SpeedPath

واجهة google.maps.routes.SpeedPath

يجمع هذا الحقل بين LatLngAltitudes لفترة المسار وقراءة السرعة للفترة.

الخصائص
path	النوع:  Array<LatLngAltitude> المسار الذي يغطّيه مسار السرعة هذا
speed optional	النوع:  Speed optional قراءة سرعة المسار

SpeedReadingInterval class

صف واحد (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 class

صف واحد (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)

تتضمّن معلومات رسوم المرور على Route أو RouteLeg.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {TollInfo} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
estimatedPrices	النوع:  Array<Money> optional المبلغ النقدي لرسوم العبور لـ Route أو RouteLeg المقابلَين تحتوي هذه القائمة على مبلغ لكل عملة من المتوقّع أن تفرضه محطات تحصيل الرسوم. عادةً ما تحتوي هذه القائمة على عنصر واحد فقط للمسارات التي تتضمّن رسوم عبور بعملة واحدة. بالنسبة إلى الرحلات الدولية، قد تحتوي هذه القائمة على عناصر متعددة لتعكس رسوم العبور بعملات مختلفة.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

فئة 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)

معلومات إضافية حول خطوة النقل العام في المسار

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎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 يحدّد هذا الحقل الوقت المتوقّع بالملي ثانية بين عمليات المغادرة من المحطة نفسها في هذا الوقت. على سبيل المثال، إذا كانت قيمة الفاصل الزمني 600,000، من المتوقّع أن تنتظر عشر دقائق إذا فاتتك الحافلة. ملاحظة: إذا تجاوزت الفترة الزمنية الفاصلة 2^53 ملي ثانية، تكون هذه القيمة Number.POSITIVE_INFINITY.
stopCount	النوع:  number عدد المحطات من محطة المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، ولكنه يستثني محطة المغادرة. على سبيل المثال، إذا كان مسارك يبدأ من المحطة "أ" ويمرّ بالمحطتَين "ب" و"ج" ويصل إلى المحطة "د"، ستكون قيمة stopCount هي 3.
transitLine	النوع:  TransitLine optional معلومات عن خط النقل العام المستخدَم في الخطوة
tripShortText	النوع:  string optional النص الذي يظهر في الجداول الزمنية ولوحات الإعلانات لتحديد رحلة نقل عام للركاب. يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو tripShortText قطار Amtrak الذي يغادر سان خوسيه، كاليفورنيا في الساعة 15:10 في أيام الأسبوع إلى ساكرامنتو، كاليفورنيا.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

فئة TransitLine

صف واحد (google.maps.routes.TransitLine)

معلومات عن خط نقل عام

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {TransitLine} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
agencies	النوع:  Array<TransitAgency> مؤسسات النقل العام التي تشغّل خط النقل العام هذا
color	النوع:  string optional اللون المستخدَم عادةً في اللافتات لهذا الخط يتم تمثيلها بنظام العد الستة عشري.
iconURL	النوع:  URL optional عنوان URL للرمز المرتبط بهذا السطر.
name	النوع:  string optional الاسم الكامل لخط النقل العام هذا، على سبيل المثال، "8 Avenue Local".
shortName	النوع:  string optional الاسم المختصر لخط النقل العام هذا يكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355".
textColor	النوع:  string optional اللون المستخدَم عادةً في النص على اللافتات لهذا الخط يتم تمثيلها بنظام العد الستة عشري.
url	النوع:  URL optional عنوان URL لخط النقل العام هذا كما تقدّمه مؤسسة النقل العام
vehicle	النوع:  TransitVehicle optional نوع المركبة التي تعمل على خط النقل العام هذا

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى عنصر.

واجهة TransitPreference

واجهة google.maps.routes.TransitPreference

الإعدادات المفضّلة للمسارات المستندة إلى TRANSIT والتي تؤثر في المسار الذي يتم عرضه

الخصائص
allowedTransitModes optional	النوع:  Iterable<TransitMode> optional مجموعة من أوضاع السفر التي يمكن استخدامها عند الحصول على مسار TRANSIT. يتم ضبط جميع وسائل النقل المتوافقة تلقائيًا.
routingPreference optional	النوع:  TransitRoutePreference optional تمثّل هذه السمة تفضيل المسار الذي يؤثر في مسار TRANSIT الذي يتم عرضه عند تحديده.

فئة TransitStop

صف واحد (google.maps.routes.TransitStop)

معلومات عن محطة نقل عام

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {TransitStop} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
location	النوع:  DirectionalLocation optional موقع المحطة الجغرافي المعبَّر عنه بإحداثيات خطوط العرض/الطول وعنوان اختياري
name	النوع:  string optional اسم محطة النقل العام

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

فئة 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 يتم تحويله إلى عنصر.

ثوابت VehicleEmissionType

ذكرياتك الثابتة في شهر google.maps.routes.VehicleEmissionType

مجموعة من القيم التي تصف نوع انبعاثات المركبة ينطبق ذلك على وضع السفر "DRIVING" فقط.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {VehicleEmissionType} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
DIESEL	مركبة تعمل بالديزل
ELECTRIC	مركبة تعمل بالكهرباء
GASOLINE	مركبة تعمل بالبنزين
HYBRID	مركبة تعمل بالوقود الهجين (مثل البنزين والكهرباء)

VehicleInfo interface

واجهة google.maps.routes.VehicleInfo

يحتوي على معلومات المركبة، مثل نوع انبعاثات المركبة.

الخصائص
emissionType optional	النوع:  VehicleEmissionType optional تصف هذه السمة نوع انبعاثات المركبة. ينطبق ذلك على وضع السفر "DRIVING" فقط.

واجهة Waypoint

واجهة google.maps.routes.Waypoint

تمثّل نقطة على المسار.

الخصائص
location	النوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place الموقع الجغرافي للنقطة على المسار قد تكون السلسلة عنوانًا أو رمز Plus Codes أو اسم مورد مكان.
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 لتقديم تفاصيل عن محطات التوقف في ذلك الجزء من الرحلة. اضبط هذه القيمة على true عندما تريد أن يمر المسار عبر هذه النقطة على المسار بدون التوقف عندها. لا تؤدي نقاط المسار العابرة إلى إضافة إدخال إلى مصفوفة Route.legs، ولكنّها توجّه الرحلة عبر نقطة المسار. ملاحظات: يمكنك ضبط هذه القيمة فقط على نقاط المسار الوسيطة. سيتعذّر تنفيذ الطلب إذا ضبطت هذا الحقل على نقاط المسار النهائية. إذا تم ضبط ComputeRoutesRequest.optimizeWaypointOrder على true، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيتعذّر تنفيذ الطلب.

واجهة WaypointMarkerDetails

واجهة google.maps.routes.WaypointMarkerDetails

تفاصيل حول نقطة على المسار يمكن استخدامها لتخصيص نمط محدّد الموقع

الخصائص
index	النوع:  number فهرس العلامة
totalMarkers	النوع:  number إجمالي عدد العلامات في المسار
leg optional	النوع:  RouteLeg optional تمثّل هذه السمة المرحلة التي تنتمي إليها العلامة. تكون فارغة إذا لم يتضمّن المسار أي مراحل.