Method: computeRoutes

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

ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. يمكنك الاطّلاع على مستندات مفصّلة حول كيفية إنشاء مسارات الحقول.

على سبيل المثال، في هذه الطريقة:

  • قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
  • قناع الحقل الخاص بالمدة والمسافة والمضلّع على مستوى المسار (مثال على إعداد الإنتاج): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*) أو تحديد قناع الحقل على المستوى الأعلى (routes)، وذلك للأسباب التالية:

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

طلب HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
الحقول
origin

object (Waypoint)

الحقل مطلوب. نقطة الانطلاق على المسار
destination

object (Waypoint)

الحقل مطلوب. نقطة على المسار للوجهة
intermediates[]

object (Waypoint)

اختيارية: مجموعة من نقاط المرور على طول الطريق (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها يمكن إضافة ما يصل إلى 25 نقطة توقّف وسيطة.
travelMode

enum (RouteTravelMode)

اختيارية: تحدّد هذه السمة وسيلة النقل.
routingPreference

enum (RoutingPreference)

اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام خيار التوجيه المفضّل المحدّد لاحتساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة travelMode هي DRIVE أو TWO_WHEELER، وإلا سيفشل الطلب.
polylineQuality

enum (PolylineQuality)

اختيارية: تحدّد هذه السمة إعداداتك المفضّلة لجودة الخط المتعدد الأضلاع.
polylineEncoding

enum (PolylineEncoding)

اختيارية: تحدّد هذه السمة الترميز المفضّل للخط المتعدد الأضلاع.
departureTime

string (Timestamp format)

اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. ملاحظة: يمكنك تحديد departureTime في الماضي فقط عندما يكون RouteTravelMode مضبوطًا على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
arrivalTime

string (Timestamp format)

اختيارية: وقت الوصول ملاحظة: يتم تجاهل هذا الحقل عندما تحدّد الطلبات قيمة RouteTravelMode غير TRANSIT. يمكنك تحديد departureTime أو arrivalTime، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
computeAlternativeRoutes

boolean

اختيارية: تحدّد هذه السمة ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض طرق بديلة للطلبات التي تتضمّن نقاط توقّف وسيطة.
routeModifiers

object (RouteModifiers)

اختيارية: مجموعة من الشروط التي يجب استيفاؤها وتؤثر في طريقة احتساب المسارات
languageCode

string

اختيارية: رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.
regionCode

string

اختيارية: رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين ضمن ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد.
units

enum (Units)

اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. تشمل هذه الحقول الحقل instruction في NavigationInstruction. لا تتأثر وحدات القياس المستخدَمة للمسار والجزء والخطوة والمسافة والمدة بهذه القيمة. في حال عدم تقديم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للمصدر الأول.
optimizeWaypointOrder

boolean

اختيارية: إذا تم ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط المرور الوسيطة المحدّدة. يتعذّر تنفيذ الطلب إذا كانت أي من نقاط الطريق الوسيطة هي نقطة طريق via. استخدِم ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index للعثور على الترتيب الجديد. إذا لم يتم طلب ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index في العنوان X-Goog-FieldMask، سيتعذّر تنفيذ الطلب. في حال ضبط optimizeWaypointOrder على "خطأ"، سيكون ComputeRoutesResponse.optimized_intermediate_waypoint_index فارغًا.
requestedReferenceRoutes[]

enum (ReferenceRoute)

اختيارية: تحدّد هذه السمة مسارات المراجع التي سيتم احتسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار يختلف عن المسار التلقائي في الهدف من حساب المسار. على سبيل المثال، تأخذ عملية حساب FUEL_EFFICIENT مسار مرجعي في الاعتبار مَعلمات مختلفة من شأنها إنشاء مسار مثالي موفّر للوقود. عند استخدام هذه الميزة، ابحث عن routeLabels في المسارات الناتجة.
extraComputations[]

enum (ExtraComputation)

اختيارية: قائمة بعمليات حسابية إضافية يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ.
trafficModel

enum (TrafficModel)

اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في الزيارات. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في Route وRouteLeg الذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر ميزة TrafficModel إلا للطلبات التي تم ضبط RoutingPreference على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE. يتم ضبط القيمة تلقائيًا على BEST_GUESS في حال طلب الزيارات وعدم تحديد TrafficModel.
transitPreferences

object (TransitPreferences)

اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكنك تحديد transitPreferences إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT.

نص الاستجابة

v2.computeRoutes هي رسالة الردّ.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
الحقول
routes[]

object (Route)

تحتوي على مصفوفة من المسارات المحسوبة (بحد أقصى ثلاثة) عند تحديد compute_alternatives_routes، وتحتوي على مسار واحد فقط عند عدم تحديدها. عندما تحتوي هذه المصفوفة على إدخالات متعددة، يكون الإدخال الأول هو المسار الأكثر اقتراحًا. إذا كانت المصفوفة فارغة، يعني ذلك أنّه لم يتم العثور على أي مسار.
fallbackInfo

object (FallbackInfo)

في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب نتائج المسار باستخدام جميع الإعدادات المفضّلة المُدخَلة، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع الاسترجاع، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يكون هذا الحقل غير مضبوط.
geocodingResults

object (GeocodingResults)

يحتوي على معلومات ردّ الترميز الجغرافي لنقاط الطريق المحدّدة كعناوين.

PolylineQuality

مجموعة من القيم التي تحدّد جودة الخط المتعدد الأضلاع.

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

PolylineEncoding

تحدّد هذه السمة النوع المفضّل من الخطوط المتعددة الأضلاع المطلوب عرضه.

عمليات التعداد
POLYLINE_ENCODING_UNSPECIFIED لم يتم تحديد أي إعدادات مفضّلة لنوع الخط المتعدد. القيمة التلقائية هي ENCODED_POLYLINE.
ENCODED_POLYLINE تحدّد هذه السمة خطًا متعدد الأضلاع تم ترميزه باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
GEO_JSON_LINESTRING تحدّد خطًا متعدد الأضلاع باستخدام تنسيق GeoJSON LineString

ReferenceRoute

مسار مرجعي متوافق في ComputeRoutesRequest

عمليات التعداد
REFERENCE_ROUTE_UNSPECIFIED لم يتم الاستخدام. لن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
FUEL_EFFICIENT المسار الأقل استهلاكًا للوقود
SHORTER_DISTANCE

المسار الذي يتضمّن مسافة سفر أقصر هذه ميزة تجريبية.

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

بالنسبة إلى طلبات BICYCLE وTWO_WHEELER، تعرض هذه الميزة طرقًا مشابهة لتلك التي يتم عرضها عند عدم تحديد requestedReferenceRoutes.

لا تتوافق هذه الميزة مع أي وسائل نقل أخرى أو نقاط توقّف وسيطة أو optimizeWaypointOrder، وستتعذّر معالجة هذه الطلبات. ومع ذلك، يمكنك استخدامه مع أي routingPreference.

ExtraComputation

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب قد تتم إضافة قيم إضافية في المستقبل.

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED لم يتم الاستخدام. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
TOLLS معلومات رسوم المرور للمسارات
FUEL_CONSUMPTION استهلاك الوقود المقدَّر للمسارات
TRAFFIC_ON_POLYLINE خطوط متعددة الأضلاع تراعي حركة المرور للمسارات
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction معروضة كسلسلة نصية منسَّقة بتنسيق HTML. يجب قراءة هذا المحتوى كما هو، وهو مخصّص للعرض فقط. يجب عدم تحليلها آليًا.
FLYOVER_INFO_ON_POLYLINE معلومات عن المشاهدة الجوية للمسارات يجب تحديد routes.polyline_details.flyover_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المناطق المركزية في الهند. هذه الميزة تجريبية، وقد يتغيّر رمز التخزين التعريفي/الرسوم.
NARROW_ROAD_INFO_ON_POLYLINE معلومات عن الطرق الضيقة للمسارات يجب تحديد routes.polyline_details.narrow_road_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المناطق المركزية في الهند. هذه الميزة تجريبية، وقد يتغيّر رمز التخزين التعريفي/الرسوم.
TUNNEL_INFO_ON_POLYLINE تعرض هذه السمة معلومات عن الأنفاق في المسارات. يجب تحديد routes.polyline_details.tunnel_info fieldmask لعرض هذه المعلومات.
BRIDGE_INFO_ON_POLYLINE معلومات الجسر للمسارات. يجب تحديد routes.polyline_details.bridge_info fieldmask لعرض هذه المعلومات.
SKYWAY_INFO_ON_POLYLINE معلومات حول الجسور الجوية للمسارات يجب تحديد routes.polyline_details.skyway_info fieldmask لعرض هذه المعلومات.

مسار

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

تمثيل JSON 
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
الحقول
routeLabels[]

enum (RouteLabel)

تصنيفات Route مفيدة لتحديد خصائص معيّنة للمسار من أجل مقارنتها بمسارات أخرى.
legs[]

object (RouteLeg)

مجموعة من الأجزاء (أجزاء المسار بين نقاط المرور) التي تشكّل المسار. يتوافق كل جزء مع الرحلة بين نقطتَي via Waypoints. على سبيل المثال، يتضمّن المسار الذي لا يحتوي على نقاط طريق وسيطة مرحلة واحدة فقط. يتضمّن المسار الذي يتضمّن نقطة على المسار وسيطة واحدة غير via جزأين. يتضمّن المسار الذي يشمل نقطة طريق وسيطة واحدة via جزءًا واحدًا. يتطابق ترتيب الأجزاء مع ترتيب نقاط الطريق من origin إلى intermediates إلى destination.
distanceMeters

integer

تمثّل هذه السمة مسافة السفر للمسار بالأمتار.
duration

string (Duration format)

تمثّل هذه السمة المدة الزمنية اللازمة للتنقّل على طول المسار. إذا ضبطت routingPreference على TRAFFIC_UNAWARE، ستكون هذه القيمة هي نفسها قيمة staticDuration. إذا ضبطت routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
staticDuration

string (Duration format)

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

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

الخطوط المتعددة للمسار بشكل عام هذا الخط المتعدد الأضلاع هو الخط المتعدد الأضلاع المدمج لجميع legs.
description

string

تمثّل هذه السمة وصفًا للمسار.
warnings[]

string

مصفوفة من التحذيرات التي يجب عرضها عند عرض المسار
viewport

object (Viewport)

مربّع الحدود الخاص بإطار العرض للخط المتعدد
travelAdvisory

object (RouteTravelAdvisory)

معلومات إضافية حول المسار
optimizedIntermediateWaypointIndex[]

integer

في حال ضبط optimizeWaypointOrder على "صحيح"، يحتوي هذا الحقل على الترتيب المحسّن لنقاط المرور الوسيطة. وفي ما عدا ذلك، يكون هذا الحقل فارغًا. على سبيل المثال، إذا أدخلت "نقطة الانطلاق: لوس أنجلوس" و"نقاط التوقف الوسيطة: دالاس، بانغور، فينيكس" و"نقطة الوصول: نيويورك" وكان ترتيب نقاط التوقف الوسيطة المحسّن هو "فينيكس، دالاس، بانغور"، سيحتوي هذا الحقل على القيم [2, 0, 1]. يبدأ الفهرس بالرقم 0 لنقطة الطريق الوسيطة الأولى المقدَّمة في الإدخال.
localizedValues

object (RouteLocalizedValues)

تمثيلات نصية لسمات Route
routeToken

string

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

ملاحظة: لا تتوفّر Route.route_token إلا للطلبات التي تم ضبط ComputeRoutesRequest.routing_preference فيها على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. لا تتوافق Route.route_token مع الطلبات التي تتضمّن نقاط توقّف.
polylineDetails

object (PolylineDetails)

تحتوي على معلومات حول التفاصيل على طول الخط المتعدد.

RouteLabel

تصنيفات Route مفيدة لتحديد خصائص معيّنة للمسار من أجل مقارنتها بمسارات أخرى.

عمليات التعداد
ROUTE_LABEL_UNSPECIFIED تلقائي - غير مستخدَم
DEFAULT_ROUTE المسار "الأفضل" التلقائي الذي تم عرضه عند احتساب المسار
DEFAULT_ROUTE_ALTERNATE مسار بديل للمسار "الأفضل" التلقائي سيتم عرض مسارات مشابهة عند تحديد computeAlternativeRoutes.
FUEL_EFFICIENT المسار الأقل استهلاكًا للوقود يتم تحديد المسارات المصنّفة بهذه القيمة على أنّها محسّنة لمَعلمات الوضع الاقتصادي، مثل استهلاك الوقود.
SHORTER_DISTANCE مسار أقصر من حيث مسافة السفر هذه ميزة تجريبية.

RouteLeg

يحتوي على جزء بين نقاط طريق غير via

تمثيل JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
الحقول
distanceMeters

integer

تمثّل هذه السمة مسافة التنقّل في جزء المسار، وذلك بالأمتار.
duration

string (Duration format)

مدة الوقت اللازمة للتنقّل في الجزء من الرحلة إذا تم ضبط route_preference على TRAFFIC_UNAWARE، تكون هذه القيمة هي نفسها staticDuration. إذا كانت قيمة route_preference هي TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
staticDuration

string (Duration format)

تشير هذه السمة إلى مدة الرحلة خلال الجزء من الطريق، ويتم احتسابها بدون أخذ حالة حركة المرور في الاعتبار.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

الخطوط المتعددة الإجمالية لهذه الرحلة التي تتضمّن الخطوط المتعددة لكل step.
startLocation

object (Location)

تمثّل هذه السمة الموقع الجغرافي لنقطة بداية هذا الجزء من الرحلة. قد يختلف هذا الموقع الجغرافي عن origin المقدَّمة. على سبيل المثال، عندما لا يكون origin المقدَّم بالقرب من طريق، تكون هذه نقطة على الطريق.
endLocation

object (Location)

تمثّل هذه السمة الموقع الجغرافي النهائي لهذه المرحلة. قد يختلف هذا الموقع الجغرافي عن destination المقدَّمة. على سبيل المثال، عندما لا يكون destination المقدَّم بالقرب من طريق، تكون هذه نقطة على الطريق.
steps[]

object (RouteLegStep)

مصفوفة من الخطوات تشير إلى شرائح ضمن هذا الجزء من الرحلة تمثّل كل خطوة تعليمات تنقّل واحدة.
travelAdvisory

object (RouteLegTravelAdvisory)

يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة الزيارات، في جزء من المسار.
localizedValues

object (RouteLegLocalizedValues)

تمثيلات نصية لسمات RouteLeg
stepsOverview

object (StepsOverview)

معلومات عامة حول الخطوات الواردة في RouteLeg هذا لا تتم تعبئة هذا الحقل إلا لمسارات النقل العام.

خط متعدد

تتضمّن هذه الفئة خطًا متعدّد الأضلاع مرمّزًا.

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
الحقول
تتضمّن هذه السمة نوع الخط المتعدد الأضلاع. القيمة التلقائية هي encoded_polyline. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
encodedPolyline

string

تمثّل هذه السمة الترميز السلسلة لخط متعدد الأضلاع باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
geoJsonLinestring

object (Struct format)

تحدّد هذه السمة خطًا متعدد الأجزاء باستخدام تنسيق GeoJSON LineString.
نهاية الحقول التي يستبعد كلّ منها الآخر

RouteLegStep

يحتوي على جزء من RouteLeg. تمثّل الخطوة تعليمات تنقّل واحدة. تتكوّن أجزاء المسار من خطوات.

تمثيل JSON 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
الحقول
distanceMeters

integer

تمثّل هذه السمة مسافة التنقّل لهذه الخطوة بالمتر. في بعض الحالات، قد لا يتضمّن هذا الحقل قيمة.
staticDuration

string (Duration format)

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

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

تمثّل هذه السمة الخط المتعدد الأضلاع المرتبط بهذه الخطوة.
startLocation

object (Location)

تمثّل هذه السمة الموقع الجغرافي لنقطة البداية لهذه الخطوة.
endLocation

object (Location)

الموقع الجغرافي النهائي لهذه الخطوة
navigationInstruction

object (NavigationInstruction)

تعليمات التنقّل
travelAdvisory

object (RouteLegStepTravelAdvisory)

يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور، في خطوة جزء الرحلة.
localizedValues

object (RouteLegStepLocalizedValues)

تمثيلات نصية لسمات RouteLegStep
transitDetails

object (RouteLegStepTransitDetails)

تفاصيل متعلقة بهذه الخطوة إذا كان وضع التنقّل هو TRANSIT
travelMode

enum (RouteTravelMode)

تمثّل هذه السمة وسيلة النقل المستخدَمة في هذه الخطوة.

المناورة

مجموعة من القيم التي تحدّد إجراء التنقّل الذي يجب اتّخاذه في الخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو الاستمرار في السير بشكل مستقيم)

