الحصول على رمز مسار

لطلب أن تعرض Routes API علامات مسار للمسارات التي تم إنشاؤها، اتّبِع الخطوات التالية:

1. اضبط المَعلمات التالية المطلوبة لعرض رمز مسار:

   • اضبط travelMode على DRIVE.
   • اضبط routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.

2. تأكَّد من أنّ أيّ من نقاط الطريق ليست من خلال نقاط الطريق.

3. حدِّد قناع الحقل routes.routeToken لعرض رمز مسار:

   X-Goog-FieldMask: routes.routeToken<
   

ملاحظة: بسبب أحوال الطرق الديناميكية، قد تختلف المسارات التي يتم إنشاؤها باستخدام رمز مميّز معيّن عن المسار المخطّط. للحدّ من الاختلافات، استخدِم الرمز المميّز في مهلة تبلغ دقائق من إنشاء الرمز المميّز.

يمكنك استخدام رمز مسار الرحلة المخطَّط في حزمة Navigation SDK. لمزيد من التفاصيل، يُرجى الاطّلاع على:

• تخطيط مسار (أجهزة Android)
• تخطيط مسار (أجهزة iOS)

مثال على رمز مسار

في ما يلي مثال على نموذج محتوى طلب cURL لمسار واحد من نقطة منشأ واحدة إلى وجهة واحدة. ويستخدم قناع الحقول لطلب رمز مسار، بالإضافة إلى مدّة المسار والمسافة وخط المسار المتعدد الأضلاع:

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع Compute Routes API.