Route Matrix

فئة RouteMatrix

class google.maps.routes.RouteMatrix
library "routes"

مصفوفة من المسارات المحسوبة لمجموعة من أزواج نقاط الانطلاق/الوجهات حسب RouteMatrix.computeRouteMatrix

const {RouteMatrix} = await google.maps.importLibrary("routes");

الطرق الثابتة

computeRouteMatrix

computeRouteMatrix(request) المَعلمات: request: ComputeRouteMatrixRequest القيمة المعروضة: Promise<{matrix:RouteMatrix}> تأخذ هذه الدالة قائمة بنقاط الانطلاق والوجهات وتعرض مصفوفة تحتوي على معلومات المسار لكل مجموعة من نقاط الانطلاق والوجهات. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الاستجابة في الطلب من خلال ضبط السمة ComputeRouteMatrixRequest.fields. القيمة هي قائمة بمسارات الحقول. على سبيل المثال: قناع الحقل لجميع الحقول المتاحة: fields: ['*'] قناع حقل المدة والمسافة على مستوى المسار: fields: ['durationMillis', 'distanceMeters'] لا يُنصح باستخدام قناع حقل الاستجابة الشامل fields: ['*'] للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمنا في توفير دورات الحوسبة، ما يتيح لنا عرض النتيجة لك بوقت استجابة أقل. يضمن اختيار الحقول التي تحتاجها فقط في مهمة الإنتاج أداءً مستقرًا لوقت الاستجابة. قد نضيف المزيد من حقول الاستجابة في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول في المستوى الأعلى، قد ينخفض مستوى الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى حجم استجابة أصغر، وبالتالي تحميل أسرع عبر الشبكة.

الخصائص
rows readonly	النوع: Array<RouteMatrixRow> صفوف المصفوفة يتوافق كل صف مع نقطة انطلاق ويحتوي على مصفوفة من RouteMatrixItem، يمثّل كل منها مسارًا إلى وجهة.

الطُرق
مكتسَبة: toJSON

فئة RouteMatrixRow

class google.maps.routes.RouteMatrixRow
library "routes"

يتوافق مع مصدر تم تمريره إلى RouteMatrix.computeRouteMatrix. يحتوي على قائمة من RouteMatrixItem، ويمثّل كل عنصر مسارًا إلى وجهة معيّنة.

const {RouteMatrixRow} = await google.maps.importLibrary("routes");

الخصائص
items readonly	النوع: Array<RouteMatrixItem> معلومات المسار لكل وجهة

الطُرق
مكتسَبة: toJSON

فئة RouteMatrixItem

class google.maps.routes.RouteMatrixItem
library "routes"

يحتوي على معلومات المسار التي تم احتسابها لزوج من نقطة الانطلاق والوجهة تم تمريره إلى RouteMatrix.computeRouteMatrix.

const {RouteMatrixItem} = await google.maps.importLibrary("routes");

الخصائص
condition readonly	النوع: RouteMatrixItemCondition optional يشير إلى ما إذا تم العثور على المسار أم لا.
distanceMeters readonly	النوع: number optional مسافة السفر للمسار بالأمتار
durationMillis readonly	النوع: number optional المدة الزمنية اللازمة للتنقّل في المسار بالملي ثانية إذا ضبطت السمة ComputeRouteMatrixRequest.routingPreference على TRAFFIC_UNAWARE، ستكون هذه القيمة مماثلة للسمة RouteMatrixItem.staticDurationMillis. إذا ضبطت ComputeRouteMatrixRequest.routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع مراعاة أحوال حركة المرور. ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، تكون هذه القيمة Number.POSITIVE_INFINITY.
error readonly	النوع: RouteMatrixItemError optional الخطأ الذي حدث أثناء احتساب المسار
fallbackInfo readonly	النوع: FallbackInfo optional في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الانطلاق/الوجهة هذا، قد يعود إلى استخدام وضع احتساب مختلف. عند استخدام ردّ احتياطي، يحتوي هذا الحقل على معلومات تفصيلية عنه. وإلا، لن يتم ضبط هذا الحقل.
localizedValues readonly	النوع: RouteMatrixItemLocalizedValues optional تمثيلات نصية لسمات RouteMatrixItem
staticDurationMillis readonly	النوع: number optional مدة السفر عبر المسار بدون أخذ أحوال حركة المرور في الاعتبار ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، تكون هذه القيمة Number.POSITIVE_INFINITY.
travelAdvisory readonly	النوع: RouteTravelAdvisory optional معلومات إضافية حول المسار

ComputeRouteMatrixRequest

واجهة google.maps.routes.ComputeRouteMatrixRequest

طلب مصفوفة مسارات

