نظرة عامة على فئة المسار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مقدمة
توفّر فئة Route الطريقة computeRoutes لعرض المسار المثالي بين موقعَين جغرافيَّين. توفير اتجاهات مع معلومات عن حركة المرور في الوقت الفعلي للنقل العام أو ركوب الدراجات أو القيادة أو المركبات ذات العجلتين أو المشي بين مواقع جغرافية متعددة
هل تحتاج إلى مصفوفات مسارات؟ إذا كنت مهتمًا بمصفوفة المسارات، يمكنك الاطّلاع على نظرة عامة على فئة مصفوفة المسارات.
هل تريد نقل البيانات؟ إذا كنت بصدد نقل البيانات من خدمة "الاتجاهات" (الإصدار القديم)
إلى فئة Route، يُرجى الاطّلاع على
نقل البيانات إلى فئة "المسار".
لماذا يجب استخدام فئة Route؟
باستخدام الفئة Route، يمكنك توجيه مركباتك أو حِزمك وفقًا لتفضيلاتك مع تحسين التكلفة والجودة، وذلك من خلال مجموعة كبيرة من تفاصيل المسار.
ما هي الإجراءات التي يمكن تنفيذها باستخدام فئة Route؟
تعرض الطريقة computeRoutes المسار المثالي بين موقعَين جغرافيَّين. باستخدام مكتبة "الطرق"، يمكنك إجراء ما يلي:
- الحصول على اتجاهات لمختلف وسائل التنقّل:
- وسائل النقل: النقل العام أو القيادة أو المركبات ذات العجلتين أو المشي أو ركوب الدراجات
- سلسلة من نقاط الطريق التي يمكنك تحسينها للحصول على الترتيب الأكثر فعالية للانتقال إليها.
- استخدام طرق متعددة لتحديد نقاط البداية والوجهات ونقاط المرور:
- سلاسل نصية على سبيل المثال: "شيكاغو، إلينوي" أو "داروين، الإقليم الشمالي، أستراليا" أو "1800
Amphitheatre Parkway, Mountain View, CA 94043" أو "CWF6+FWX Mountain
View, California"
- مثيلات الأماكن
- إحداثيات خط العرض وخط الطول، مع اتجاه المركبة اختياريًا
- اضبط خيارات المسار بما يتناسب مع احتياجاتك وأهدافك:
- اختَر مسارات أقل استهلاكًا للوقود أو الطاقة حسب نوع محرّك مركبتك:
ديزل أو كهرباء أو محرّك هجين أو غاز.
- يمكنك ضبط خيارات دقيقة لاحتساب عدد الزيارات، ما يتيح لك اتّخاذ قرارات بشأن المفاضلة بين الجودة والوقت المستغرَق.
- اضبط اتجاه المركبة (اتجاه التنقّل) ومعلومات جانب الطريق لنقاط الطريق لزيادة دقة الوقت المقدَّر للوصول.
- تحديد المواقع الجغرافية التي يمكن فيها التوقف مؤقتًا أو المواقع الجغرافية التي يمكن فيها التوقف بشكل آمن
- طلب معلومات عن رسوم المرور، بالإضافة إلى مسافة المسار والوقت المقدّر للوصول
- التحكّم في وقت الاستجابة والجودة من خلال طلب البيانات التي تحتاج إليها فقط
باستخدام قناع الحقل، ما يساعدك في تجنُّب وقت المعالجة غير الضروري
وارتفاع معدّلات فوترة الطلبات
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n[](/maps/documentation/javascript/routes/demo)\n\nIntroduction\n\nThe Route class provides the `computeRoutes` method for returning the ideal\nroute between two locations. Provide directions with real-time traffic for transit,\nbiking, driving, 2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Route Matrix class overview](/maps/documentation/javascript/routes/route-matrix-class-overview).\n\n**Migrating?** If you are migrating from the Directions Service (Legacy)\nto the `Route` class, see\n[Migrate to the Route class](/maps/documentation/javascript/routes/routes-js-migration).\n\nWhy use the Route class?\n\nWith the `Route` class, with a wide range of route details you can\nroute your vehicles or packages according to your preferences while optimizing for cost and\nquality.\n\nWhat can you do with the Route class?\n\nThe `computeRoutes` method returns the ideal route between two\nlocations. With the Routes library, you can do the following things:\n\n- **Get directions for different ways to travel** :\n - Modes of transportation: transit, driving, two-wheel vehicles, walking, or bicycling.\n - A series of waypoints that you can optimize for the most efficient order in which to travel to them.\n- **Use multiple ways to specify origins, destinations, and waypoints** :\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800 Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain View, California\"\n - Place instances\n - Latitude and longitude coordinates, optionally with vehicle heading\n- **Fine-tune your route options** based on your needs and goals:\n - Select fuel or energy-efficient routes for your vehicle's engine type: Diesel, Electric, Hybrid, Gas.\n - Set fine-grained options for traffic calculation, letting you make quality versus latency trade off decisions.\n - Set vehicle heading (direction of travel) and side-of-road information for waypoints to increase ETA accuracy.\n - Specify pass-through versus terminal locations and safe stopover locations.\n - Request toll information, along with route distance and ETA.\n- **Control your latency and quality** by requesting only the data you need using a field mask, which helps you avoid unnecessary processing time and higher request billing rates.\n\nNext steps\n\n- [Try the demo](/maps/documentation/javascript/routes/demo)\n- [Get started](/maps/documentation/javascript/routes/start)\n- [Get a route](/maps/documentation/routes/get-a-route)\n- [Reference documentation](/maps/documentation/javascript/reference/route)"]]