عمليات التعداد
MANEUVER_UNSPECIFIED لم يتم الاستخدام.
TURN_SLIGHT_LEFT اتّجِه قليلاً نحو اليسار.
TURN_SHARP_LEFT اتّجِه يسارًا بشكل حاد.
UTURN_LEFT يُرجى الدوران للاتجاه المعاكس يسارًا.
TURN_LEFT اتّجه يسارًا.
TURN_SLIGHT_RIGHT اتّجه قليلاً نحو اليمين.
TURN_SHARP_RIGHT انعطِف بشدة إلى اليمين.
UTURN_RIGHT يُرجى الدوران إلى اليمين والعودة إلى الاتجاه المعاكس.
TURN_RIGHT اتّجه يمينًا.
STRAIGHT اتّبِع الطريق المستقيم.
RAMP_LEFT اسلك الطريق المنحدر الأيسر.
RAMP_RIGHT اسلك الطريق المنحدر الأيمن.
MERGE الاندماج في حركة المرور
FORK_LEFT اتّبِعوا الطريق المتفرّع على اليسار.
FORK_RIGHT اتّبِع الطريق المتفرّع على اليمين.
FERRY استقلّ العبّارة.
FERRY_TRAIN استقلّ القطار الذي يؤدي إلى العبّارة.
ROUNDABOUT_LEFT اتّجِه يسارًا عند الدوّار.
ROUNDABOUT_RIGHT اتّجِه يمينًا عند الدوّار.
DEPART المناورة الأولية
NAME_CHANGE تُستخدَم للإشارة إلى تغيير اسم شارع.
DESTINATION تُستخدَم للإشارة إلى الوصول إلى وجهة.

