الفهرس
Routes
(واجهة)ComputeRouteMatrixRequest
(رسالة)ComputeRouteMatrixRequest.ExtraComputation
(تعداد)ComputeRoutesRequest
(رسالة)ComputeRoutesRequest.ExtraComputation
(تعداد)ComputeRoutesRequest.ReferenceRoute
(تعداد)ComputeRoutesResponse
(رسالة)FallbackInfo
(رسالة)FallbackReason
(تعداد)FallbackRoutingMode
(تعداد)GeocodedWaypoint
(رسالة)GeocodingResults
(رسالة)LocalizedTime
(رسالة)Location
(رسالة)Maneuver
(تعداد)NavigationInstruction
(رسالة)Polyline
(رسالة)PolylineDetails
(رسالة)PolylineDetails.FlyoverInfo
(رسالة)PolylineDetails.NarrowRoadInfo
(رسالة)PolylineDetails.PolylinePointIndex
(رسالة)PolylineDetails.RoadFeatureState
(تعداد)PolylineEncoding
(تعداد)PolylineQuality
(تعداد)Route
(رسالة)Route.RouteLocalizedValues
(رسالة)RouteLabel
(تعداد)RouteLeg
(رسالة)RouteLeg.RouteLegLocalizedValues
(رسالة)RouteLeg.StepsOverview
(رسالة)RouteLeg.StepsOverview.MultiModalSegment
(رسالة)RouteLegStep
(رسالة)RouteLegStep.RouteLegStepLocalizedValues
(رسالة)RouteLegStepTransitDetails
(رسالة)RouteLegStepTransitDetails.TransitDetailsLocalizedValues
(رسالة)RouteLegStepTransitDetails.TransitStopDetails
(رسالة)RouteLegStepTravelAdvisory
(رسالة)RouteLegTravelAdvisory
(رسالة)RouteMatrixDestination
(رسالة)RouteMatrixElement
(رسالة)RouteMatrixElement.LocalizedValues
(رسالة)RouteMatrixElementCondition
(تعداد)RouteMatrixOrigin
(رسالة)RouteModifiers
(رسالة)RouteTravelAdvisory
(رسالة)RouteTravelMode
(تعداد)RoutingPreference
(تعداد)SpeedReadingInterval
(رسالة)SpeedReadingInterval.Speed
(تعداد)TollInfo
(رسالة)TollPass
(تعداد)TrafficModel
(تعداد)TransitAgency
(رسالة)TransitLine
(رسالة)TransitPreferences
(رسالة)TransitPreferences.TransitRoutingPreference
(تعداد)TransitPreferences.TransitTravelMode
(تعداد)TransitStop
(رسالة)TransitVehicle
(رسالة)TransitVehicle.TransitVehicleType
(تعداد)Units
(تعداد)VehicleEmissionType
(تعداد)VehicleInfo
(رسالة)Waypoint
(رسالة)
المسارات
Routes API
ComputeRouteMatrix |
---|
تتلقّى هذه الطريقة قائمة بالمواقع الجغرافية للانطلاق والوجهات وتعرض مصدر بيانات يحتوي على معلومات المسار لكل مجموعة من المواقع الجغرافية للانطلاق والوجهات. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL على سبيل المثال، في هذه الطريقة:
من الضروري تضمين
|
ComputeRoutes |
---|
تعرض هذه الطريقة المسار الأساسي مع مسارات بديلة اختيارية، وذلك عند توفّر مجموعة من نقاط الطريق النهائية والمتوسطة. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL على سبيل المثال، في هذه الطريقة:
لا تشجّع Google على استخدام قناع حقل الردّ الذي يتضمّن حرف البدل (
|
ComputeRouteMatrixRequest
رسالة طلب ComputeRouteMatrix
الحقول | |
---|---|
origins[] |
الحقل مطلوب. مصفوفة المصادر التي تحدّد صفوف مصفوفة الاستجابة. تنطبق العديد من القيود على حجم عدد القيم الفريدة للمصادر والوجهات:
|
destinations[] |
الحقل مطلوب. مصفوفة الوجهات التي تحدّد أعمدة مصفوفة الردّ. |
travel_mode |
اختيارية: تحدّد هذه السمة وسيلة النقل. |
routing_preference |
اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام إعدادات التوجيه المفضّلة المحدّدة لحساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة |
departure_time |
اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، سيتم تلقائيًا ضبطها على الوقت الذي أرسلت فيه الطلب. ملاحظة: لا يمكنك تحديد |
arrival_time |
اختيارية: وقت الوصول ملاحظة: لا يمكن ضبط هذا الخيار إلا عندما يكون |
language_code |
اختيارية: تمثّل هذه السمة رمز اللغة المستخدَمة في وصف المراجعة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة في Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي للمصدر الأول. |
region_code |
اختيارية: رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. |
units |
اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. |
extra_computations[] |
اختيارية: قائمة بالحسابات الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ. |
traffic_model |
اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في حركة المرور. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في |
transit_preferences |
اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه للمسارات من النوع |
ExtraComputation
عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب
عمليات التعداد | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
لم يتم استخدامه. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة. |
TOLLS |
معلومات حول رسوم المرور لعناصر المصفوفة. |
ComputeRoutesRequest
رسالة طلب ComputeRoutes
الحقول | |
---|---|
origin |
الحقل مطلوب. نقطة الطريق الأصلية |
destination |
الحقل مطلوب. نقطة الطريق للوجهة |
intermediates[] |
اختيارية: مجموعة من نقاط المرور على طول المسار (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها يمكن إضافة ما يصل إلى 25 نقطة توقّف وسيطة. |
travel_mode |
اختيارية: تحدّد هذه السمة وسيلة النقل. |
routing_preference |
اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام إعدادات التوجيه المفضّلة المحدّدة لحساب المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة |
polyline_quality |
اختيارية: تحدّد هذه السمة إعداداتك المفضّلة لجودة الخط المتعدد الأضلاع. |
polyline_encoding |
اختيارية: تحدّد هذه السمة الترميز المفضّل للخط المتعدد الأضلاع. |
departure_time |
اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، سيتم تلقائيًا ضبطها على الوقت الذي أرسلت فيه الطلب. ملاحظة: لا يمكنك تحديد |
arrival_time |
اختيارية: وقت الوصول ملاحظة: يتم تجاهل هذا الحقل عندما تحدّد الطلبات |
compute_alternative_routes |
اختيارية: تحدّد هذه السمة ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض طرق بديلة للطلبات التي تتضمّن نقاط توقّف وسيطة. |
route_modifiers |
اختيارية: مجموعة من الشروط التي يجب استيفاؤها والتي تؤثر في طريقة احتساب المسارات |
language_code |
اختيارية: تمثّل هذه السمة رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة في Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار. |
region_code |
اختيارية: رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. |
units |
اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. تتضمّن هذه الحقول الحقل |
optimize_waypoint_order |
اختيارية: إذا تم ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط المرور الوسيطة المحدّدة. يتعذّر تنفيذ الطلب إذا كانت أي من نقاط الطريق الوسيطة هي نقطة طريق |
requested_reference_routes[] |
اختيارية: تحدّد هذه السمة مسارات المراجع المطلوب احتسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار له هدف مختلف عن هدف حساب المسار التلقائي. على سبيل المثال، تأخذ |
extra_computations[] |
اختيارية: قائمة بالحسابات الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ. |
traffic_model |
اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في حركة المرور. يؤثر هذا الإعداد في القيمة المعروضة في حقل المدة في |
transit_preferences |
اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه للمسارات من النوع |
ExtraComputation
عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب
عمليات التعداد | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
لم يتم استخدامه. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة. |
TOLLS |
تعرض هذه السمة معلومات عن رسوم المرور على الطرق. |
FUEL_CONSUMPTION |
استهلاك الوقود المقدَّر للمسارات |
TRAFFIC_ON_POLYLINE |
خطوط متعدّدة الأضلاع تراعي حركة المرور للطرق |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions معروضة كسلسلة نصية منسّقة بتنسيق HTML. يجب قراءة هذا المحتوى كما هو، وهو مخصّص للعرض فقط. يُرجى عدم تحليلها آليًا. |
FLYOVER_INFO_ON_POLYLINE |
معلومات عن المسارات الجوية يجب تحديد routes.polyline_details.flyover_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتمّ ملء هذه البيانات إلا لبعض المدن الكبرى في الهند. هذه الميزة تجريبية، وقد يتغير رمز التخزين التعريفي/الرسوم. |
NARROW_ROAD_INFO_ON_POLYLINE |
معلومات عن الطرق الضيقة للمسارات يجب تحديد routes.polyline_details.narrow_road_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتمّ ملء هذه البيانات إلا لبعض المدن الكبرى في الهند. هذه الميزة تجريبية، وقد يتغير رمز التخزين التعريفي/الرسوم. |
ReferenceRoute
مسار مرجعي متوافق في ComputeRoutesRequest
عمليات التعداد | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
لم يتم استخدامه. لن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة. |
FUEL_EFFICIENT |
مسار أقل استهلاكًا للوقود |
SHORTER_DISTANCE |
المسار الذي يتضمّن مسافة سفر أقصر هذه ميزة تجريبية. بالنسبة إلى طلبات بالنسبة إلى طلبات لا تتوافق هذه الميزة مع أي وسائل نقل أخرى أو نقاط توقّف وسيطة أو |
ComputeRoutesResponse
ComputeRoutes هي رسالة الرد.
الحقول | |
---|---|
routes[] |
تحتوي على مصفوفة من المسارات المحسوبة (بحد أقصى ثلاثة) عند تحديد |
fallback_info |
في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب نتائج المسار باستخدام جميع الإعدادات المفضّلة المُدخَلة، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع التراجع، يحتوي هذا الحقل على معلومات تفصيلية حول استجابة التراجع. وفي ما عدا ذلك، يتم إلغاء ضبط هذا الحقل. |
geocoding_results |
يحتوي على معلومات استجابة الترميز الجغرافي لنقاط الطريق المحدّدة كعناوين. |
FallbackInfo
معلومات ذات صلة بطريقة استخدام نتيجة احتياطية وسبب استخدامها في حال ضبط هذا الحقل، يعني ذلك أنّ الخادم استخدم وضع توجيه مختلفًا عن الوضع المفضّل لديك كخيار احتياطي.
الحقول | |
---|---|
routing_mode |
وضع التوجيه المستخدَم في الردّ. في حال تم تفعيل وضع احتياطي، قد يختلف الوضع عن إعدادات التوجيه المفضّلة في طلب العميل الأصلي. |
reason |
سبب استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي لا تتمّ تعبئة هذا الحقل إلا عند تفعيل وضع الاحتياط وإرجاع الرد الاحتياطي. |
FallbackReason
أسباب استخدام الرد الاحتياطي
عمليات التعداد | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
لم يتم تحديد سبب احتياطي. |
SERVER_ERROR |
حدث خطأ في الخادم أثناء احتساب المسارات باستخدام وضع التوجيه المفضّل لديك، ولكن تمكّنا من عرض نتيجة تم احتسابها باستخدام وضع بديل. |
LATENCY_EXCEEDED |
لم نتمكّن من إنهاء عملية الحساب باستخدام وضع التوجيه المفضّل لديك في الوقت المناسب، ولكن تمكّنا من عرض نتيجة محسوبة باستخدام وضع بديل. |
FallbackRoutingMode
وضع التوجيه الفعلي المستخدَم في الرد الاحتياطي الذي تم إرجاعه.
عمليات التعداد | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
لم يتم استخدامه. |
FALLBACK_TRAFFIC_UNAWARE |
يشير إلى أنّه تم استخدام TRAFFIC_UNAWARE لاحتساب الردّ. |
FALLBACK_TRAFFIC_AWARE |
يشير إلى أنّه تم استخدام TRAFFIC_AWARE لاحتساب الردّ. |
GeocodedWaypoint
تفاصيل حول المواقع الجغرافية المستخدَمة كنقاط توقّف تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط. تتضمّن تفاصيل حول نتائج الترميز الجغرافي لتحديد الموقع الجغرافي الذي تم ترميز العنوان إليه.
الحقول | |
---|---|
geocoder_status |
تشير إلى رمز الحالة الناتج من عملية الترميز الجغرافي. |
type[] |
أنواع النتيجة، في شكل علامات نوع واحدة أو أكثر الأنواع المتوافقة: أنواع العناوين وأنواع عناصر العناوين |
partial_match |
يشير إلى أنّ أداة الترميز الجغرافي لم تعرض تطابقًا تامًا للطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. ننصحك بمراجعة الطلب الأصلي للتأكّد من عدم وجود أخطاء إملائية و/أو عنوان غير مكتمل. |
place_id |
المعرّف الخاص بهذا المكان |
intermediate_waypoint_request_index |
فهرس نقطة الطريق الوسيطة المقابلة في الطلب لا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة هي نقطة طريق وسيطة. |
GeocodingResults
تحتوي على
لنقطة الانطلاق والوجهة ونقاط المرور الوسيطة. تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط.GeocodedWaypoints
الحقول | |
---|---|
origin |
نقطة طريق جغرافية تم ترميزها جغرافيًا. |
destination |
نقطة طريق الوجهة المرمّزة جغرافيًا |
intermediates[] |
قائمة بنقاط الطريق الوسيطة المرمّزة جغرافيًا، يحتوي كل منها على حقل فهرس يتوافق مع الموضع المستند إلى الصفر لنقطة الطريق في الترتيب الذي تم تحديده في الطلب. |
LocalizedTime
وصف مترجَم للوقت
الحقول | |
---|---|
time |
الوقت المحدّد كسلسلة في منطقة زمنية معيّنة |
time_zone |
تحتوي هذه السمة على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية IANA، مثل "America/New_York". |
الموقع الجغرافي
تتضمّن هذه السمة موقعًا جغرافيًا (نقطة جغرافية واتجاهًا اختياريًا).
الحقول | |
---|---|
lat_lng |
|