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 لعرض هذه المعلومات. سيتم حاليًا تعبئة هذه البيانات لبعض المناطق المركزية في الهند فقط. هذه الميزة تجريبية، وقد تتغيّر وحدة التخزين التعريفية أو الرسوم.
NARROW_ROAD_INFO_ON_POLYLINE معلومات عن الطرق الضيقة في المسارات يجب تحديد قناع الحقل routes.polyline_details.narrow_road_info لعرض هذه المعلومات. سيتم حاليًا تعبئة هذه البيانات لبعض المناطق المركزية في الهند فقط. هذه الميزة تجريبية، وقد تتغيّر وحدة التخزين التعريفية أو الرسوم.
TUNNEL_INFO_ON_POLYLINE معلومات عن الأنفاق في المسارات يجب تحديد قناع الحقل routes.polyline_details.tunnel_info لعرض هذه المعلومات.
BRIDGE_INFO_ON_POLYLINE معلومات الجسر للمسارات يجب تحديد قناع الحقل routes.polyline_details.bridge_info لعرض هذه المعلومات.
SKYWAY_INFO_ON_POLYLINE معلومات عن الممرات المغطاة للمسارات يجب تحديد قناع الحقل routes.polyline_details.skyway_info لعرض هذه المعلومات.

مسار

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

تمثيل 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، يتم احتساب هذه القيمة مع مراعاة أحوال حركة المرور.

عند ضبط السمة routingPreference على TRAFFIC_AWARE_OPTIMAL، يتم احتساب المدة باستخدام سرعات سيارات الركاب أو سرعات الشاحنات (مُدد أطول). يتم استخدام سرعات الشاحنات في حال استيفاء أحد الشروط التالية:

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

تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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

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

ملاحظة: لا يتوفّر 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)

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

عند ضبط السمة routingPreference على TRAFFIC_AWARE_OPTIMAL، يتم احتساب المدة باستخدام سرعات سيارات الركاب أو سرعات الشاحنات (مُدد أطول). يتم استخدام سرعات الشاحنات في حال استيفاء أحد الشروط التالية:

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

تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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

عدد المحطات من محطة المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، ولكنّه يستثني محطة المغادرة. على سبيل المثال، إذا كان مسارك يبدأ من المحطة "أ" ويمرّ بالمحطتَين "ب" و"ج" ويصل إلى المحطة "د"، ستعرض السمة 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 Avenue Local".

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)

فواصل زمنية لقراءة السرعة تشير إلى كثافة حركة المرور لا تتم تعبئة هذا الحقل إلا للطلبات التي تتضمّن قيمة ComputeRoutesRequest.routing_preference لـ TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، ويتم تضمين 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

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