يشرح هذا الدليل كيفية نقل التطبيقات التي تستخدم Directions API أو Space Matrix API إلى واجهة Routes API. للاطّلاع على تفاصيل حول Routes API، يُرجى مراجعة نظرة عامة على المنتج.
تعديل نقاط نهاية واجهة برمجة التطبيقات REST API
تعديل الرمز لاستخدام نقاط النهاية الجديدة في Routes API
من واجهة برمجة التطبيقات للاتجاهات
Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
من واجهة برمجة التطبيقات لمصفوفة المسافات
واجهة برمجة التطبيقات لمصفوفة المسافات | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
تحويل مَعلمات عناوين URL لاستخدام نص طلب HTTPS
باستخدام واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافة، يمكنك
تمرير خصائص الإعدادات كمَعلمات عناوين URL إلى طلب HTTP GET
. على سبيل المثال، بالنسبة إلى Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
باستخدام Routes API، يمكنك تمرير المعلَمات في نص الطلب أو في العناوين
كجزء من طلب HTTP POST
. للحصول على أمثلة، راجع:
تحويل نقاط الطرق ذات الخطوط المتعددة المشفرة إلى نقاط مسار خاصة بالموقع الجغرافي
تتوفّر إمكانية تحديد نقاط الطريق كخطوط متعدّدة مشفّرة في Directions API لاستيعاب عدد كبير من نقاط الطريق في عدد الأحرف المسموح به في عنوان URL، وهو 16384 حرفًا. وهذه الميزة غير ضرورية في Routes API لأنه يمكن نقل نقاط الطرق في نص طلب RST أو gRPC كإحداثيات خطوط الطول/العرض. على سبيل المثال، راجع مثال HTTP في مستند حساب مصفوفة مسار أو تحديد نقطة وسيطة في مستند تحديد نقاط الطرق الوسيطة.
تحويل المَعلمات
تسرد الجداول التالية المعلمات في واجهة برمجة التطبيقات للاتجاهات وواجهة برمجة التطبيقات لمصفوفة المسافات التي تمت إعادة تسميتها أو تعديلها، أو المَعلمات غير المتوافقة مع إصدار GA. عدِّل الرمز إذا كنت تستخدم أيًا من هذه المعلمات.
طلب الإحالات الناجحة للمعلَمات
مَعلمة مصفوفة الاتجاهات أو المسافة | مَعلمة Routes API | Notes |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
لا تتوفّر إلا في وضع TRANSIT ، وليس في نفس
وضع departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
لا يمكن استخدام arrivalTime في الوقت نفسه. |
language |
languageCode |
يتوفّر هذا الخيار لـ Compute Routes فقط. |
mode |
travelMode |
تمت إضافة الدعم إلى |
region |
regionCode |
|
traffic_model |
trafficModel |
مزيد من المعلومات |
transit_mode |
"travelMode": "TRANSIT" |
في واجهة برمجة التطبيقات Directions API، وفي مسار النقل العام، يتم اعتبار كل قطاع من الرحلة له وضع السفر نفسه (على سبيل المثال، مشي أو نقل عام) بخطوة واحدة، وتكون الاتجاهات الفردية لوضع السفر هذا ضمن الخطوات الفرعية. وفي المقابل، في Routes API، تمثّل الخطوات دائمًا تعليمات تنقّل واحدة لجميع أنواع التنقّل. لذا فإن كل تعليمة تنقل عبارة عن خطوة. بالنسبة إلى الخطوات المتعددة في وضع سفر واحد، توفّر Routes API بيانات وصفية تتضمّن ملخّصًا للخطوات الخاصة بوضع السفر هذا في "stepsOverview". ولطلب هذه البيانات الوصفية، استخدِم قناع الحقل "routes.legs.stepsOverview". مزيد من المعلومات |
transit_routing_preference |
transitRoutingPreference |
مزيد من المعلومات |
units |
غير متاح لمصفوفة المسارات. | |
waypoints |
intermediates |
تمت إزالة دعم الخطوط المتعددة المشفرة. |
optimize=true لنقاط الطريق |
"optimizeWaypointOrder": "true" |
مزيد من المعلومات |
الإحالات الناجحة لمَعلمات الاستجابة
مَعلمة مصفوفة الاتجاهات أو المسافة | مَعلمة Routes API | Notes |
---|---|---|
copyrights |
غير مضمّنة في الرد. وعليك تضمين العبارة التالية عند عرض النتائج للمستخدمين:
مثال:
|
|
distance |
distanceMeters |
لا تتوفر المسافة إلا بالأمتار. |
duration_in_traffic |
duration |
تمت الإزالة في Routes API، يُرجى استخدام duration . |
status |
هذه الميزة غير متوفّرة. استخدِم رموز استجابة HTTP لرصد الأخطاء التي تم الإبلاغ عنها من خلال واجهة برمجة التطبيقات. يمكنك الاطّلاع على مقالة معالجة أخطاء الطلبات للحصول على مزيد من المعلومات. | |
geocoded_waypoints |
geocoding_results |
يتوفّر هذا الخيار لـ Compute Routes فقط. يحتوي على معلومات استجابة الترميز الجغرافي فقط لنقاط الطرق المحدَّدة كعناوين. |
bounds |
viewport |
|
legs.end_address |
هذه الميزة غير متوفّرة. | |
legs.start_address |
هذه الميزة غير متوفّرة. | |
overview_polyline |
خطوط متعدّدة | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |