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

يوضّح هذا الدليل كيفية نقل التطبيقات التي تستخدم إما Directions API أو Distance Matrix API لاستخدام Routes 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