Route (beta)

فئة المسار

google.maps.routes.Route صف

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Route} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
computeRoutes
computeRoutes(request)
المَعلمات: 
قيمة العائد:  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 لأول نقطة طريق وسيطة يتم تقديمها في الإدخال.

على سبيل المثال، إذا أدخلت القيمة التالية:
  • المصدر: LA
  • نقاط توقّف متوسطة: دالاس، بانغور، فينيكس
  • الوجهة: نيويورك
وترتيب نقاط الطريق الوسيطة المحسّن هو فينيكس ودالاس وبانغور، سيكون هذا الحقل [2, 0, 1].
path
النوع:  Array<LatLngAltitude> optional
قائمة LatLngAltitudes الخاصة بالمسار، والتي يمكن استخدامها لرسم خطوط متعددة الأضلاع للمسار يمكن التحكّم في مستوى تفصيل المسار من خلال ضبط ComputeRoutesRequest.polylineQuality.
polylineDetails
النوع:  PolylineDetails optional
تحتوي على معلومات حول التفاصيل على طول المسار.
routeLabels
النوع:  Array<RouteLabel> optional
تصنيفات المسار المفيدة لتحديد خصائص معيّنة للمقارنة مع غيرها
routeToken
النوع:  string optional
رمز مميّز غير شفاف يمكن تمريره إلى Navigation 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])
المَعلمات: 
قيمة العائد:  Array<Polyline>
تنشئ هذه الطريقة خطوطًا متعددة الأضلاع للمسار استنادًا إلى البيانات المتاحة.

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

المضلّعات المتعددة الخاصة بحركة المرور:
  • المتطلبات:
  • تُنشئ هذه السمة خطًا متعدد الأضلاع لكل فترة مسار عندما تختلف قراءة السرعة عن الفترة السابقة. يتم تطبيق نمط تلقائي مستند إلى السرعة على الخطوط المتعددة. يمكن تمرير الخيارات لتغيير نمط الخط المتعدد بناءً على السرعة.

خطوط متعدّدة بشكل عام:
  • المتطلبات:
  • تنشئ هذه الطريقة خطًا متعدد الأضلاع واحدًا للمسار بأكمله مع تطبيق التنسيق التلقائي. يمكن تمرير الخيارات لتغيير نمط الخط المتعدد الأضلاع استنادًا إلى وضع السفر في المسار. لمزيد من التخصيص، يمكنك إنشاء خطوط متعددة الأضلاع مباشرةً باستخدام Route.path أو RouteLeg.path.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
المَعلمات: 
قيمة العائد:  Promise<Array<AdvancedMarkerElement>>
تنشئ هذه السمة علامات للمسار تحمل التصنيف "أ" و"ب" و"ج" وما إلى ذلك لكل نقطة طريق. يتم تطبيق نمط تلقائي على العلامات. يمكن تمرير الخيارات لتغيير نمط العلامة استنادًا إلى فهرس العلامة أو خصائص RouteLeg المقابلة. ستكون المَعلمة WaypointMarkerDetails.leg غير محدّدة إذا لم يكن للمسار أي أجزاء.

يجب طلب الحقل "legs" في ComputeRoutesRequest.fields من أجل تضمين نقاط المرور الوسيطة.
toJSON
toJSON()
المَعلمات:  بدون
قيمة العائد:  Object
يتم تحويلها إلى عنصر.

ComputeRoutesRequest interface

google.maps.routes.ComputeRoutesRequest interface

