- طلب HTTP
- نص الطلب
- نص الاستجابة
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- المسار
- RouteLabel
- RouteLeg
- خطوط متعدّدة
- RouteLegStep
- NavigationInstruction
- المناورة
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- إطار العرض
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
تعرض هذه الخدمة المسار الأساسي مع مسارات بديلة اختيارية، استنادًا إلى مجموعة من نقاط المسار النهائية والمتوسطة.
ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الاستجابة في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان 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 ( |
| الحقول | |
|---|---|
origin |
الحقل مطلوب. نقطة الانطلاق على المسار |
destination |
الحقل مطلوب. نقطة على المسار للوجهة |
intermediates[] |
اختيارية: مجموعة من النقاط على طول المسار (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها. يمكن استخدام ما يصل إلى 25 نقطة على المسار. |
travelMode |
اختيارية: تحدّد هذه السمة وسيلة النقل. |
routingPreference |
اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام الإعداد المفضّل للمسار المحدّد لحساب المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو وقت استجابة طويل جدًا، يتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة |
polylineQuality |
اختيارية: يحدّد هذا الإعداد جودة الخطوط المتعدّدة المفضّلة لديك. |
polylineEncoding |
اختيارية: تحدّد الترميز المفضّل للخطوط المتعدّدة. |
departureTime |
اختيارية: وقت المغادرة إذا لم تضبط هذه القيمة، يتم ضبطها تلقائيًا على وقت تقديم الطلب. ملاحظة: يمكنك تحديد يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
arrivalTime |
اختيارية: وقت الوصول ملاحظة: يتم تجاهل هذا الحقل عندما تحدّد الطلبات يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
computeAlternativeRoutes |
اختيارية: تحدّد ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض أي مسارات بديلة للطلبات التي تتضمّن نقاطًا على المسار. |
routeModifiers |
اختيارية: مجموعة من الشروط التي يجب استيفاؤها وتؤثر في طريقة احتساب المسارات |
languageCode |
اختيارية: رمز اللغة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. يمكنك الاطّلاع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. في حال عدم تقديم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار. |
regionCode |
اختيارية: رمز المنطقة، ويتم تحديده كقيمة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. |
units |
اختيارية: يحدّد هذا الإعداد وحدات القياس لحقول العرض. وتشمل هذه الحقول حقل |
optimizeWaypointOrder |
اختيارية: في حال ضبط هذه السياسة على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب النقاط الوسيطة المحدّدة على المسار. يتعذّر تنفيذ الطلب إذا كانت أي من النقاط الوسيطة على المسار هي نقطة |
requestedReferenceRoutes[] |
اختيارية: تحدّد المسارات المرجعية التي يجب احتسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار له هدف مختلف لحساب المسار عن المسار التلقائي. على سبيل المثال، تأخذ عملية احتساب المسار المرجعي في |
extraComputations[] |
اختيارية: قائمة بالعمليات الحسابية الإضافية التي يمكن استخدامها لإكمال الطلب ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الاستجابة. |
trafficModel |
اختيارية: تحدّد الافتراضات التي يجب استخدامها عند احتساب الوقت في حركة المرور. يؤثر هذا الإعداد في القيمة التي يتم عرضها في حقل المدة في |
transitPreferences |
اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه لمسارات |
نص الاستجابة
v2.computeRoutes هي رسالة الردّ.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{ "routes": [ { object ( |
| الحقول | |
|---|---|
routes[] |
يحتوي على مصفوفة من المسارات المحسوبة (ما يصل إلى ثلاثة) عند تحديد |
fallbackInfo |
في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب نتائج المسار باستخدام جميع الإعدادات المفضّلة التي تم إدخالها، قد يلجأ إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع الاحتياط، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وإلّا، لن يتم ضبط هذا الحقل. |
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 |
مسار بمسافة سفر أقصر هذه ميزة تجريبية. بالنسبة إلى طلبات بالنسبة إلى طلبات لا تتوافق هذه الميزة مع أي وسائل نقل أخرى أو نقاط على المسار أو |
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 ( |
| الحقول | |
|---|---|
routeLabels[] |
تصنيفات |
legs[] |
مجموعة من المراحل (أجزاء المسار بين النقاط على المسار) التي تشكّل المسار يتوافق كل جزء مع الرحلة بين نقطتَين غير |
distanceMeters |
مسافة السفر للمسار، بالمتر |
duration |
المدة الزمنية اللازمة للتنقّل في المسار إذا ضبطت السمة عند ضبط السمة
في جميع الحالات الأخرى، يتم استخدام سرعات مركبات الركاب، حتى إذا تم تحديد أبعاد أو وزن مركبة أخرى في تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
staticDuration |
مدة السفر عبر المسار بدون أخذ أحوال حركة المرور في الاعتبار تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
polyline |
الخطوط المتعدّدة للمسار العام هذا الخط المتعدّد هو الخط المتعدّد المجمّع لكل |
description |
وصف للمسار |
warnings[] |
مصفوفة من التحذيرات التي تظهر عند عرض المسار |
viewport |
مربّع حدود إطار العرض للخطوط المتعدّدة |
travelAdvisory |
معلومات إضافية حول المسار |
optimizedIntermediateWaypointIndex[] |
إذا ضبطت |
localizedValues |
تمثيلات نصية لسمات |
routeToken |
هو رمز مميّز غير شفاف يمكن تمريره إلى حزمة تطوير البرامج للتنقّل لإعادة إنشاء المسار أثناء التنقّل، وفي حال إعادة التوجيه، يتم الالتزام بالهدف الأصلي عند إنشاء المسار. يجب التعامل مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم. لا تقارِن قيمتها في الطلبات المختلفة لأنّ قيمتها قد تتغيّر حتى إذا عرضت الخدمة المسار نفسه بالضبط. ملاحظة: لا يتوفّر |
polylineDetails |
تحتوي على معلومات حول التفاصيل على طول الخطوط المتعدّدة. |
RouteLabel
تصنيفات المفيدة لتحديد سمات معيّنة للمسار من أجل مقارنتها بغيرهاRoute
| عمليات التعداد | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
الإعداد التلقائي: غير مستخدَم |
DEFAULT_ROUTE |
المسار التلقائي "الأفضل" الذي تم عرضه لحساب المسار |
DEFAULT_ROUTE_ALTERNATE |
مسار بديل للمسار "الأفضل" التلقائي سيتم عرض مسارات مثل هذا عند تحديد . |
FUEL_EFFICIENT |
مسار أقل استهلاكًا للوقود يتم تحديد المسارات المصنّفة بهذه القيمة على أنّها محسّنة لمَعلمات صديقة للبيئة، مثل استهلاك الوقود. |
SHORTER_DISTANCE |
مسار أقصر من حيث المسافة هذه ميزة تجريبية. |
RouteLeg
يحتوي على جزء بين نقاط على المسار غير تابعة لـ "via".
| تمثيل JSON |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| الحقول | |
|---|---|
distanceMeters |
مسافة السفر في جزء المسار، بالمتر |
duration |
المدة الزمنية اللازمة للتنقل في المرحلة إذا تم ضبط السمة عند ضبط السمة
في جميع الحالات الأخرى، يتم استخدام سرعات مركبات الركاب، حتى إذا تم تحديد أبعاد أو وزن مركبة أخرى في تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
staticDuration |
مدة السفر خلال المرحلة، ويتم احتسابها بدون مراعاة أحوال حركة المرور. تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
polyline |
الخطوط المتعدّدة الإجمالية لهذا الجزء من الرحلة والتي تتضمّن الخطوط المتعدّدة لكل |
startLocation |
الموقع الجغرافي لبداية هذا الجزء من الرحلة قد يختلف هذا الموقع الجغرافي عن الموقع الجغرافي المقدَّم في |
endLocation |
الموقع الجغرافي لنهاية هذا الجزء من الرحلة قد يختلف هذا الموقع الجغرافي عن الموقع الجغرافي المقدَّم في |
steps[] |
مصفوفة من الخطوات التي تشير إلى الأجزاء ضمن هذا الجزء من الرحلة. وتمثّل كل خطوة تعليمات تنقّل واحدة. |
travelAdvisory |
يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور، في جزء من المسار. |
localizedValues |
تمثيلات نصية لسمات |
stepsOverview |
نظرة عامة على الخطوات في هذا |
خط متعدد
تغليف خطوط متعدّدة مرمّزة
| تمثيل 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 |
ترميز السلسلة للخطوط المتعدّدة باستخدام خوارزمية ترميز الخطوط المتعدّدة |
geoJsonLinestring |
يحدّد خطًا متعدّدًا باستخدام تنسيق GeoJSON LineString. |
| نهاية الحقول التي يستبعد كل منها الآخر | |
RouteLegStep
يحتوي على شريحة من . تتوافق الخطوة مع تعليمات تنقّل واحدة. تتألف أقسام المسار من خطوات.RouteLeg
| تمثيل JSON |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| الحقول | |
|---|---|
distanceMeters |
مسافة السفر لهذه الخطوة، بالأمتار. في بعض الحالات، قد لا يحتوي هذا الحقل على قيمة. |
staticDuration |
مدة السفر خلال هذه الخطوة بدون أخذ أحوال حركة المرور في الاعتبار في بعض الحالات، قد لا يحتوي هذا الحقل على قيمة. تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
polyline |
الخطوط المتعدّدة المرتبطة بهذه الخطوة |
startLocation |
الموقع الجغرافي لبداية هذه الخطوة |
endLocation |
الموقع الجغرافي النهائي لهذه الخطوة |
navigationInstruction |
تعليمات التنقّل |
travelAdvisory |
يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور، في خطوة من المرحلة. |
localizedValues |
تمثيلات نصية لسمات |
transitDetails |
التفاصيل المتعلّقة بهذه الخطوة إذا كان وضع السفر هو |
travelMode |
تمثّل هذه السمة وسيلة النقل المستخدَمة في هذه الخطوة. |
مناورة
مجموعة من القيم التي تحدّد إجراء التنقّل الذي يجب اتّخاذه في الخطوة الحالية (على سبيل المثال، الانعطاف يسارًا أو الاندماج أو السير في خط مستقيم).
| عمليات التعداد | |
|---|---|
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 ( |
| الحقول | |
|---|---|
speedReadingIntervals[] |
ملاحظة: لم تتم تعبئة هذا الحقل حاليًا. |
RouteLegStepLocalizedValues
تمثيلات نصية لسمات معيّنة
| تمثيل JSON |
|---|
{ "distance": { object ( |
| الحقول | |
|---|---|
distance |
تمثّل هذه السمة مسافة السفر في شكل نص. |
staticDuration |
المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم تمثيلها في شكل نصي. |
RouteLegStepTransitDetails
معلومات إضافية حول RouteLegStep ذات الصلة بمسارات TRANSIT
| تمثيل JSON |
|---|
{ "stopDetails": { object ( |
| الحقول | |
|---|---|
stopDetails |
معلومات عن محطتَي الوصول والمغادرة للخطوة |
localizedValues |
تمثيلات نصية لسمات |
headsign |
تحدّد هذه السمة اتجاه التنقّل على هذا الخط كما هو موضّح على المركبة أو في محطة المغادرة. غالبًا ما يكون الاتجاه هو المحطة النهائية. |
headway |
يحدّد الوقت المتوقّع كمدة بين المغادرة من المحطة نفسها في هذا الوقت. على سبيل المثال، إذا كانت قيمة الثواني بين الرحلات هي 600، من المتوقّع أن تنتظر عشر دقائق إذا فاتتك الحافلة. تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
transitLine |
معلومات عن خط النقل العام المستخدَم في هذه الخطوة |
stopCount |
عدد المحطات من محطة المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، ولكنّه يستثني محطة المغادرة. على سبيل المثال، إذا كان مسارك يبدأ من المحطة "أ" ويمرّ بالمحطتَين "ب" و"ج" ويصل إلى المحطة "د"، ستعرض السمة |
tripShortText |
النص الذي يظهر في الجداول الزمنية ولوحات الإعلانات لتحديد رحلة نقل عام للركاب يجب أن يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو |
TransitStopDetails
تفاصيل حول محطات النقل العام لـ RouteLegStep
| تمثيل JSON |
|---|
{ "arrivalStop": { object ( |
| الحقول | |
|---|---|
arrivalStop |
معلومات عن محطة الوصول للخطوة |
arrivalTime |
الوقت المقدَّر للوصول إلى الخطوة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
departureStop |
معلومات عن محطة المغادرة للخطوة |
departureTime |
الوقت المقدَّر للمغادرة في هذه الخطوة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
TransitStop
معلومات عن محطة نقل عام
| تمثيل JSON |
|---|
{
"name": string,
"location": {
object ( |
| الحقول | |
|---|---|
name |
اسم محطة النقل العام |
location |
الموقع الجغرافي للمحطة معبَّر عنه بإحداثيات خط العرض/خط الطول |
TransitDetailsLocalizedValues
أوصاف مترجَمة لقيم RouteTransitDetails
| تمثيل JSON |
|---|
{ "arrivalTime": { object ( |
| الحقول | |
|---|---|
arrivalTime |
الوقت في تمثيله النصي المنسَّق مع منطقة زمنية مقابلة |
departureTime |
الوقت في تمثيله النصي المنسَّق مع منطقة زمنية مقابلة |
LocalizedTime
الوصف المترجَم للوقت
| تمثيل JSON |
|---|
{
"time": {
object ( |
| الحقول | |
|---|---|
time |
الوقت المحدّد كسلسلة في منطقة زمنية معيّنة |
timeZone |
يحتوي على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA)، مثل "America/New_York". |
TransitLine
يحتوي على معلومات حول خط النقل العام المستخدَم في هذه الخطوة.
| تمثيل JSON |
|---|
{ "agencies": [ { object ( |
| الحقول | |
|---|---|
agencies[] |
مؤسسات النقل العام التي تشغّل خط النقل العام هذا |
name |
الاسم الكامل لخط النقل العام هذا، على سبيل المثال، "8 Avenue Local". |
uri |
معرّف الموارد المنتظم (URI) لخط النقل العام هذا كما توفّره مؤسسة النقل العام |
color |
اللون المستخدَم عادةً في اللافتات لهذا الخط يتم تمثيلها بنظام العد الستة عشري. |
iconUri |
معرّف الموارد المنتظم (URI) للرمز المرتبط بهذا الخط |
nameShort |
الاسم المختصر لخط النقل العام هذا يكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355". |
textColor |
اللون المستخدَم عادةً في النص على اللافتات لهذا الخط يتم تمثيلها بنظام العد الستة عشري. |
vehicle |
نوع المركبة التي تعمل على خط النقل العام هذا |
TransitAgency
مؤسسة نقل عام تشغّل خط نقل عام
| تمثيل JSON |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| الحقول | |
|---|---|
name |
اسم مؤسسة النقل العام هذه |
phoneNumber |
رقم هاتف مؤسسة النقل العام بالتنسيق الدولي |
uri |
معرّف الموارد المنتظم (URI) لمؤسسة النقل العام |
TransitVehicle
معلومات عن مركبة مستخدَمة في مسارات النقل العام
| تمثيل JSON |
|---|
{ "name": { object ( |
| الحقول | |
|---|---|
name |
اسم هذه المركبة، مكتوبًا بأحرف كبيرة |
type |
نوع المركبة المستخدَمة |
iconUri |
تمثّل هذه السمة معرّف الموارد المنتظم (URI) لرمز مرتبط بنوع المركبة هذا. |
localIconUri |
معرّف الموارد المنتظم (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[] |
فواصل زمنية لقراءة السرعة تشير إلى كثافة حركة المرور لا تتم تعبئة هذا الحقل إلا للطلبات التي تتضمّن قيمة مثال: |
RouteLegLocalizedValues
تمثيلات نصية لسمات معيّنة
| تمثيل JSON |
|---|
{ "distance": { object ( |
| الحقول | |
|---|---|
distance |
تمثّل هذه السمة مسافة السفر في شكل نص. |
duration |
تمثّل هذه السمة المدة في شكل نصي ومترجَمة إلى لغة منطقة طلب البحث. يأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات عن حركة المرور، ستكون هذه القيمة هي نفسها قيمة staticDuration. |
staticDuration |
المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم تمثيلها في شكل نصي. |
StepsOverview
يوفّر معلومات عامة عن قائمة من RouteLegStep.
| تمثيل JSON |
|---|
{
"multiModalSegments": [
{
object ( |
| الحقول | |
|---|---|
multiModalSegments[] |
معلومات ملخّصة حول شرائح متعددة الوسائط مختلفة من " |
MultiModalSegment
يوفّر معلومات ملخّصة حول شرائح متعددة الوسائط مختلفة من RouteLeg.steps. يتم تعريف الجزء المتعدد الوسائط على أنّه RouteLegStep متجاورة واحدة أو أكثر لها السمة RouteTravelMode نفسها. لا تتم تعبئة هذا الحقل إذا لم يتضمّن RouteLeg أي أقسام متعددة الوسائط في الخطوات.
| تمثيل JSON |
|---|
{ "navigationInstruction": { object ( |
| الحقول | |
|---|---|
navigationInstruction |
NavigationInstruction لشريحة الرحلة المتعددة الوسائط |
travelMode |
وسيلة النقل في الجزء المتعدد الوسائط |
stepStartIndex |
فهرس |
stepEndIndex |
فهرس |
إطار العرض
إطار عرض لخطوط العرض والطول، يتم تمثيله كنقطتَين متقابلتَين قطريًا 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 ( |
| الحقول | |
|---|---|
low |
الحقل مطلوب. النقطة المنخفضة لإطار العرض |
high |
الحقل مطلوب. النقطة العليا لإطار العرض |
RouteLocalizedValues
تمثيلات نصية لسمات معيّنة
| تمثيل JSON |
|---|
{ "distance": { object ( |
| الحقول | |
|---|---|
distance |
تمثّل هذه السمة مسافة السفر في شكل نص. |
duration |
تمثّل هذه السمة المدة في شكل نصي ومترجَمة إلى لغة منطقة طلب البحث. يأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات عن حركة المرور، ستكون هذه القيمة هي نفسها قيمة |
staticDuration |
المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم تمثيلها في شكل نصي. |
transitFare |
تمثيل أجرة النقل العام في شكل نصي |
PolylineDetails
التفاصيل المقابلة لفهرس معيّن أو جزء متجاور من خطوط متعدّدة بالنظر إلى خطوط متعدّدة تتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يستند إلى الصفر)، يحدّد PolylineDetails فاصلاً زمنيًا وبيانات وصفية مرتبطة به.
| تمثيل JSON |
|---|
{ "tunnelInfo": [ { object ( |
| الحقول | |
|---|---|
tunnelInfo[] |
تفاصيل النفق على طول الخط المتعدّد تتم تعبئة هذا الحقل إذا حدّد الطلب معدِّل المسار |
restrictionInfo[] |
تفاصيل القيود على طول الخطوط المتعدّدة لا تتم تعبئة هذا الحقل إلا إذا حدّد الطلب معدِّل المسار |
flyoverInfo[] |
تفاصيل العرض الجوي على طول الخطوط المتعدّدة |
narrowRoadInfo[] |
تفاصيل الطريق الضيّق على طول الخطوط المتعدّدة |
bridgeInfo[] |
تفاصيل الجسر على طول الخطوط المتعدّدة |
skywayInfo[] |
تفاصيل الممرّات العلوية على طول الخطوط المتعدّدة |
TunnelInfo
تتضمّن معلومات عن الأنفاق على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "tunnelPresence": enum ( |
| الحقول | |
|---|---|
tunnelPresence |
يشير إلى ما إذا كان هناك نفق لجزء معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات ذات الصلة بالنفق على طول الخطوط المتعدّدة |
RoadFeatureState
تتضمّن حالات ميزات الطريق على طول امتداد الخطوط المتعدّدة.
| عمليات التعداد | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
لم يتم احتساب حالة ميزة الطريق (القيمة التلقائية). |
EXISTS |
الطريق موجودة. |
DOES_NOT_EXIST |
الطريق غير موجود. |
PolylinePointIndex
تتضمّن هذه الفئة فهارس البداية والنهاية لتفاصيل الخطوط المتعدّدة. في الحالات التي تتوافق فيها البيانات مع نقطة واحدة، ستكون قيمة startIndex وendIndex متساوية.
| تمثيل JSON |
|---|
{ "startIndex": integer, "endIndex": integer } |
| الحقول | |
|---|---|
startIndex |
فهرس البداية لهذه التفاصيل في الخطوط المتعدّدة |
endIndex |
فهرس نهاية هذه التفاصيل في الشكل المتعدد الخطوط. |
RestrictionInfo
تتضمّن معلومات حول القيود المختلفة على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "restrictionPresence": enum ( |
| الحقول | |
|---|---|
restrictionPresence |
النتائج فقط. تشير إلى ما إذا كان هناك قيد على امتداد معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات المتعلّقة بالقيود على طول الخطوط المتعدّدة |
| تتضمّن أنواع القيود التي يمكن تطبيقها على جزء معيّن من الخطوط المتعدّدة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ: | |
restrictedHeightMm |
الحد الأقصى للارتفاع بالملليمتر يتم ملء هذا الحقل عندما يمنع الارتفاع المقيّد المرور أو يؤدي إلى خلوص منخفض للمركبة المحدّدة. |
restrictedWeightKg |
الحدّ الأقصى للوزن بالكيلوغرام تتم تعبئة هذا الحقل عندما يمنع الحد الأقصى للوزن المرور أو يكون قريبًا من وزن المركبة المحدّدة. |
hazardousGoods |
يتم ضبط هذا الحقل على "صحيح" عندما يكون نقل السلع الخطرة محظورًا. |
trucksProhibited |
يتم ضبط هذا الحقل على "صحيح" عندما تكون الشاحنات محظورة. |
| نهاية الحقول التي يستبعد كل منها الآخر | |
FlyoverInfo
تتضمّن معلومات عن الجسور على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "flyoverPresence": enum ( |
| الحقول | |
|---|---|
flyoverPresence |
النتائج فقط. يشير إلى ما إذا كان هناك جسر علوي لجزء معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات ذات الصلة بالتحليق فوق المسار على طول الخطوط المتعدّدة |
NarrowRoadInfo
تتضمّن معلومات عن الطرق الضيقة على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "narrowRoadPresence": enum ( |
| الحقول | |
|---|---|
narrowRoadPresence |
النتائج فقط. يشير إلى ما إذا كان هناك طريق ضيّق في جزء معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات المتعلّقة بالطريق الضيّق على طول الخطوط المتعدّدة |
BridgeInfo
تتضمّن معلومات عن الجسور على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "bridgePresence": enum ( |
| الحقول | |
|---|---|
bridgePresence |
يشير إلى ما إذا كان هناك جسر لجزء معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات ذات الصلة بالجسر على طول الخطوط المتعدّدة |
SkywayInfo
تتضمّن معلومات عن الممرات العلوية على طول الخطوط المتعدّدة.
| تمثيل JSON |
|---|
{ "skywayPresence": enum ( |
| الحقول | |
|---|---|
skywayPresence |
يشير إلى ما إذا كان هناك ممر علوي لجزء معيّن من الخطوط المتعدّدة. |
polylinePointIndex |
موقع المعلومات ذات الصلة بالممر العلوي على طول الخطوط المتعدّدة |
GeocodingResults
يحتوي على لنقطة الانطلاق والوجهة والنقاط على المسار المتوسطة. تتم تعبئة هذا الحقل فقط للنقاط على المسار التي تمثّل عناوين.GeocodedWaypoints
| تمثيل JSON |
|---|
{ "origin": { object ( |
| الحقول | |
|---|---|
origin |
نقطة على المسار تم ترميزها جغرافيًا لموقع الانطلاق |
destination |
نقطة المسار المرمّزة جغرافيًا للوجهة |
intermediates[] |
قائمة بالنقاط الوسيطة على المسار التي تم ترميزها جغرافيًا، ويحتوي كل منها على حقل فهرس يتوافق مع موضع النقطة على المسار الذي يبدأ من الصفر بالترتيب الذي تم تحديده في الطلب. |
GeocodedWaypoint
تفاصيل حول المواقع الجغرافية المستخدَمة كنقاط على المسار تتم تعبئة هذا الحقل فقط للنقاط على المسار التي تمثّل عناوين. تتضمّن تفاصيل حول نتائج الترميز الجغرافي لأغراض تحديد العنوان الذي تم ترميزه جغرافيًا.
| تمثيل JSON |
|---|
{
"geocoderStatus": {
object ( |
| الحقول | |
|---|---|
geocoderStatus |
يشير إلى رمز الحالة الناتج عن عملية الترميز الجغرافي. |
type[] |
تمثّل هذه السمة أنواع النتيجة، على شكل علامات نوع واحدة أو أكثر. الأنواع المتوافقة: أنواع العناوين وأنواع مكوّنات العناوين |
partialMatch |
يشير ذلك إلى أنّ أداة الترميز الجغرافي لم تعرض نتيجة مطابقة تمامًا للطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. ننصحك بفحص الطلب الأصلي بحثًا عن أخطاء إملائية و/أو عنوان غير مكتمل. |
placeId |
رقم تعريف المكان لهذه النتيجة |
intermediateWaypointRequestIndex |
فهرس النقطة الوسيطة المقابلة على المسار في الطلب لا تتم تعبئة هذا الحقل إلا إذا كانت النقطة المقابلة على المسار هي نقطة وسيطة. |