تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

الحصول على مسار أقصر

المطوّرون في المنطقة الاقتصادية الأوروبية

يمكن أن تعرض خدمة Compute Routes مسارات قيادة محسّنة لتقليل مسافة الرحلة عند تفعيل خيار "المسارات الأقصر مسافة".

عند طلب مسار بمسافة أقصر، تعرض الخدمة ما يلي:

المسار التلقائي، وهو مسار تم تحسينه بشكل أساسي للوصول إلى الوقت المقدَّر للوصول
مسار أقصر محسَّن لتقليل مسافة السفر في الرحلة بأكملها

ما هي هذه الميزة وما فائدتها؟

يعطي المسار الأقصر مسافة الأولوية على راحة القيادة أو السرعة. على سبيل المثال، قد يفضّل الطرق المحلية بدلاً من الطرق السريعة، أو يسلك طرقًا ترابية، أو يمر عبر مواقف السيارات. ولا تعرض أي مناورات تعرف "خرائط Google" أنّها غير قانونية.

طلب مسار أقصر

يجب أن يستوفي طلبك المعايير التالية:

اضبط travelMode على DRIVE أو BICYCLE أو TWO_WHEELER.
اضبط النوع requestedReferenceRoutes على SHORTER_DISTANCE.
اضبط قناع حقل الاستجابة لعرض سمات الاستجابة المرتبطة بمسار أقصر مسافة:
- routes.routeLabels: تحدّد كل مسار على أنّه DEFAULT_ROUTE أو SHORTER_DISTANCE أو DEFAULT_ROUTE_ALTERNATE.
- ‫routes.routeToken: رمز مميّز للمسار يمكنك تمريره إلى حزمة تطوير البرامج للتنقّل من أجل استرداد مسار مخصّص.
لا تُدرِج أي Via نقاط طريق وسيطة.
لا تُدرِج المَعلمة optimizeWaypointOrder.
اختياري: اضبط قناع حقل الرد لعرض الخصائص التالية المرتبطة بكل من المسار التلقائي والمسار الأقصر:
- ‫routes.distanceMeters: تعرض هذه السمة مسافة المسار.
- ‫routes.duration: تعرض مدة المسار.

للحصول على معلومات مرجعية، اطّلِع على ReferenceRoute وRouteLabel.

مثال على الطلب: مسار أقصر

يوضّح الرمز التالي طلبًا لمسار أقصر. في هذا المثال، يمكنك استخدام قناع حقل الاستجابة لعرض الحقول المرتبطة بكل من المسار التلقائي والمسار الأقصر باستخدام أقنعة الحقول التالية:

routes.distanceMeters
routes.duration

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

مثال على الردّ بمسار أقصر

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

مثال على الطلب: مسافة أقصر ومسار أقل استهلاكًا للوقود

تعرض التعليمات البرمجية التالية طلبًا للحصول على مسار أقصر ومسار أقل استهلاكًا للوقود.

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

'https://routes.googleapis.com/directions/v2:computeRoutes'

مثال على الرد: مسافة أقصر ومسار أقل استهلاكًا للوقود

في هذه الحالة، تكون المسافة الأقصر والمسار الأقل استهلاكًا للوقود هما نفسهما، لذا يتم عرض هذا المسار ويتم تضمين routeLabel لكلا النوعَين من المسارات.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

المناطق التي يتوفّر فيها الترخيص

تتوفّر المسارات الأقصر مسافة في جميع المناطق.

الفوترة

لا تفرض "منصة خرائط Google" رسومًا إضافية مقابل استخدام ميزة تجريبية. سيتم تحصيل الرسوم منك استنادًا إلى استخدامك لواجهة برمجة التطبيقات استنادًا إلى معلَمات أخرى تحدّدها.

مزيد من المعلومات عن الفوترة في Routes API