RouteLegStepTravelAdvisory

يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور في خطوة من الرحلة.

تمثيل JSON 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
الحقول
speedReadingIntervals[]

object (SpeedReadingInterval)

ملاحظة: هذا الحقل غير مملوء حاليًا.

RouteLegStepLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

تمثيل JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
الحقول
distance

object (LocalizedText)

المسافة المقطوعة ممثّلة في شكل نص.
staticDuration

object (LocalizedText)

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

RouteLegStepTransitDetails

معلومات إضافية عن RouteLegStep ذات صلة بمسارات TRANSIT

تمثيل JSON 
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
الحقول
stopDetails

object (TransitStopDetails)

معلومات حول محطات الوصول والمغادرة للخطوة
localizedValues

object (TransitDetailsLocalizedValues)

تمثيلات نصية لسمات RouteLegStepTransitDetails
headsign

string

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

string (Duration format)

تحدّد هذه السمة الوقت المتوقّع كمدة زمنية بين عمليات المغادرة من المحطة نفسها في هذا الوقت. على سبيل المثال، إذا كانت قيمة ثواني الفاصل الزمني 600، من المتوقّع أن تنتظر عشر دقائق إذا فاتتك الحافلة.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
transitLine

object (TransitLine)

معلومات حول خط النقل العام المستخدَم في هذه الخطوة
stopCount

