فئة RouteMatrix
google.maps.routes.RouteMatrix
صف
مصفوفة من المسارات التي تم احتسابها لمجموعة من أزواج نقاط الانطلاق والوجهات من خلال RouteMatrix.computeRouteMatrix
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrix} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الطُرق الثابتة | |
|---|---|
computeRouteMatrix |
computeRouteMatrix(request)المَعلمات:
قيمة العائد:
Promise<{matrix:RouteMatrix}>تتلقّى هذه الطريقة قائمة بالمواقع الجغرافية للانطلاق والوجهات وتعرض مصفوفة تحتوي على معلومات المسار لكل مجموعة من مواقع الانطلاق والوجهات. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الطلب من خلال ضبط السمة ComputeRouteMatrixRequest.fields. القيمة هي قائمة بمسارات الحقول. على سبيل المثال:
قناع حقل الردّ الذي يتضمّن أحرف بدل fields: ['*'] للأسباب التالية:
|
الخصائص | |
|---|---|
rows |
النوع:
Array<RouteMatrixRow>صفوف المصفوفة يتوافق كل صف مع نقطة بداية ويحتوي على مصفوفة من RouteMatrixItem، يمثّل كل منها مسارًا إلى وجهة. |
الطُرق | |
|---|---|
toJSON |
toJSON()المَعلمات: بدون
قيمة العائد:
Objectيتم تحويلها إلى عنصر. |
فئة RouteMatrixRow
google.maps.routes.RouteMatrixRow
صف
تمثّل مصدرًا تم تمريره إلى RouteMatrix.computeRouteMatrix. تحتوي على قائمة RouteMatrixItem، ويمثّل كل عنصر مسارًا إلى وجهة.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrixRow} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
items |
النوع:
Array<RouteMatrixItem>معلومات المسار لكل وجهة |
الطُرق | |
|---|---|
toJSON |
toJSON()المَعلمات: بدون
قيمة العائد:
Objectيتم تحويلها إلى عنصر. |
فئة RouteMatrixItem
google.maps.routes.RouteMatrixItem
صف
يحتوي على معلومات المسار التي تم احتسابها لزوج من نقطة الانطلاق/الوجهة تم تمريره إلى RouteMatrix.computeRouteMatrix.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrixItem} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
condition |
النوع:
RouteMatrixItemCondition optionalتشير إلى ما إذا تم العثور على المسار أم لا. |
distanceMeters |
النوع:
number optionalتمثّل هذه السمة مسافة السفر للمسار بالمتر. |
durationMillis |
النوع:
number optionalطول المدة الزمنية اللازمة للتنقّل في المسار بالمللي ثانية. إذا ضبطت ComputeRouteMatrixRequest.routingPreference على TRAFFIC_UNAWARE، ستكون هذه القيمة هي نفسها قيمة RouteMatrixItem.staticDurationMillis. إذا ضبطت ComputeRouteMatrixRequest.routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار. ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، ستكون هذه القيمة Number.POSITIVE_INFINITY. |
error |
النوع:
RouteMatrixItemError optionalخطأ حدث أثناء احتساب المسار. |
fallbackInfo |
النوع:
FallbackInfo optionalفي بعض الحالات التي لا يتمكّن فيها الخادم من احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الأصل/نقطة الوجهة هذا، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام ردّ احتياطي، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يتم إلغاء ضبط هذا الحقل. |
localizedValues |
النوع:
RouteMatrixItemLocalizedValues optionalتمثيلات نصية لسمات RouteMatrixItem |
staticDurationMillis |
النوع:
number optionalمدة السفر على طول المسار بدون أخذ أحوال حركة المرور في الاعتبار ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، ستكون هذه القيمة Number.POSITIVE_INFINITY. |
travelAdvisory |
النوع:
RouteTravelAdvisory optionalمعلومات إضافية حول المسار |
واجهة ComputeRouteMatrixRequest
google.maps.routes.ComputeRouteMatrixRequest
interface
طلب مصفوفة طرق
الخصائص | |
|---|---|
destinations |
النوع:
Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint>مصفوفة الوجهات التي تحدّد أعمدة مصفوفة الردّ. قد تكون القيمة التي يتم تمريرها كسلسلة عنوانًا أو رمز موقع مفتوح أو اسم مورد "مكان". لا يتم أخذ قيم الارتفاع في الاعتبار. |
fields |
النوع:
Iterable<string>مجموعة الحقول المطلوب استرجاعها. حدِّد ["*"] لجميع الحقول. |
origins |
النوع:
Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint>مصفوفة المصادر التي تحدّد صفوف مصفوفة الاستجابة. قد تكون القيمة التي يتم تمريرها كسلسلة عنوانًا أو رمز موقع مفتوح أو اسم مورد "مكان". لا يتم أخذ قيم الارتفاع في الاعتبار. تسري عدّة قيود على حجم عدد القيم الفريدة للمصادر والوجهات:
|
arrivalTime optional |
النوع:
Date optionalوقت الوصول ملاحظة: لا يمكن ضبط هذا الخيار إلا عندما يكون ComputeRouteMatrixRequest.travelMode مضبوطًا على TRANSIT. يمكنك تحديد ComputeRouteMatrixRequest.departureTime أو ComputeRouteMatrixRequest.arrivalTime، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل. |
departureTime optional |
النوع:
Date optionalوقت المغادرة في حال عدم ضبط هذه القيمة، سيتم تلقائيًا ضبطها على الوقت الذي أرسلت فيه الطلب. ملاحظة: يمكنك تحديد وقت في الماضي فقط عندما يكون ComputeRouteMatrixRequest.travelMode مضبوطًا على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل. |
extraComputations optional |
النوع:
Iterable<ComputeRouteMatrixExtraComputation> optionalقائمة بالحسابات الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تعرض هذه العمليات الحسابية الإضافية حقولاً إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في ComputeRouteMatrixRequest.fields ليتم عرضها في الردّ. |
language optional |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في وصف المراجعة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة في Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج اللغة من إعدادات الترجمة في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". وفي الحالات الأخرى، يتم استنتاج اللغة من الموقع الجغرافي للمصدر الأول. |
region optional |
النوع:
string optionalرمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. عند عدم تقديم هذه القيمة، يتم استنتاج المنطقة من إعدادات اللغة في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". في الحالات الأخرى، يتم استنتاج المنطقة من الموقع الجغرافي للمصدر الأول. |
routingPreference optional |
النوع:
RoutingPreference optionalتحدّد هذه السمة كيفية احتساب مصفوفة المسارات. يحاول الخادم استخدام خيار التوجيه المحدّد لحساب مصفوفة المسارات. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة ComputeRouteMatrixRequest.travelMode هي DRIVING أو TWO_WHEELER، وإلا سيفشل الطلب. |
trafficModel optional |
النوع:
TrafficModel optionalتحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في حركة المرور. يؤثّر هذا الإعداد في القيمة المعروضة في RouteMatrixItem.durationMillis التي تحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر ComputeRouteMatrixRequest.trafficModel إلا للطلبات التي تم ضبط ComputeRouteMatrixRequest.routingPreference فيها على TRAFFIC_AWARE_OPTIMAL وComputeRouteMatrixRequest.travelMode على DRIVING. القيمة التلقائية هي BEST_GUESS. |
transitPreference optional |
النوع:
TransitPreference optionalتحدّد هذه السمة الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكن تحديد هذا الخيار إلا عندما يكون ComputeRouteMatrixRequest.travelMode مضبوطًا على TRANSIT. |
travelMode optional |
النوع:
TravelMode optionalتحدّد هذه السمة وسيلة النقل. |
units optional |
النوع:
UnitSystem optionalتحدّد هذه السمة وحدات القياس لحقول العرض. في حال عدم تقديم هذه القيمة، يتم استنتاج وحدات العرض من موقع المصدر الأول. |
ثوابت ComputeRouteMatrixExtraComputation
google.maps.routes.ComputeRouteMatrixExtraComputation
الثوابت
عمليات حسابية إضافية يجب إجراؤها لطلب RouteMatrix.computeRouteMatrix
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
TOLLS |
معلومات الرسوم الخاصة بعناصر المصفوفة |
ثوابت RouteMatrixItemCondition
google.maps.routes.RouteMatrixItemCondition
الثوابت
تمثّل هذه السمة حالة مسار لزوج معيّن من نقطة الانطلاق والوجهة.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
ROUTE_EXISTS |
تم العثور على مسار. |
ROUTE_NOT_FOUND |
لم يتم العثور على أي مسار. |
RouteMatrixItemError class
google.maps.routes.RouteMatrixItemError
صف
خطأ حدث أثناء RouteMatrix.computeRouteMatrix لزوج محدّد من المصدر/الوجهة
يمتد هذا الصف إلى Error.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الطُرق | |
|---|---|
toJSON |
toJSON()المَعلمات: بدون
قيمة العائد:
Objectيتم تحويلها إلى عنصر. |
فئة RouteMatrixItemLocalizedValues
google.maps.routes.RouteMatrixItemLocalizedValues
صف
تمثيلات نصية لـ RouteMatrixItem
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
distance |
النوع:
string optionalتمثّل هذه السمة مسافة السفر لعنصر مصفوفة المسارات في شكل نصي. |
distanceLanguage |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في نص المسافة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
duration |
النوع:
string optionalالمدة، ويتم تمثيلها في شكل نصي وتتم ترجمتها بما يتناسب مع المنطقة التي تم فيها البحث. تأخذ في الاعتبار أحوال حركة المرور ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي نفسها قيمة RouteMatrixItemLocalizedValues.staticDuration. |
durationLanguage |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في نص المدة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
staticDuration |
النوع:
string optionalالمدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص. |
staticDurationLanguage |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في نص المدة الثابت وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". |
transitFare |
النوع:
string optionalتعرض هذه السمة أجرة النقل العام بتنسيق نصي. |
transitFareLanguage |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة في نص أجرة النقل وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
الطُرق | |
|---|---|
toJSON |
toJSON()المَعلمات: بدون
قيمة العائد:
Objectيتم تحويلها إلى عنصر. |
واجهة RouteMatrixOrigin
google.maps.routes.RouteMatrixOrigin
interface
تمثّل هذه السمة مصدرًا واحدًا لـ ComputeRouteMatrixRequest.
الخصائص | |
|---|---|
waypoint |
تمثّل هذه السمة الموقع الجغرافي لنقطة الانطلاق. قد تكون القيمة التي يتم تمريرها كسلسلة عنوانًا أو رمز Plus Code. لا يتم أخذ قيم الارتفاع في الاعتبار. |
routeModifiers optional |
النوع:
RouteModifiers optionalمعدِّلات لكل مسار يستخدِم هذا الموقع الجغرافي كأصل. |