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

يصف هذا الدليل طريقة نقل التطبيقات التي تستخدم واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة تطبيقات مصفوفة المسافة إلى استخدام واجهة برمجة تطبيقات Routes. لمعرفة تفاصيل حول 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. على سبيل المثال، بالنسبة إلى واجهة برمجة تطبيقات الاتجاهات:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

باستخدام Routes API، يمكنك تمرير المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST. للاطّلاع على أمثلة، يُرجى مراجعة ما يلي:

تحويل نقاط الطرق ذات الخطوط المتعددة إلى نقاط مسار للمواقع

تتوفّر ميزة تحديد نقاط الطريق كخطوط متعددة مشفّرة في واجهة برمجة التطبيقات للاتجاهات لتتوافق مع عدد كبير من نقاط الطريق في حد عنوان URL البالغ 16384 حرفًا. هذه الميزة ليست ضرورية في Routes API لأنه يمكن إرسال نقاط الطريق في نص طلب RST أو gRPC كإحداثيات لخطوط الطول/العرض. للحصول على أمثلة، راجِع مثال HTTP في مستند حساب مصفوفة مسار أو تحديد نقطة طريق وسيطة في مستند تحديد نقاط الطريق الوسيطة.

تحويل المعلمات

تسرد الجداول التالية المعلمات في واجهة برمجة التطبيقات للاتجاهات وواجهة برمجة التطبيقات لمصفوفة المسافة التي تمت إعادة تسميتها أو تعديلها، أو المعلمات غير المتوافقة في إصدار "إحصاءات Google". عدِّل رمزك إذا كنت تستخدم أيًا من هذه المَعلمات.

طلب الإحالات الناجحة للمَعلمات

مَعلمة مصفوفة الاتجاهات أو الاتجاهات معلمة Routes API Notes
alternatives computeAlternativeRoutes
arrival_time arrivalTime تتوفّر هذه الميزة في وضع TRANSIT فقط، وليس في وقت departureTime نفسه.
avoid routeModifiers
departure_time departureTime لا يمكن استخدامهما في الوقت نفسه مع arrivalTime.
language languageCode يتوفّر هذا الخيار لمسارات الحوسبة فقط.
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 يتوفّر هذا الخيار لمسارات الحوسبة فقط. يحتوي على معلومات استجابة الترميز الجغرافي فقط لنقاط الطرق المحددة كعناوين.
bounds viewport
legs.end_address هذه الميزة غير متوفّرة.
legs.start_address هذه الميزة غير متوفّرة.
overview_polyline خطوط متعدّدة
summary description
waypoint_order optimizedIntermediateWaypointIndex