طلب مسارات
destination
تمثّل هذه السمة وجهة المسار. قد تكون القيمة التي يتم تمريرها كسلسلة عنوانًا أو رمز موقع مفتوح أو اسم مورد "مكان". لا يتم أخذ قيم الارتفاع في الاعتبار عند احتساب المسارات.
fields
النوع:  Iterable<string>
مجموعة الحقول المطلوب استرجاعها. حدِّد ["*"] لجميع الحقول.
origin
نقطة انطلاق المسار قد تكون القيمة التي يتم تمريرها كسلسلة عنوانًا أو رمز موقع مفتوح أو اسم مورد "مكان". لا يتم أخذ قيم الارتفاع في الاعتبار عند احتساب المسارات.
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. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج اللغة من إعدادات الترجمة في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". وفي الحالات الأخرى، يتم استنتاج اللغة من موقع الأصل.
optimizeWaypointOrder optional
النوع:  boolean optional
إذا تم ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط المرور الوسيطة المحدّدة. يتعذّر تنفيذ الطلب إذا كانت أي من نقاط الطريق الوسيطة هي نقطة طريق عبر. استخدِم Route.optimizedIntermediateWaypointIndices في الردّ للعثور على الترتيب الجديد. إذا لم يتم طلب "optimizedIntermediateWaypointIndices" في ComputeRoutesRequest.fields، سيتعذّر تنفيذ الطلب. في حال ضبطها على "خطأ"، سيكون الحقل Route.optimizedIntermediateWaypointIndices في الردّ فارغًا.
polylineQuality optional
النوع:  PolylineQuality optional
تحدّد هذه السمة الإعداد المفضّل لجودة الخط المتعدد الأضلاع.
region optional
النوع:  string optional
رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. عند عدم تقديم هذه القيمة، يتم استنتاج المنطقة من إعدادات اللغة في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". وفي الحالات الأخرى، يتم استنتاج المنطقة من موقع الأصل.
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 interface

يتم قبول عناصر JSON بدلاً من مثيلات DirectionalLocation لتسهيل الاستخدام. يتم تحويلها إلى DirectionalLocation عندما تصادفها واجهة برمجة التطبيقات JavaScript لـ "خرائط Google".

توسّع هذه الواجهة 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
وضع التوجيه المستخدَم في الردّ. في حال تم تفعيل وضع احتياطي، قد يختلف الوضع عن إعدادات التوجيه المفضّلة في طلب العميل الأصلي.

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

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

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

تتضمّن هذه الفئة مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب المسارات.
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 interface

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

واجهة RoutePolylineOptions

google.maps.routes.RoutePolylineOptions interface

خيارات لإنشاء خطوط متعددة الأضلاع للمسارات
colorScheme optional
النوع:  ColorScheme optional
نظام الألوان الذي سيتم استخدامه للخط المتعدد الأضلاع عندما يتم ضبطها على FOLLOW_SYSTEM بينما تكون الخريطة colorScheme أيضًا FOLLOW_SYSTEM، سيتم رسم الخطوط المتعددة في وضع التنسيق الداكن أو الفاتح نفسه للخريطة. في حال عدم تحديدها، يحاول Route.createPolylines استخدام colorScheme للخريطة أو يعود إلى الإعداد التلقائي للنظام.
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 interface

تجمّع هذه السمة LatLngAltitudes لفترة زمنية في مسار مع قراءة السرعة لهذه الفترة.
path
النوع:  Array<LatLngAltitude>
المسار الذي يغطيه مسار السرعة هذا
speed optional
النوع:  Speed optional
سرعة قراءة المسار

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

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"
shortName
النوع:  string optional
الاسم المختصر لخط النقل العام هذا سيكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355".
textColor
النوع:  string optional
اللون المستخدَم عادةً في النص على اللافتات الخاصة بهذا الخط يتم تمثيله بنظام الأرقام السداسية العشرية.
url
النوع:  URL optional
تمثّل هذه السمة عنوان URL لخط النقل العام هذا كما تقدّمه مؤسسة النقل العام.
vehicle
النوع:  TransitVehicle optional
نوع المركبة التي تعمل على خط النقل العام هذا
toJSON
toJSON()
المَعلمات:  بدون
قيمة العائد:  Object
يتم تحويلها إلى عنصر.

واجهة TransitPreference

google.maps.routes.TransitPreference interface

الإعدادات المفضّلة للمسارات المستندة إلى 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

google.maps.routes.VehicleInfo interface

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

واجهة Waypoint

google.maps.routes.Waypoint interface

تمثّل هذه السمة نقطة طريق في مسار.
location
الموقع الجغرافي لنقطة الطريق قد تكون السلسلة عنوانًا أو رمز 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 interface

google.maps.routes.WaypointMarkerDetails interface

تفاصيل حول نقطة طريق يمكن استخدامها لتخصيص نمط العلامة
index
النوع:  number
فهرس العلامة.
totalMarkers
النوع:  number
تمثّل هذه السمة إجمالي عدد العلامات في المسار.
leg optional
النوع:  RouteLeg optional
تمثّل هذه السمة الجزء الذي ينتمي إليه المؤشر. يكون هذا الحقل فارغًا إذا لم يكن للمسار أي أجزاء.