integer

عدد المحطات من محطة المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، ولكن لا يشمل محطة المغادرة. على سبيل المثال، إذا كان مسارك يبدأ من المحطة A ويمر بالمحطتين B وC ويصل إلى المحطة D، ستعرض stopCount القيمة 3.
tripShortText

string

النص الذي يظهر في الجداول الزمنية ولوحات الإشارات لتحديد رحلة النقل العام للركاب يجب أن يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو tripShortText لقطار Amtrak الذي يغادر سان خوسيه، كاليفورنيا في الساعة 15:10 في أيام الأسبوع إلى ساكرامنتو، كاليفورنيا.

TransitStopDetails

تعرض هذه السمة تفاصيل حول محطات النقل العام في RouteLegStep.

تمثيل JSON 
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
الحقول
arrivalStop

object (TransitStop)

معلومات حول محطة الوصول الخاصة بالخطوة
arrivalTime

string (Timestamp format)

الوقت المقدَّر للوصول إلى الخطوة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
departureStop

object (TransitStop)

تمثّل هذه السمة معلومات حول محطة المغادرة للخطوة.
departureTime

string (Timestamp format)

الوقت المقدَّر للمغادرة في هذه الخطوة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

TransitStop

تمثّل هذه السمة معلومات حول محطة نقل عام.

