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

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

يمكن أن تعرض خدمة 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