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

لطلب أن تعرض خدمة Compute Routes رموزًا مميّزة للطرق التي تم إنشاؤها، اتّبِع الخطوات التالية:

1. اضبط المَعلمات التالية المطلوبة لعرض رمز مميّز للمسار:
   • اضبط السمة travelMode على DRIVE أو TWO_WHEELER.
   • اضبط قيمة routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.
2. حدِّد الموقع الجغرافي لنقطة الانطلاق والوجهة. يمكنك تحديد المواقع الجغرافية التي تناسب حالة الاستخدام من خلال ما يلي: إحداثيات خطوط الطول والعرض أو سلاسل العناوين أو رموز نقاط التنقّل أو معرّفات الأماكن. اطّلِع على خيارات تحديد الموقع الجغرافي.
3. يُرجى التأكّد من أنّ أيًا من النقاط على المسار ليست نقاطًا على المسار من النوع Via.

4. حدِّد قناع الحقل 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.