تمثيل JSON 
{
  "name": string,
  "location": {
    object (Location)
  }
}
الحقول
name

string

تمثّل هذه السمة اسم محطة النقل العام.
location

object (Location)

الموقع الجغرافي للمحطة معبَّرًا عنه بإحداثيات خط العرض/خط الطول

TransitDetailsLocalizedValues

أوصاف مترجَمة للقيم في RouteTransitDetails

تمثيل JSON 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
الحقول
arrivalTime

object (LocalizedTime)

الوقت في تمثيله النصي المنسّق مع منطقة زمنية مقابلة
departureTime

object (LocalizedTime)

الوقت في تمثيله النصي المنسّق مع منطقة زمنية مقابلة

LocalizedTime

وصف مترجَم للوقت

تمثيل JSON 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
الحقول
time

object (LocalizedText)

الوقت المحدّد كسلسلة في منطقة زمنية معيّنة
timeZone

string

تحتوي هذه السمة على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA)، مثل "America/New_York".

TransitLine

يحتوي على معلومات حول خط النقل العام المستخدَم في هذه الخطوة.

تمثيل JSON 
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
الحقول
agencies[]

object (TransitAgency)

مؤسسة (أو مؤسسات) النقل العام التي تشغّل خط النقل العام هذا
name

string

الاسم الكامل لخط النقل العام هذا، مثل "الخط المحلي على الجادة 8"
uri

string

تمثّل هذه السمة المعرّف الموحّد للموارد (URI) لخط النقل العام هذا كما تقدّمه مؤسسة النقل العام.
color

string

اللون المستخدَم عادةً في اللوحات الإرشادية لهذا الخط يتم تمثيله بنظام العد الستة عشري.
iconUri

string

تمثّل هذه السمة معرّف URI للرمز المرتبط بهذا السطر.
nameShort

string

الاسم المختصر لخط النقل العام هذا. سيكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355".
textColor

string

اللون المستخدَم عادةً في النص على اللافتات الخاصة بهذا الخط يتم تمثيله بنظام العد الستة عشري.
vehicle

object (TransitVehicle)

تمثّل هذه السمة نوع المركبة التي تعمل على خط النقل العام هذا.

TransitAgency

مؤسسة نقل عام تشغّل خط نقل عام

تمثيل JSON 
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
الحقول
name

string

تمثّل هذه السمة اسم مؤسسة النقل العام.
phoneNumber

string