الخصائص
destinations	النوع: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> مصفوفة من الوجهات تحدّد أعمدة مصفوفة الاستجابة قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار.
fields	النوع: Iterable<string> مجموعة من الحقول المطلوب جلبها حدِّد ["*"] لجميع الحقول.
origins	النوع: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> مصفوفة من نقاط الانطلاق، والتي تحدّد صفوف مصفوفة الاستجابة. قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار. تنطبق عدة قيود على حجم عدد القيم الفريدة لنقاط الانطلاق والوجهات: يجب ألا يزيد إجمالي عدد نقاط الانطلاق والوجهات المحدّدة على شكل string أو Place عن 50. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق في عدد الوجهات عن 625. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق والوجهات عن 100 إذا تم ضبط ComputeRouteMatrixRequest.routingPreference على TRAFFIC_AWARE_OPTIMAL. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق والوجهات عن 100 إذا تم ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT.
arrivalTime اختياري	النوع: Date optional وقت الوصول ملاحظة: لا يمكن ضبط هذه السمة إلا عند ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT. يمكنك تحديد ComputeRouteMatrixRequest.departureTime أو ComputeRouteMatrixRequest.arrivalTime، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
departureTime اختياري	النوع: Date optional وقت المغادرة إذا لم تضبط هذه القيمة، يتم ضبطها تلقائيًا على وقت تقديم الطلب. ملاحظة: يمكنك تحديد وقت في الماضي فقط عندما يتم ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
extraComputations اختياري	النوع: Iterable<ComputeRouteMatrixExtraComputation> optional قائمة بالعمليات الحسابية الإضافية التي يمكن استخدامها لإكمال الطلب ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في ComputeRouteMatrixRequest.fields ليتم عرضها في الاستجابة.
internalUsageAttributionIds اختياري	النوع: Iterable<string> optional المعرّفات المستخدَمة لتحديد مصدر الطلبات من حِزم معيّنة أو مكتبات برامج مفتوحة المصدر
language اختياري	النوع: string optional رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتوافقة. في حال عدم تقديم هذه القيمة، يتم استنتاج اللغة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج اللغة من الموقع الجغرافي للمصدر الأول.
region اختياري	النوع: string optional رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. في حال عدم تقديم هذه القيمة، يتم استنتاج المنطقة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج المنطقة من الموقع الجغرافي للمصدر الأول.
routingPreference اختياري	النوع: RoutingPreference optional تحدّد هذه السمة كيفية حساب مصفوفة المسارات. يحاول الخادم استخدام الإعداد المفضّل للمسار المحدّد لحساب مصفوفة المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو وقت استجابة طويل جدًا، يتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة ComputeRouteMatrixRequest.travelMode هي DRIVING أو TWO_WHEELER، وإلا سيتعذّر تنفيذ الطلب.
trafficModel اختياري	النوع: TrafficModel optional تحدّد هذه المَعلمة الافتراضات التي يجب استخدامها عند احتساب الوقت في حركة المرور. يؤثر هذا الإعداد في القيمة المعروضة في RouteMatrixItem.durationMillis التي تحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا يتوفّر ComputeRouteMatrixRequest.trafficModel إلا للطلبات التي تم ضبط ComputeRouteMatrixRequest.routingPreference فيها على TRAFFIC_AWARE_OPTIMAL وComputeRouteMatrixRequest.travelMode على DRIVING. القيمة التلقائية هي BEST_GUESS.
transitPreference اختياري	النوع: TransitPreference optional تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه لمسارات TRANSIT. ملاحظة: لا يمكن تحديد هذه السمة إلا عند ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT.
travelMode اختياري	النوع: TravelMode optional تحدّد هذه السمة وسيلة النقل.
units اختياري	النوع: UnitSystem optional يحدّد هذا الإعداد وحدات القياس لحقول العرض. إذا لم تقدّم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للمصدر الأول.

ثوابت ComputeRouteMatrixExtraComputation

ثوابت google.maps.routes.ComputeRouteMatrixExtraComputation
مكتبة "routes"

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ComputeRouteMatrixExtraComputationString.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");

الثوابت
TOLLS	معلومات الرسوم لعناصر المصفوفة يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

ثوابت RouteMatrixItemCondition

ثوابت google.maps.routes.RouteMatrixItemCondition
مكتبة "routes"

حالة المسار الذي يتم عرضه يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع RouteMatrixItemConditionString.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");

الثوابت
ROUTE_EXISTS	تم العثور على مسار، وتم ملء المعلومات المقابلة للعنصر. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.
ROUTE_NOT_FOUND	تعذّر العثور على أي مسار. يُرجى مراجعة مستندات خدمة الويب للحصول على مزيد من المعلومات.

فئة RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

خطأ حدث أثناء RouteMatrix.computeRouteMatrix لزوج محدّد من المصدر والوجهة

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");

الطُرق
مكتسَبة: toJSON

فئة RouteMatrixItemLocalizedValues

class google.maps.routes.RouteMatrixItemLocalizedValues
library "routes"

تمثيلات نصية لـ RouteMatrixItem.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");

الخصائص
distance readonly	النوع: string optional تمثّل هذه السمة مسافة السفر لعنصر مصفوفة المسارات في شكل نصي.
distanceLanguage readonly	النوع: string optional رمز اللغة المستخدَمة في نص المسافة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration readonly	النوع: string optional تمثّل هذه السمة المدة في شكل نصي ومترجَمة إلى لغة منطقة طلب البحث. يأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات عن حركة المرور، ستكون هذه القيمة هي نفسها قيمة RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage readonly	النوع: string optional رمز اللغة المستخدَمة في نص المدة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration readonly	النوع: string optional المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم تمثيلها في شكل نصي
staticDurationLanguage readonly	النوع: string optional رمز اللغة المستخدَمة في نص المدة الثابت وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn".
transitFare readonly	النوع: string optional تمثّل هذه السمة أجرة النقل العام في شكل نص.
transitFareLanguage readonly	النوع: string optional رمز اللغة BCP-47 لنص أجرة النقل العام، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

الطُرق
مكتسَبة: toJSON

واجهة RouteMatrixOrigin

واجهة google.maps.routes.RouteMatrixOrigin

مصدر واحد لـ ComputeRouteMatrixRequest

الخصائص
waypoint	النوع: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint الموقع الجغرافي لنقطة الانطلاق قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code. لا يتم أخذ قيم الارتفاع في الاعتبار.
routeModifiers اختياري	النوع: RouteModifiers optional معدِّلات لكل مسار يتّخذ هذا الموقع الجغرافي كنقطة انطلاق