نظرة عامة على مسارات الحساب
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
مقدمة
Compute Routes هي طريقة في خدمة Routes API تقبل
طلب HTTPS وتُرجع المسار المثالي بين موقعَين جغرافيَّين.
يجب تقديم اتجاهات مع كثافة حركة المرور في الوقت الفعلي للنقل العام أو ركوب الدراجات أو القيادة أو المركبات ذات العجلتين أو المشي بين مواقع جغرافية متعددة.
هل تحتاج إلى مصفوفات مسارات؟ إذا كنت مهتمًا بجدول مسار، اطّلِع على
نظرة عامة على جدول المسارات الحسابية.
هل يتم نقل البيانات؟ إذا كنت بصدد نقل البيانات من Distance Matrix API (الإصدار القديم)،
اطّلِع على تعليمات نقل البيانات بدءًا من
أسباب نقل البيانات إلى Routes API.
أسباب استخدام Compute Routes
باستخدام ميزة "حساب المسارات"، يمكنك توجيه المركبات أو الطرود وفقًا لإعداداتك المفضّلة مع تحسين التكلفة والجودة من خلال استخدام مجموعة كبيرة من تفاصيل المسارات.
ما هي الإجراءات التي يمكنك اتّخاذها باستخدام Compute Routes؟
باستخدام طريقة Compute Routes في Routes API، يمكنك
تنفيذ الإجراءات التالية:
الحصول على الاتجاهات لطرق سفر مختلفة ولوجهة واحدة أو
عدة وجهات:
استخدام طرق متعدّدة لتحديد نقاط البداية والوجهة والنقاط المحورية:
سلاسل نصية على سبيل المثال: "القاهرة، مصر" أو "الإسكندرية، مصر" أو "1800
Amphitheatre Parkway, Mountain View, CA 94043" أو "CWF6+FWX Mountain
View, California"
أرقام تعريف الأماكن
إحداثيات خط العرض وخط الطول، مع الاتجاه المقصود للمركبة اختياريًا
تحسين خيارات المسار استنادًا إلى احتياجاتك وأهدافك:
تحكّم في وقت الاستجابة والجودة من خلال طلب البيانات التي تحتاج إليها فقط
باستخدام قناع حقل، ما يساعدك في تجنُّب وقت المعالجة غير الضروري و
معدّلات الفوترة الأعلى للطلبات. للتعرّف على التفاصيل، يُرجى الاطّلاع على مقالة اختيار المعلومات التي سيتم عرضها.
آلية عمل Compute Routes
تقبل طريقة ComputeRoutes في Routes API طلب HTTP POST مع
نص طلب JSON يحتوي على تفاصيل الطلب. يجب إدخال نقطة الانطلاق،
وجهة، travelMode، وقناع حقل لتحديد الحقول التي سيتم عرضها.
مثال
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
بعد ذلك، تحتسب الخدمة المسار المطلوب، وتُرجع الحقول التي طلبتها.
الموارد
يلخِّص الجدول التالي الموارد المتاحة من خلال أسلوب
Routes API Compute Routes،
بالإضافة إلى البيانات التي يعرضها.
| موارد البيانات |
البيانات التي تم عرضها |
تنسيق الإرجاع |
| ComputeRoutes |
عرض المسارات والمراحل والخطوات الخاصة بمسار معيّن، مع مسارات بديلة،
إذا طُلب ذلك |
JSON |
كيفية استخدام Compute Routes
مكتبات العملاء المتاحة
للحصول على قائمة بمكتبات البرامج المتاحة لمسارَي المعالجة، يُرجى الاطّلاع على مكتبات البرامج.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-20 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Compute Routes Overview\n\n**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\n[](/maps/documentation/routes/demo)\n\nIntroduction\n------------\n\nCompute Routes is a method in the Routes API service that accepts\nan HTTPS request and returns the ideal route between two locations.\nProvide directions with real-time traffic for transit, biking, driving,\n2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Compute Route Matrix Overview](/maps/documentation/routes/compute-route-matrix-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Routes\n----------------------\n\nWith Compute Routes, with a wide\nrange of route details you can route your vehicles or packages according to\nyour preferences while optimizing for cost and quality.\n\nWhat you can do with Compute Routes?\n------------------------------------\n\nWith the Routes API `Compute Routes` method, you can\ndo the following things:\n\n- **Get directions for different ways to travel**, and for a single or\n multiple destinations:\n\n - Modes of transportation: transit, driving, two-wheel vehicles,\n walking, or bicycling.\n\n - A series of waypoints that you can optimize for the most efficient\n order in which to travel to them.\n\n- **Use multiple ways to specify origins, destinations, and waypoints**:\n\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800\n Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain\n View, California\"\n\n - Place IDs\n\n - Latitude and longitude coordinates, optionally with vehicle heading\n\n- **Fine-tune your route options** based on your needs and goals:\n\n - Select fuel or energy-efficient routes for your vehicle's engine type:\n Diesel, Electric, Hybrid, Gas. For more information, see\n [Get an eco-friendly route](/maps/documentation/routes/eco-routes#request_an_eco-friendly_route).\n\n - Set fine-grained options for traffic calculation, letting you make\n quality versus latency trade off decisions. For details, see\n [Specify how and if to include traffic data](/maps/documentation/routes/config_trade_offs).\n\n - Set vehicle heading (direction of travel) and side-of-road information\n for waypoints to increase ETA accuracy. For details, see\n [Specify vehicle heading and side of road](/maps/documentation/routes/location_modifiers).\n\n - Specify pass-through versus terminal locations and safe stopover\n locations. For details, see [Set a stop along a route](/maps/documentation/routes/stop_over) and\n [Set a point for a route to pass through](/maps/documentation/routes/pass-through).\n\n - Request toll information, along with route distance and ETA. For\n details, see\n [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\n- **Control your latency and quality** by requesting only the data you need\n using a field mask, which helps you avoid unnecessary processing time and\n higher request billing rates. For details, see\n [Choose what information to return](/maps/documentation/routes/choose_fields).\n\nHow Compute Routes works\n------------------------\n\nThe Routes API `ComputeRoutes` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are an origin,\ndestination, `travelMode`, and a field mask to specify which fields to return. \n\n#### Example\n\n```json\ncurl -X POST -d '{\n \"origin\": {\n \"address\": \"1800 Amphitheatre Parkway, Mountain View, CA 94043\"\n },\n \"destination\": {\n \"address\": \"Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132\"\n },\n \"travelMode\": \"DRIVE\"\n }' \\\n -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \\\n 'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nThe service then calculates the requested route, and returns the fields you've\nrequested.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Routes method,\nalong with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------|\n| [ComputeRoutes](/maps/documentation/routes/compute_route_directions) | Returns routes, legs, and steps for a route, with alternate routes, if requested. | JSON |\n\n\u003cbr /\u003e\n\n### How to use Compute Routes\n\n|---|---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute a route and review the response** | For more information, see [Get a route](/maps/documentation/routes/compute_route_directions) and [Review the route responses](/maps/documentation/routes/understand-route-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Routes, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route](/maps/documentation/routes/compute_route_directions)\n- [Available route options](/maps/documentation/routes/route-opt)\n- [Choose what information to return](/maps/documentation/routes/choose_fields)\n- [Migrate from Directions API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]