رقم الهاتف المنسّق الخاص بمؤسسة النقل العام بما يتوافق مع اللغة المحلية.
uri

string

معرّف الموارد المنتظم (URI) لمؤسسة النقل العام

TransitVehicle

معلومات عن مركبة مستخدَمة في مسارات النقل العام

تمثيل JSON 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
الحقول
name

object (LocalizedText)

اسم هذه المركبة، مكتوبًا بالأحرف الكبيرة
type

enum (TransitVehicleType)

نوع المركبة المستخدَمة
iconUri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لرمز مرتبط بنوع المركبة هذا.
localIconUri

string

تمثّل هذه السمة معرّف الموارد الموحّد (URI) للرمز المرتبط بنوع المركبة هذا، استنادًا إلى لوحات النقل المحلية.

TransitVehicleType

تعرض هذه السمة نوع المركبات التي تسير على مسارات النقل العام.

عمليات التعداد
TRANSIT_VEHICLE_TYPE_UNSPECIFIED غير مستخدَمة
BUS حافلة
CABLE_CAR مركبة تعمل على كابل، وعادةً ما تكون على الأرض قد تكون العربات المعلقة من النوع GONDOLA_LIFT.
COMMUTER_TRAIN القطارات السريعة
FERRY عبّارة
FUNICULAR مركبة يتم سحبها إلى أعلى منحدر شديد بواسطة كابل يتألف القطار المعلق عادةً من عربتَين، وتعمل كل عربة كوزن موازن للأخرى.
GONDOLA_LIFT عربة تلفريك معلّقة
HEAVY_RAIL سكك حديدية ثقيلة
HIGH_SPEED_TRAIN قطار عالي السرعة
INTERCITY_BUS حافلة بين المدن
LONG_DISTANCE_TRAIN قطار مسافات طويلة
METRO_RAIL نظام النقل بالقطار الخفيف
MONORAIL قطار بخط حديدي واحد
OTHER جميع المركبات الأخرى
RAIL السكك الحديدية
SHARE_TAXI سيارة الأجرة المشتركة هي نوع من الحافلات يمكنها إقلال الركاب وتوصيلهم في أي مكان على مسارها.
SUBWAY قطار خفيف تحت الأرض
TRAM قطار خفيف فوق الأرض
TROLLEYBUS ترولي باص

RouteLegTravelAdvisory

يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها في خطوة جزء الرحلة، مثل القيود المحتملة على منطقة حركة المرور.

تمثيل JSON 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
الحقول
tollInfo

object (TollInfo)

تحتوي هذه السمة على معلومات حول رسوم المرور على RouteLeg المحدّد. لا تتم تعبئة هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على RouteLeg وتم تضمين TOLLS في ComputeRoutesRequest.extra_computations للطلب. في حال ضبط هذا الحقل بدون تعبئة الحقل الفرعي estimatedPrice، نتوقّع أن يتضمّن الطريق رسومًا ولكن لا نعرف السعر المقدّر. إذا لم يكن tollInfo متوفّرًا، يعني ذلك أنّه لا يتم تحصيل رسوم على RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

فواصل القراءة السريعة التي تشير إلى كثافة حركة المرور لا تتم تعبئة هذا الحقل إلا للطلبات التي تتضمّن القيمة TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference، ويتم تضمين TRAFFIC_ON_POLYLINE في ComputeRoutesRequest.extra_computations. تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع بالكامل في RouteLeg بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

تمثيل JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
الحقول
distance

object (LocalizedText)

المسافة المقطوعة ممثّلة في شكل نص.
duration

object (LocalizedText)

تمثّل هذه السمة المدة في شكل نصي ومعدَّلة بما يتناسب مع المنطقة التي تم فيها طلب البحث. تأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي القيمة نفسها التي تم ضبطها في staticDuration.
staticDuration

object (LocalizedText)

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

StepsOverview

تقدّم هذه السمة معلومات عامة عن قائمة RouteLegStep.

تمثيل JSON 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
الحقول
multiModalSegments[]

object (MultiModalSegment)

معلومات موجزة حول الأقسام المختلفة المتعدّدة الوسائط في RouteLeg.steps لا تتم تعبئة هذا الحقل إذا لم تتضمّن RouteLeg أي مقاطع متعددة الوسائط في الخطوات.

MultiModalSegment

تقدّم هذه السمة معلومات موجزة عن شرائح RouteLeg.steps المختلفة المتعددة الوسائط. يتم تعريف المقطع المتعدد الوسائط على أنّه واحد أو أكثر من RouteLegStep المتجاورة التي لها RouteTravelMode نفسه. لا تتم تعبئة هذا الحقل إذا لم تتضمّن RouteLeg أي مقاطع متعددة الوسائط في الخطوات.

تمثيل JSON 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
الحقول
navigationInstruction

