نقل البيانات من Directions API أو DISTANCE Matrix API

يشرح هذا الدليل كيفية نقل التطبيقات التي تستخدم Routes API أو ستحصل على واجهة برمجة التطبيقات لمصفوفة المسافات إلى استخدام Routes API. للحصول على تفاصيل حول Routes API، يُرجى الاطّلاع على نظرة عامة على المنتج.

تعديل نقاط نهاية واجهة برمجة تطبيقات REST

تعديل رمزك لاستخدام نقاط النهاية الجديدة في Routes 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 وهو 8192 حرفًا. وهذه الميزة ليست ضرورية في Routes API لأنه يمكن نقل نقاط الطريق في نص طلب REST أو gRPC كإحداثيات خطوط الطول والعرض. للحصول على أمثلة، يمكنك الاطّلاع على مثال HTTP في مستند احتساب مصفوفة مسار أو تحديد نقطة طريق وسيطة في مستند تحديد نقاط الطرق المتوسطة.

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

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

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

مَعلمة مصفوفة الاتجاهات أو المسافة مَعلمة Routes API ملاحظات
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" في واجهة برمجة تطبيقات الاتجاهات، في مسار النقل العام، يتم اعتبار كل جزء من الرحلة له وضع السفر نفسه (على سبيل المثال، المشي أو النقل العام) خطوة واحدة، ويتم تضمين الاتجاهات الفردية لوضع السفر هذا في خطوات فرعية. وفي المقابل، في Routes API، تمثّل الخطوات بشكل متّسق تعليمات تنقّل واحدة في جميع أنواع التنقّل. لذا فإن كل تعليمة تنقل عبارة عن خطوة. للحصول على خطوات متعددة في وضع سفر واحد، توفّر Routes API بيانات وصفية تحتوي على ملخّص لخطوات وضع السفر ذلك في `stepsOverview`. ولطلب هذه البيانات الوصفية، استخدِم قناع الحقل "routes.legs.stepsOverview". مزيد من المعلومات
transit_routing_preference transitRoutingPreference مزيد من المعلومات
units غير متاحة لمصفوفة المسارات.
waypoints intermediates تمت إزالة دعم الخطوط المتعددة المشفرة.
optimize=true لنقاط الطريق "optimizeWaypointOrder": "true" مزيد من المعلومات

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

مَعلمة مصفوفة الاتجاهات أو المسافة مَعلمة Routes API ملاحظات
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