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

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

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

تعديل الرمز البرمجي لاستخدام نقاط نهاية Routes API الجديدة

من Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

من Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

تحويل مَعلمات عناوين URL لاستخدام نص طلب HTTPS

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

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

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

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

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