object (NavigationInstruction)

NavigationInstruction للجزء المتعدّد الوسائط
travelMode

enum (RouteTravelMode)

وسيلة النقل المستخدَمة في الجزء المتعدد الوسائط
stepStartIndex

integer

فهرس RouteLegStep المقابل الذي يمثّل بداية مقطع متعدد الوسائط.
stepEndIndex

integer

فهرس RouteLegStep المقابل الذي يمثّل نهاية مقطع متعدد الوسائط.

إطار العرض

إطار عرض لخطوط الطول والعرض، ويتم تمثيله كنقطتَين متقابلتَين قطريًا low وhigh. يُعدّ إطار العرض منطقة مغلقة، أي أنّه يشمل حدوده. يجب أن تتراوح حدود خط العرض بين 90- و90 درجة، ويجب أن تتراوح حدود خط الطول بين 180- و180 درجة. تشمل الحالات المختلفة ما يلي:

  • إذا كان low = high، يتألف إطار العرض من تلك النقطة الواحدة.

  • إذا كانت قيمة low.longitude أكبر من high.longitude، يكون نطاق خط الطول معكوسًا (يعبر إطار العرض خط الطول 180 درجة).

  • إذا كانت low.longitude = -180 درجة وhigh.longitude = 180 درجة، ستشمل نافذة العرض جميع خطوط الطول.

  • إذا كانت low.longitude = 180 درجة وhigh.longitude = -180 درجة، يكون نطاق خط الطول فارغًا.

  • إذا كان low.latitude > high.latitude، يكون نطاق خطوط العرض فارغًا.

يجب ملء كل من low وhigh، ولا يمكن أن يكون المربع الممثَّل فارغًا (كما هو محدّد في التعريفات أعلاه). سيؤدي إطار العرض الفارغ إلى حدوث خطأ.

على سبيل المثال، يضمّ إطار العرض هذا مدينة نيويورك بالكامل:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

تمثيل JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
الحقول
low

object (LatLng)

الحقل مطلوب. النقطة السفلية لإطار العرض
high

object (LatLng)

الحقل مطلوب. النقطة العليا لإطار العرض

RouteLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

تمثيل JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
الحقول
distance

object (LocalizedText)

المسافة المقطوعة ممثّلة في شكل نص.
duration

object (LocalizedText)

تمثّل هذه السمة المدة في شكل نصي ومعدَّلة بما يتناسب مع المنطقة التي تم فيها طلب البحث. تأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي نفسها قيمة staticDuration.
staticDuration

object (LocalizedText)

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.
transitFare

object (LocalizedText)

تعرض هذه البطاقة أجرة النقل العام في شكل نص.

PolylineDetails

تفاصيل تتوافق مع فهرس أو جزء متجاور معيّن من خط متعدد الأضلاع بمعلومية خط متعدد الأضلاع يتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يبدأ من الصفر)، يحدّد PolylineDetails فترة زمنية وبيانات وصفية مرتبطة بها.

تمثيل JSON 
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
الحقول
tunnelInfo[]

object (TunnelInfo)

تفاصيل الأنفاق على طول الخط المتعدد يتم ملء هذا الحقل إذا كان الطلب يحدّد معدِّل المسار avoidTunnels ولم يتمكّن المسار الناتج من تجنُّبها، أو إذا تم تحديد TUNNEL_INFO_ON_POLYLINE في extraComputations وكان المسار يتضمّن أنفاقًا.
restrictionInfo[]

object (RestrictionInfo)

تفاصيل القيود على طول الخط المتعدد لا تتم تعبئة هذا الحقل إلا إذا كان الطلب يحدّد معدِّل المسار vehicleInfo وكان المسار الناتج يتضمّن قيودًا سارية. وفي ما عدا ذلك، لا يتم استخدام هذا الحقل.
flyoverInfo[]

object (FlyoverInfo)

تفاصيل التحليق فوق المسار المتعدد الأضلاع
narrowRoadInfo[]

object (NarrowRoadInfo)

تفاصيل الطريق الضيق على طول الخط المتعدد الأضلاع
bridgeInfo[]

object (BridgeInfo)

تفاصيل الجسر على طول الخط المتعدد
skywayInfo[]

object (SkywayInfo)

تفاصيل الطريق السريع على طول الخط المتعدد الأضلاع

TunnelInfo

تتضمّن هذه السمة معلومات عن الأنفاق على طول الخط المتعدد الأضلاع.

تمثيل JSON 
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
الحقول
tunnelPresence

enum (RoadFeatureState)

تشير إلى ما إذا كان هناك نفق لجزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

موقع المعلومات المتعلّقة بالنفق على طول الخط المتعدد

RoadFeatureState

تغليف حالات ميزات الطرق على طول جزء من خط متعدد

