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

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

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

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

شرح الميزة وسبب استخدامها

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

طلب مسار يقطع مسافة أقصر

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

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