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

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

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

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

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

ما هي هذه الميزة وسبب استخدامها

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

طلب مسار أقصر

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

  • اضبط travelMode على DRIVE أو BICYCLE أو TWO_WHEELER.
  • اضبط قيمة requestedReferenceRoutes على SHORTER_DISTANCE.
  • اضبط قناع حقل الرد لعرض سمات الرد المرتبطة بمسار أقصر:
    • routes.routeLabels: تحدّد كل مسار على أنّه DEFAULT_ROUTE أو SHORTER_DISTANCE أو DEFAULT_ROUTE_ALTERNATE.
    • routes.routeToken: رمز مميّز للمسار يمكنك تمريره إلى Navigation SDK لاسترداد مسار مخصّص.
  • لا تُدرِج أي نقاط طريق 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