عمليات التعداد
ROAD_FEATURE_STATE_UNSPECIFIED لم يتم احتساب حالة ميزة الطريق (القيمة التلقائية).
EXISTS تتوفّر ميزة الطريق.
DOES_NOT_EXIST ميزة الطريق غير متوفّرة.

PolylinePointIndex

تتضمّن هذه السمة فهارس البدء والانتهاء لتفاصيل الخط المتعدد الأضلاع. في الحالات التي تتوافق فيها البيانات مع نقطة واحدة، ستكون قيمة startIndex مساوية لقيمة endIndex.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
الحقول
startIndex

integer

فهرس بدء هذه التفاصيل في الخط المتعدد الأضلاع
endIndex

integer

الفهرس النهائي لهذه التفاصيل في الخط المتعدد الأضلاع.

RestrictionInfo

تتضمّن هذه السمة معلومات حول القيود المختلفة على طول الخط المتعدد الأضلاع.

تمثيل JSON 
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
الحقول
restrictionPresence

enum (RoadFeatureState)

النتائج فقط. تشير إلى ما إذا كان هناك قيود على جزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

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

string (int64 format)

تمثّل هذه السمة الحد الأقصى للارتفاع بالملليمتر. يتم ملء هذا الحقل عندما يمنع الارتفاع المحظور المرور أو يؤدي إلى خلوص منخفض للمركبة المحددة.
restrictedWeightKg

string (int64 format)

الحدّ الأقصى للوزن بالكيلوغرام يتم ملء هذا الحقل عندما يمنع قيد الوزن المرور أو يكون قريبًا من وزن المركبة المحدّدة.
hazardousGoods

boolean

يتم ضبط هذا الحقل على "صحيح" عندما تكون هناك قيود على نقل السلع الخطرة.
trucksProhibited

boolean

يتم ضبط هذا الحقل على "صحيح" عندما تكون الشاحنات محظورة.
نهاية الحقول التي يستبعد كلّ منها الآخر

FlyoverInfo

تغليف المعلومات حول التحليقات فوق خطوط متعددة الأضلاع

تمثيل JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
الحقول
flyoverPresence

enum (RoadFeatureState)

النتائج فقط. تشير إلى ما إذا كان هناك تحليق جوي لجزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

تمثّل هذه السمة موقع المعلومات ذات الصلة بالتحليق فوق المنطقة على طول الخط المتعدد الأضلاع.

NarrowRoadInfo

تتضمّن هذه السمة معلومات عن الطرق الضيقة على طول الخط المتعدد الأضلاع.

تمثيل JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
الحقول
narrowRoadPresence

enum (RoadFeatureState)

النتائج فقط. تحدّد هذه السمة ما إذا كانت هناك طريق ضيقة في جزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

تمثّل هذه السمة موقع المعلومات ذات الصلة بالطرق الضيقة على طول الخط المتعدد.

BridgeInfo

تتضمّن هذه السمة معلومات عن الجسور على طول الخط المتعدد.

تمثيل JSON 
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
الحقول
bridgePresence

enum (RoadFeatureState)

تشير إلى ما إذا كان هناك جسر في جزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

موقع المعلومات ذات الصلة بالجسر على طول الخط المتعدد

SkywayInfo

تتضمّن هذه السمة معلومات عن الطرق السريعة على طول الخط المتعدد الأضلاع.

تمثيل JSON 
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
الحقول
skywayPresence

enum (RoadFeatureState)

تشير إلى ما إذا كان هناك جسر علوي لجزء معيّن من الخط المتعدد الأضلاع.
polylinePointIndex

object (PolylinePointIndex)

تمثّل هذه السمة الموقع الجغرافي للمعلومات ذات الصلة بالجسر العلوي على طول الخط المتعدد الأضلاع.

GeocodingResults

يحتوي على GeocodedWaypoints لنقطة الانطلاق والوجهة ونقاط المرور الوسيطة. تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط.

تمثيل JSON 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
الحقول
origin

object (GeocodedWaypoint)

نقطة على المسار مرمزة جغرافيًا للمصدر
destination

object (GeocodedWaypoint)

نقطة على المسار تم ترميزها جغرافيًا للوجهة
intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

تمثيل JSON 
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
الحقول
geocoderStatus

object (Status)

تشير إلى رمز الحالة الناتج من عملية الترميز الجغرافي.
type[]

string

أنواع النتيجة، في شكل علامات نوع واحدة أو أكثر الأنواع المتوافقة: أنواع العناوين وأنواع مكوّنات العناوين
partialMatch

boolean

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

string

تمثّل هذه السمة رقم تعريف المكان الخاص بهذه النتيجة.
intermediateWaypointRequestIndex

integer

فهرس نقطة الطريق الوسيطة المقابلة في الطلب لا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة هي نقطة طريق وسيطة.