نقل البيانات من Directions API (الإصدار القديم) أو Distance Matrix API (الإصدار القديم)

المطوّرون في المنطقة الاقتصادية الأوروبية

إذا كان عنوان إرسال الفواتير الخاص بك يقع في المنطقة الاقتصادية الأوروبية، ستسري بنود خدمة "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية على استخدامك للخدمات اعتبارًا من 8 تموز (يوليو) 2025. تختلف الوظائف حسب المنطقة. مزيد من المعلومات

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

ملاحظة: إذا كنت تستخدم الإصدار التجريبي من Routes API، راجِع مقالة نقل البيانات من الإصدار التجريبي إلى الإصدار المتاح للجميع للحصول على معلومات حول نقل البيانات إلى الإصدار المتاح للجميع.

أفضل ممارسات الفوترة لنقل البيانات

تنطبق هذه الإرشادات إذا كان استخدامك لواجهة برمجة التطبيقات مرتفعًا بما يكفي للانتقال إلى فئة الأسعار الثانية. عند نقل البيانات إلى إصدار أحدث من واجهة برمجة التطبيقات، سيتم أيضًا تحصيل رسوم منك مقابل رمز تخزين تعريفي مختلف. لتجنُّب زيادة التكاليف خلال شهر الانتقال، ننصحك بالتبديل إلى واجهات برمجة التطبيقات الجديدة في مرحلة الإنتاج في أقرب وقت ممكن من بداية الشهر. سيضمن لك ذلك الوصول إلى فئات الأسعار الشهرية الأكثر فعالية من حيث التكلفة خلال شهر نقل البيانات. للحصول على معلومات حول فئات الأسعار، يُرجى الاطّلاع على صفحة الأسعار والأسئلة الشائعة حول الأسعار.

تعديل نقاط نهاية REST API

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

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

يسرد الجدول التالي المَعلمات في Directions API وDistance Matrix API التي تمت إعادة تسميتها أو تعديلها، أو المَعلمات غير المتوافقة مع إصدار GA. عدِّل الرمز إذا كنت تستخدم أيًا من هذه المَعلمات.

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

معلَمة "الاتجاهات" أو "مصفوفة المسافة"	مَعلمة 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"	في 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 Routes فقط. يحتوي على معلومات استجابة الترميز الجغرافي لنقاط الطريق المحدّدة كعناوين فقط.
bounds	viewport
legs.end_address	هذه الميزة غير متوفّرة.	استخدِم معرّفات الأماكن بدلاً من الإحداثيات للحصول على توجيه عالي الدقة. تحتوي معرّفات الأماكن على بيانات تعمل على محاذاة المسار مع نقاط الوصول الصحيحة. إذا بدأت بعنوان: استخدِم الإكمال التلقائي للأماكن أو Geocoding API لتحويله إلى معرّف مكان. إذا بدأت بالإحداثيات: ننصحك باستخدام البحث عن وجهات لتقديم موقع جغرافي أكثر دلالة. يمكن أن يكون الحصول على عنوان من الإحداثيات أمرًا معقّدًا ويؤدي إلى محاذاة غير صحيحة. لا تحوّل واجهة Routes API الإحداثيات إلى عناوين.
legs.start_address	هذه الميزة غير متوفّرة.
overview_polyline	خطوط متعدّدة
summary	description
waypoint_order	optimizedIntermediateWaypointIndex