نقل البيانات من واجهة برمجة التطبيقات Directions API أو واجهة برمجة التطبيقات لمصفوفة المسافة

يشرح هذا الدليل كيفية نقل التطبيقات التي تستخدم 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

تمت إضافة الدعم إلى TWO_WHEELER وTRANSIT.

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

غير مضمّنة في الرد. وعليك تضمين العبارة التالية عند عرض النتائج للمستخدمين:

Powered by Google, ©YEAR Google

مثال:

Powered by Google, ©2022 Google

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